Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
lpc(1B)		   SunOS/BSD Compatibility Package Commands	       lpc(1B)

NAME
       lpc - line printer control program

SYNOPSIS
       /usr/ucb/lpc [ command [	parameter...]]

DESCRIPTION
       The lpc utility controls	the operation of local printers.

       Use  lpc	to perform the following functions:

	  o  start or stop a printer,

	  o  disable or	enable a printer's spooling queue,

	  o  rearrange the order of jobs in a print queue, or

	  o  display the status	of a printer print queue and printer daemon.

       lpc  can	be run from the	command	line or	interactively. Specifying  lpc
       with the	optional  command and parameter	arguments causes lpc to	inter-
       pret  the first argument	as an  lpc command, and	all other arguments as
       parameters to that command. Specifying  lpc without arguments causes it
       to  run interactively, prompting	the user for  lpc commands with	 lpc>.
       By redirecting the  standard input,  lpc	can read commands from a file.

USAGE
       lpc commands may	be typed in their entirety or abbreviated to an	 unam-
       biguous	substring. Some	 lpc commands are available to all users; oth-
       ers are available only to super-users.

       All users may execute the following  lpc	commands:

	? [command ...]	| help [command	 ...]
	     Displays a	short description of  command. command is an  lpc com-
	     mand.   If	 command is not	specified, displays a list of lpc com-
	     mands.

       exit | quit
	     Exits from	 lpc.

       status [all | printer ...]
	     Displays the status of print daemons and print queues. all	speci-
	     fies  that	 this  command	is  performed  on all locally attached
	     printers. printer indicates this command is performed on specific
	     printers. Specify
	      printer as an atomic name.  See printers.conf(4) for information
	     regarding naming conventions for atomic names.

       Only a super-user may execute the following  lpc	commands:

       abort [all | printer ...]
	     Terminates	an active spooling daemon. Disables printing (by  pre-
	     venting  new daemons from being started by	lpr(1B)) for  printer.
	     all specifies this	command	is performed on	all  locally  attached
	     printers. printer indicates this command is performed on specific
	     printers. Specify	printer	as an atomic name.  See	 printers.conf
	     (4)  for  information  regarding  naming  conventions  for	atomic
	     names.

       clean [all | printer ...]
	     Removes files created in the print	spool directory	by  the	 print
	     daemon from  printer 's print queue. all specifies	that this com-
	     mand is performed on all locally attached printers.printer	 indi-
	     cates  this  command  is  performed on specific printers. Specify
	     printer as	an atomic name.	 See printers.conf(4) for  information
	     regarding naming conventions for atomic names.

       disable [all | printer ...]
	     Turns  off	 the  print  queue for	 printer. Prevents new printer
	     jobs from being entered  into  the	 print	queue  for   printerby
	     lpr(1B).  all specifies that this command is performed on all lo-
	     cally attached printers. printer indicates	this command  is  per-
	     formed  on	specific printers. Specify  printer as an atomic name.
	     See printers.conf (4) for information  regarding  naming  conven-
	     tions for atomic names.

       down [all | printer ...]	[message]
	     Turns  the	 queue	for  printer  off  and	disables  printing  on
	     printer. Inserts message in the printer status file. message does
	     not  need	to  be	quoted;	  multiple  arguments  to  message are
	     treated as	arguments are to echo(1). Use down to take  a  printer
	     down  and	inform users.  all specifies that this command is per-
	     formed on all locally attached printers. printer  indicates  this
	     command  is performed on specific printers. Specify printer as an
	     atomic name.  See printers.conf(4)	for information	regarding nam-
	     ing conventions for atomic	names.

       enable [all | printer ...]
	     Enables lpr(1B) to	add new	jobs in	the spool queue. all specifies
	     that this command is performed on all locally attached  printers.
	     printer indicates this command is performed on specific printers.
	     Specify  printer as an atomic name.  See printers.conf(4) for in-
	     formation regarding naming	conventions for	atomic names.

       restart [all | printer ...]
	     Attempts  to start	a new printer daemon. restart is useful	when a
	     print daemon dies unexpectedly  and  leaves  jobs	in  the	 print
	     queue.  all  specifies  that this command is performed on all lo-
	     cally attached printers. printer indicates	that this  command  is
	     performed	on  specific  printers.	 Specify  printer as an	atomic
	     name. See printers.conf(4)	for information	regarding naming  con-
	     ventions for atomic names.

       start [all | printer ...]
	     Enables  printing.	Starts a spooling daemon for the  printer. all
	     specifies that this command is performed on all locally  attached
	     printers.	printer	indicates the command is performed on specific
	     printers.	Specify	  printer  as  an  atomic  name.   See	print-
	     ers.conf(4)  for  information  regarding  naming  conventions for
	     atomic names.

       stop [all | printer ...]
	     Stops a spooling daemon after the current job is  complete.  Dis-
	     ables  printing  at that time. all	specifies that this command is
	     performed on all locally  attached	 printers.  printer  indicates
	     this  command is performed	on specific printers. Specify  printer
	     as	an atomic name.	 See printers.conf(4) for information  regard-
	     ing naming	conventions for	atomic names.

       topq printer [request-ID	...] [user ...]
	     Moves   request-ID	 or print jobs belonging to user on printer to
	     the beginning of the print	queue.	Specify	 user as a user's  lo-
	     gin  name.	 Specify   printer  as	an  atomic  name.   See	print-
	     ers.conf(4) for  information  regarding  naming  conventions  for
	     atomic names.

       up [all | printer ...]
	     Turns  the	queue for printer on and enables printing on  printer.
	     Deletes the message in  the  printer  status  file	 (inserted  by
	     down).  Use   up  to undo the effects of down. all	specifies that
	     this command is  performed	 on  all  locally  attached  printers.
	     printer indicates this command is performed on specific printers.
	     Specify  printer as an atomic name. See printers.conf( 4) for in-
	     formation regarding naming	conventions for	atomic names.

