NAME

lpc - line printer control program

SYNOPSIS

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

DESCRIPTION

lpc controls the operation of the printer,  or  of  multiple
printers.   lpc  commands  can  be  used  to start or stop a
printer, disable or enable a printer's spooling queue, rear-
range the order of jobs in a queue, or display the status of
each printer-along with its spooling queue and printer  dae-
mon.   With  no arguments, lpc runs interactively, prompting
with `lpc>'.  If arguments are supplied, lpc interprets  the
first  as  a command to execute; each subsequent argument is
taken as a parameter for that command.  The  standard  input
can  be  redirected  so that lpc reads commands from a file.
Commands may be abbreviated  to  an  unambiguous  substring.
Note: the printer parameter is specified just by the name of
the printer (as lw), not as you would specify it  to  lpr(1)
or lpq(1) (not as -Plw).
?  [command]...
help [command]...
     Display a short description of each  command  specified
     in  the argument list, or, if no arguments are given, a
     list of the recognized commands.

abort [all| [printer...]]

Terminate an active spooling daemon on the local host immediately and then disable printing (preventing new daemons from being started by lpr(1)) for the specified printers. The abort command can only be used by the privileged user.

clean [all| [printer...]]

Remove all files created in the spool directory by the daemon from the specified printer queue(s) on the local machine. The clean command can only be used by the privileged user.

disable [all| [printer...]]

Turn the specified printer queues off. This prevents new printer jobs from being entered into the queue by lpr(1). The disable command can only be used by the privileged user.

down [all| [printer...]]  [message]

Turn the specified printer queue off, disable printing and put message in the printer status file. The message does not need to be quoted, the remaining arguments are treated like echo(1). This is normally used to take a printer down and let others know why (lpq(1) indicates that the printer is down, as does the status command).

enable [all| [printer...]]

Enable spooling on the local queue for the listed printers, so that lpr(1) can put new jobs in the spool queue. The enable command can only be used by the privileged user.

exit
quit Exit from lpc.

restart [all| [printer...]]

Attempt to start a new printer daemon. This is useful when some abnormal condition causes the daemon to die unexpectedly leaving jobs in the queue. This command can be run by any user.

start [all| [printer...]]

Enable printing and start a spooling daemon for the listed printers. The start command can only be used by the privileged user.

status [all| [printer...]]

Display the status of daemons and queues on the local machine. This command can be run by any user.

stop [all| [printer...]]

Stop a spooling daemon after the current job completes and disable printing. The stop command can only be used by the privileged user.

topq printer [job#...]  [user...]

Move the print job(s) specified by job# or those job(s) belonging to user to the top (head) of the printer queue. The topq command can only be used by the privileged user.

up [all| [printer...]]  Enable everything and  start  a  new
     printer daemon.  Undoes the effects of down.

FILES

/var/spool/lp/*
/var/spool/lp/system/pstatus

SEE ALSO

lpq(1), lpr(1), lprm(1)  echo(1)  in  the  User's  Reference
Manual.
lpsched(1M) in the System Administrator's Reference Manual.

DIAGNOSTICS

?Ambiguous command

The abbreviation you typed matches more than one command.

?Invalid command

You typed a command or abbreviation that was not recognized.

?Privileged command

You used a command can be executed only by the privileged user.

lpc: printer: unknown printer to the print service

The printer was not found in the System V LP database. Usually this is a typing mistake; however, it may indicate that the printer does not exist on the system. Use `lptstat -p' to find the reason.

lpc: error on opening queue to spooler

The connection to lpsched on the local machine failed. This usually means the printer server started at boot time has died or is hung. Check if the printer spooler daemon /usr/lib/lp/lpsched is running.

lpc: Can't send message to LP print service

lpc: Can't receive message from LP print service

These indicate that the LP print service has been stopped. Get help from the system administrator.

lpc: Received unexpected message from LP print service

It is likely there is an error in this software. Get help from system administrator.