Provided by:
lprng_3.8.A-1_i386 
NAME
lpc - line printer control program
SYNOPSIS
lpc [ -A ] [ -a ] [ -Ddebugopts ] [ -Pprinter ] [ -Sserver ] [
-Uusername ] [ -V ] [ command [ argument ... ] ]
DESCRIPTION
Lpc is used by the system administrator to control the operation of the
line printer system. For each line printer configured in
//etc/printcap or the printcaps specified in the configuration file
//etc/lprng/lpd.conf (see lpd.conf(5)), lpc may be used to:
· disable or enable a single or all printer,
· disable or enable a single printer’s or all printer’s spooling
queue,
· move jobs to the top a queue
· find the status of printers, and their associated spooling queues
and printer daemons,
· start and stop printer servers for a queue with multiple print
servers,
· hold and release a specific job in a printer queue,
· redirect printing to another printer,
· restart a printer job after having solved printer problems and let
it print from the beginning,
· reprint a job
Without any arguments, lpc will prompt for commands from the standard
input. If arguments are supplied, lpc interprets the first argument as
a command and the remaining arguments as parameters to the command.
Permission to use spool queue control commands is determined by the
printer permissions file (See FILES).
OPERATION
The operation of each spool queue is controlled by a spoolcontrol file
which has a set of keyword options and values. (Other print spoolers
have used permissions bits of directories and files for similar
purposes). In addition, each job in the spool queue can have a
holdfile which contains detailed information on how the spooler is to
treat the particular job. The server will update these files with
status and other information as the job is processed. The lpc command
operates by sending requests to the lpd server process to update the
information in these files and to signal server processes that the
information has been updated.
OPTIONS
-A Use authentication specified by the value of the AUTH environment
variable.
-a Alias for -Pall.
-Pprinter
Printer spool queue to operate on. if no name is given, the -P
option, the printer selected by the value of the PRINTER
environment variable, or the first entry in the printcap file will
be used. When all printers are selected, the LPC command will
first attempt to find the printcap entry for printer ‘‘all’’; the
all printcap field value will be a list of printers to control.
If there is no printcap entry, then the request is directly
forwarded to the default LPD host, which will do a lookup for all
of the available printers. By specifying ‘‘all@host’’, the user
can control all printers on a given host.
-Sserver
Send commands to this server, rather than the one specified by the
-Pprinter" or printcap entry. This allows you to use a default
printcap entry for authentication information or other setup
information, but direct queries to a specific server.
-V Print program version information
-Uusername
Set the user name for the request. This option is available only
to user root or to the userids listed in the allow_user_setting
configuration option.
-Ddebugopts
Debugging is controlled using the -D option. This accepts a comma-
separated list of debugging settings. These settings take one of
two forms: facility=value , or value to set an overall default
value. The form -D= will display a list of debugging options.
COMMANDS
The following is the alphabetical list of recognized commands. The
jobcontrol or holdfile fields effective are listed as part of the
command.
?
Help. Also, any unrecognized input produces a help listing.
active [pr@[host]]
makes a connection to the LPD server for the specified printer.
Closes the connection after making it. This is useful for
checking to see if a non-LPRng server is active.
abort { all | printer* }
Kill the active job and disables unspooling. The active job
will not be deleted from the queue.
Action: kills server process, updates spool control file
printing_disabled field.
class {all | printer } (off | classlist | X=globmatch)
Controls the class of jobs currently being printed. The off
option removes any class restrictions. The classlist option is
a list of classes; for example A,B,C would release classes A, B,
and C for printing. The X=globmatch form performs a match
against a control file entry starting with the indicated capital
letter. For example, J=*form1* would allow jobs which had the
string form1 in their job title to be printed.
defaultq
Lists the default queue for the LPC program.
defaults
Lists default values for the configuration information.
debug j all | printer } [string | off ]
Set the debugging string for the specified printer. This is a
diagnostic aid and should be used with caution; refer to the
reference manual for details of the debugging string format. In
general, you can use:
INTEGER - the integer number sets the general debugging level
keyword=value
- sets a debugging variable to a specified value
keyword - sets a debugging flag
Action: updates spool control file debug field.
disable { all | printer }
Disable spooling to the specified spool queues. See enable.
Action: updates spool control file printing_disabled field.
down {all | printer }
Disable both queuing and printing for all printers or the
selected printer. See up.
Action: updates spool control file printing_disabled and
spooling_disabled fields.
enable { all | printer }
Enable spooling for all printers or the selected printer.
Action: updates spool control file spooling_disabled field.
exit or quit
terminate LPC program
help
Print a short help message.
hold printer { jobid }
Holds the specified printer job (or jobs) in the queue. The job
will not be printed even if spooling and printing is enabled. It
must be released with the release command. The holdall command
or :ah: printcap flag can enable automatic holding of spooled
jobs.
Action: updates job holdfile hold field with time that job was
held. A 0 value release job for printing.
holdall { all | printer ... }
Turn on automatic job holding of new jobs. New jobs will be
marked as held, and held until released with the release
command. This will be done until holdall is turned off with the
noholdall command. The :ah: printcap flag can enable automatic
holding as well.
Action: updates spool control file holdall field.
kill { all | printer ... }
Do an abort command followed by a start command. This is a
quick way to kill off a server that has problems. Note that due
to race conditions and delays, that the start command may not be
effective this action should be monitored to ensure that the job
restarts.
client { all | printer ... }
Show the LPRng client configuration and printcap information on
the local host. This is an extremely useful diagnostic tool.
lpd [printer@[host]]
determines if LPD daemon process on the print server is running,
and gets the PID. This is handy to determine if the LPD daemon
was killed or aborted due to abnormal conditions.
lpq printer [options]
Run lpq from inside the lpc program.
lprm printer jobid [jobid]*
Run lprm from inside the lpc program. Not all options are
supported - this form requires the printer name and jobid to be
specified explicitly.
move printer jobid destinationPrinter
Send the specified jobs to the destination printer and remove
them from the printer queue.
Action: updates the job holdfile move field with the destination
and starts a server process to do the job transfer.
msg printer message text
Update the status message for the printer. An empty message
will remove the status message.
noholdall { all | printer* }
Turn off automatic job holding. See holdall command.
quit or exit
terminate LPC program
redirect [printer [destinationPrinter | off ]]
redirect the jobs in the printer queue to another printer or
turn redirection off.
Action: updates spool control file redirect field.
redo [printer [jobid]]
Reprint the selected job.
release [printer [jobid]]
Releases the selected job for printing.
reread [ printer [@host] ]
Sends a request to the LPD server for the printer to reread the
configuration and printcap information. This is equivalent to
using kill -HUP serverpid, but can be done for servers on remote
hosts.
server { all | printer }
Shows the printcap entries for the printer or all printers as
the LPD server would use them.
start { all | printer }
Start the printer. This is useful when some abnormal condition
causes the server to terminate unexpectedly leaving jobs in the
queue. Lpq will report that there is no daemon present when
this condition occurs.
status { all | printer }
Display the status of daemons and queues on the local machine.
stop { all | printer }
Disable any further unspooling after the current job completes.
topq printer [ jobid ]
Place the selected jobs at the top of the printer queue.
up {all | printer ...}
Enables queuing and printing for the specified or all printers.
Privileged.
JOBIDS
The LPQ command displays a job identifier for each job, which can be
used in LPC commands to identify a specific job. In the commands
descriptions above, the jobid can be a user name, a job number, a job
identifier, or a glob pattern. The glob pattern is matched against the
job identifier. In command which have an optional jobid, if none is
specified then the first printable job in the queue is acted on.
FILES
The files used by LPRng are set by values in the printer configuration
file. The following are a commonly used set of default values.
//etc/lprng/lpd.conf LPRng configuration file
${HOME}/.printcap user printer description file
//etc/printcap printer description file
//etc/lprng/lpd.perms permissions
/var/run/lprng/lpd lock file for queue control
/var/spool/lpd spool directories
/var/spool/lpd/QUEUE/control queue control
/var/spool/lpd/QUEUE/log trace or debug log file
/var/spool/lpd/QUEUE/acct accounting file
/var/spool/lpd/QUEUE/status status file
SEE ALSO
lpd.conf(5), lpd(8), checkpc(8), lpr(1), lpq(1), lprm(1), printcap(5),
lpd.perms(5), pr(1), lprng_certs(1), lprng_index_certs(1).
DIAGNOSTICS
Most of the diagnostics are self explanatory.
If you are puzzled over the exact cause of failure,
set the debugging level on (-D5) and run again.
The debugging information will
help you to pinpoint the exact cause of failure.
HISTORY
LPRng is a enhanced printer spooler system with functionality similar
to the Berkeley LPR software. The LPRng mailing list is
lprng@lprng.com; subscribe by sending mail to lprng-request@lprng.com
with the word subscribe in the body. The software is available from
ftp://ftp.lprng.com/pub/LPRng.
AUTHOR
Patrick Powell <papowell@lprng.com>.