LPC(1B) 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 andparameter 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 can be typed in their entirety or abbreviated to an
unambiguous substring. Some lpc commands are available to all users;
others are available only to super-users.


All users can execute the following lpc 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.


status [all | printer...]

Displays the status of print daemons and print queues. 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(5)
for information regarding naming conventions for atomic names.


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

abort [all | printer...]

Terminates an active spooling daemon. Disables printing (by
preventing 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(5) 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
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(5) 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 printer by lpr(1B).
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(5) for information regarding naming conventions 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 performed on
all locally attached printers. printer indicates this command is
performed on specific printers. Specify printer as an atomic
name. See printers.conf(5) for information regarding naming
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(5) 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(5) for information regarding naming
conventions 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 printers.conf(5)
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 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(5) for information regarding
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 printers.conf(5)
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(5) 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

/etc/printers.conf
System printer configuration database


$HOME/.printers
User-configurable printer database


printers.conf.byname
NIS version of /etc/printers.conf


ou=printers
LDAP version of /etc/printers.conf

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+

SEE ALSO

lpstat(1), lpq(1B), lpr(1B), lprm(1B), printers.conf(5),
attributes(7), lpsched(8), lpshut(8), svcadm(8)

DIAGNOSTICS

Use the svcs(1) utility to check if svc:/application/print/server is
running. If it is not running, use svcadm enable
svc:/application/print/server to start lpsched. See svcadm(8).

NOTES

When IPP is in use, the user is prompted for a passphrase if the
remote print service is configured to require authentication.

June 20, 2021 LPC(1B)