man pages section 1: User Commands

lpc(1B)

NAME

lpc- Line printer control program

SYNOPSIS

/usr/ucb/lpc

command

parameter

DESCRIPTION

The lpc utility controls the operation of printers.

Use lpc to perform the following functions:

start or stop a printer
disable or enable a printer's spooling queue
rearrange the order of jobs in a print queue
display the status of a printer's 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 interpret 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 unambiguous substring. Specify the printer parameter by the name of the printer (for example, as lw), not as you would specify it to lpr(1B) or lpq(1B) (not as -Plw).

Some lpc commands are available to all users; others are available only to users who have the administer printing authorization.

All users may execute the following commands.

? [command ... ] | help [command ... ]: Displays a short description of command. command is an lpc command. If command is not specified, displays a list of lpc commands.

exit | quit: Exits from lpc.

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 to perform this command on all locally attached printers. printer indicates to perform this command on specific printers. Specify printer as an atomic name. See printers.conf(4) for information regarding naming conventions for atomic names.
status [all | printer ... ]: Displays the status of print daemons and print queues. all specifies perform this command on all locally attached printers. printer indicates perform this command on specific printers. Specify printer as an atomic name. See printers.conf(4) for information regarding naming conventions for atomic names.

Users who have the administer printing authorization may execute the following lpccommands

abort [all | printer ... ]: Terminates an active spooling daemon. Disables printing (by preventing new daemons from being started by lpr(1B)) for printer. all specifies perform this command on all locally attached printers. printer indicates perform this command on specific printers. Specify printer as an atomic name. See printers.conf(4) for information regarding naming conventions for atomic names.Use of this command requires the administer printing authorization.
clean [all | printer ... ]: Removes files created in the print spool directory by the print daemon from printer 's print queue. all specifies to perform this command on all locally attached printers printer indicates to perform this command on specific printers. Specify printer as an atomic name. See printers.conf(4) for information regarding naming conventions for atomic names. Use of this command requires the administer printing authorization.
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 to perform this command on all locally attached printers printer indicates to perform this command on specific printers. Specify printer as an atomic name. See printers.conf(4) for information regarding naming conventions for atomic names. Use of this command requires the administer printing authorization.
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. lpq(1B) indicates that the printer is down, as does the status command. all specifies to perform this command on all locally attached printers printer indicates to perform this command on specific printers. Specify printer as an atomic name. See printers.conf(4) for information regarding naming conventions for atomic names.
enable [all | printer ... ]: Enables lpr(1B) to add new jobs in the spool queue. all specifies to perform this command on all locally attached printers printer indicates to perform this command on specific printers. Specify printer as an atomic name. See printers.conf(4) for information regarding naming conventions for atomic names. Use of this command requires the administer printing authorization.
start [all | printer ... ]: Enables printing. Starts a spooling daemon for the printer. all specifies to perform this command on all locally attached printers printer indicates to perform this command on specific printers. Specify printer as an atomic name. See printers.conf(4) for information regarding naming conventions for atomic names.
stop [all | printer ... ]: Stops a spooling daemon after the current job is complete. Disables printing at that time. all specifies to perform this command on all locally attached printers printer indicates to perform this command on specific printers. Specify printer as an atomic name. See printers.conf(4) for information regarding naming conventions for atomic names. Use of this command requires the administer printing authorization.
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 printers.conf(4) for information regarding naming conventions for atomic names. Use of this command requires the administer printing authorization.
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 to perform this command on all locally attached printers printer indicates to perform this command 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

SUMMARY OF TRUSTED SOLARIS CHANGES

Functions of this command that are restricted to the super-user in Solaris require the administer printing authorization in the Trusted Solaris environment.

Trusted Solaris 8 Reference Manual

lpstat(1), lpq(1B), lpr(1B), lprm(1B), lpsched(1M), lpshut(1M)

SunOS 5.8 Reference Manual

echo(1), 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 users who have the administer printing authorization.
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 administrator.

Trusted Solaris 8 Last Revised 7 Apr 1999