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

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
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
	     locally 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
	     information 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
	     locally 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
	     login 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
	     information 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),
       lpshut(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/lpsched  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
	     administrator.

       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