EXIT STATUS
       The following exit values are returned:

       0     Successful	completion.

       non-zero
	     An	error occurred.

FILES
       /var/spool/lp/*
	     LP	print queue.

       /var/spool/lp/system/pstatus
	     Printer status information	file.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWscplp			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       echo(1),	  lpq(1B),  lpr(1B),  lprm(1B),	 lpstat(1),  lpsched(1M),  lp-
       shut(1M), printers.conf(4), attributes(5)

DIAGNOSTICS
       Ambiguous command
	     Indicates that the	lpc command or abbreviation matches more  than
	     one command.

       ?Invalid	command
	     Indicates that the	lpc command or abbreviation is not recognized.

       ?Privileged command
	     Indicates	that   the lpc command or abbreviation can be executed
	     only by a super-user.

       lpc: printer: unknown printer to	the print service
	     Indicates that printer does not exist in the LP  database.	 Check
	     that   printer  was  correctly  specified.	  Use lpstat -p	or the
	     status command (see  lpstat(1) or USAGE) to check the  status  of
	     printers.

       lpc: error on opening queue to spooler
	     Indicates	that  the  connection to lpsched failed. Usually means
	     that the printer server has died or is hung. Use  /usr/lib/lp/lp-
	     sched to check if the printer spooler daemon is running.

       lpc: Can't send message to LP print service

       lpc: Can't receive message from LP print	service
	     Indicates	that  the LP print service stopped. Contact the	LP ad-
	     ministrator.

       lpc: Received unexpected	message	from LP	print service
	     Indicates a problem with the software. Contact the	LP administra-
	     tor.

SunOS 5.9			  7 Apr	1999			       lpc(1B)

NAME | SYNOPSIS | DESCRIPTION | USAGE | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO | DIAGNOSTICS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=lpc&sektion=1b&manpath=SunOS+5.9>

home | help