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 andparameter argu-
ments causes lpc to interpret the first argument as an lpc
command, and all other arguments as parameters to that com-
mand. 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 com-
mands 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.
SunOS 5.11 Last change: 2 Jun 2006 1
SunOS/BSD Compatibility Package Commands lpc(1B)
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 com-
mand 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 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 per-
formed 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.
clean [all printer...]
Removes files created in the print spool directory by
the print daemon from printer 's print queue. all speci-
fies 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 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 performed on specific
printers. Specify printer as an atomic name. See
printers.conf(4) for information regarding naming con-
ventions 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.
SunOS 5.11 Last change: 2 Jun 2006 2
SunOS/BSD Compatibility Package Commands lpc(1B)
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 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.
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 use-
ful 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 printers.conf(4) for
information regarding naming conventions for atomic
names.
stop [all printer...]
Stops a spooling daemon after the current job is com-
plete. 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(4) for information regarding naming
conventions for atomic names.
SunOS 5.11 Last change: 2 Jun 2006 3
SunOS/BSD Compatibility Package Commands lpc(1B)
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.
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 com-
mand 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
/etc/printers.conf System printer configuration data-
base
$HOME/.printers User-configurable printer database
printers.conf.byname NIS version of /etc/printers.conf
printers.orgdir NIS] version of /etc/printers.conf
ou=printers LDAP version of /etc/printers.conf
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 2 Jun 2006 4
SunOS/BSD Compatibility Package Commands lpc(1B)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWlpr-cmds
Interface Stability Standard
SEE ALSO
lpq(1B), lpr(1B), lprm(1B), lpstat(1), lpsched(1M),
lpshut(1M), svcadm(1M), printers.conf(4), attributes(5)
DIAGNOSTICS
Use the svcs(1) utility to check if
svc:/application/print/server is running. If it is not run-
ning, use svcadm enable svc:/application/print/server to
start lpsched. See svcadm(1M).
NOTES
When IP is in use, the user is prompted for a passphrase if
the remote print service is configured to require authenti-
cation.
SunOS 5.11 Last change: 2 Jun 2006 5
|
