1LPC(8)                      System Manager's Manual                     LPC(8)
2
3
4

NAME

6       lpc - line printer control program
7

SYNOPSIS

9       /usr/sbin/lpc [ command [ argument ... ] ]
10

DESCRIPTION

12       Lpc is used by the system administrator to control the operation of the
13       line printer system.  For each line printer configured  in  /etc/print‐
14       cap, lpc may be used to:
15
16       ·      disable or enable a printer,
17
18       ·      disable or enable a printer's spooling queue,
19
20       ·      rearrange the order of jobs in a spooling queue,
21
22       ·      find  the  status  of  printers,  and  their associated spooling
23              queues and printer dameons.
24
25       Without any arguments, lpc will prompt for commands from  the  standard
26       input.  If arguments are supplied, lpc interprets the first argument as
27       a command and the remaining arguments as  parameters  to  the  command.
28       The  standard input may be redirected causing lpc to read commands from
29       file.  Commands may be abreviated; the following is the list of  recog‐
30       nized commands.
31
32       ? [ command ... ]
33
34       help [ command ... ]
35              Print a short description of each command specified in the argu‐
36              ment list, or, if no arguments are given, a list of  the  recog‐
37              nized commands.
38
39       abort { all | printer ... }
40              Terminate  an  active  spooling daemon on the local host immedi‐
41              ately and then disable printing  (preventing  new  daemons  from
42              being started by lpr) for the specified printers.
43
44       clean { all | printer ... }
45              Remove  any  temporary files, data files, and control files that
46              cannot be printed (i.e., do not form  a  complete  printer  job)
47              from the specified printer queue(s) on the local machine.
48
49       disable { all | printer ... }
50              Turn  the  specified  printer  queues  off.   This  prevents new
51              printer jobs from being entered into the queue by lpr.
52
53       down { all | printer } message ...
54              Turn the specified printer queue off, disable printing  and  put
55              message  in the printer status file. The message doesn't need to
56              be quoted, the remaining arguments  are  treated  like  echo(1).
57              This is normally used to take a printer down and let others know
58              why (lpq will indicate the printer is down and print the  status
59              message).
60
61       enable { all | printer ... }
62              Enable  spooling  on  the  local  queue for the listed printers.
63              This will allow lpr to put new jobs in the spool queue.
64
65       exit
66
67       quit
68              Exit from lpc.
69
70       restart { all | printer ... }
71              Attempt to start a new printer daemon.  This is useful when some
72              abnormal condition causes the daemon to die unexpectedly leaving
73              jobs in the queue.  Lpq will report  that  there  is  no  daemon
74              present  when  this condition occurs.  If the user is the super-
75              user, try to abort the current  daemon  first  (i.e.,  kill  and
76              restart a stuck daemon).
77
78       start { all | printer ... }
79              Enable  printing  and  start  a  spooling  daemon for the listed
80              printers.
81
82       status { all | printer ... }
83              Display the status of daemons and queues on the local machine.
84
85       stop { all | printer ... }
86              Stop a spooling daemon after the current job completes and  dis‐
87              able printing.
88
89       topq printer [ jobnum ... ] [ user ... ]
90              Place  the  jobs  in  the order listed at the top of the printer
91              queue.
92
93       up { all | printer ... }
94              Enable everything and start a new  printer  daemon.  Undoes  the
95              effects of down.
96

FILES

98       /etc/printcap           printer description file
99       /usr/spool/*            spool directories
100       /usr/spool/*/lock       lock file for queue control
101

SEE ALSO

103       lpd(8), lpr(1), lpq(1), lprm(1), printcap(5)
104

DIAGNOSTICS

106       ?Ambiguous command      abreviation matches more than one command
107       ?Invalid command        no match was found
108       ?Privileged command     command can be executed by root only
109
110
111
1124.2 Berkeley Distribution      November 1, 1996                         LPC(8)
Impressum