1lpc(1B) SunOS/BSD Compatibility Package Commands lpc(1B)
2
6 lpc - line printer control program
7
9 /usr/ucb/lpc [command [parameter...]]
10
13 The lpc utility controls the operation of local printers.
14 Use lpc to perform the following functions:
17 o start or stop a printer,
19 o disable or enable a printer's spooling queue,
21 o rearrange the order of jobs in a print queue, or
23 o display the status of a printer print queue and printer dae‐
25 mon.
26 lpc can be run from the command line or interactively. Specifying lpc
29 with the optional command andparameter arguments causes lpc to inter‐
30 pret the first argument as an lpc command, and all other arguments as
31 parameters to that command. Specifying lpc without arguments causes it
32 to run interactively, prompting the user for lpc commands with lpc>. By
33 redirecting the standard input, lpc can read commands from a file.
34
36 lpc commands can be typed in their entirety or abbreviated to an unam‐
37 biguous substring. Some lpc commands are available to all users; others
38 are available only to super-users.
39 All users can execute the following lpc commands:
42 ? [command ...] | help [command ...]
44 Displays a short description of command. command is an lpc command.
46 If command is not specified, displays a list of lpc commands.
47 exit | quit
50 Exits from lpc.
52 status [all | printer...]
55 Displays the status of print daemons and print queues. all speci‐
57 fies that this command is performed on all locally attached print‐
58 ers. printer indicates this command is performed on specific print‐
59 ers. Specify printer as an atomic name. See printers.conf(4) for
60 information regarding naming conventions for atomic names.
61 Only a super-user can execute the following lpc commands:
65 abort [all | printer...]
67 Terminates an active spooling daemon. Disables printing (by pre‐
69 venting new daemons from being started by lpr(1B)) for printer. all
70 specifies this command is performed on all locally attached print‐
71 ers. printer indicates this command is performed on specific print‐
72 ers. Specify printer as an atomic name. See printers.conf(4) for
73 information regarding naming conventions for atomic names.
74 clean [all | printer...]
77 Removes files created in the print spool directory by the print
79 daemon from printer 's print queue. all specifies that this command
80 is performed on all locally attached printers.printer indicates
81 this command is performed on specific printers. Specify printer as
82 an atomic name. See printers.conf(4) for information regarding nam‐
83 ing conventions for atomic names.
84 disable [all | printer ...]
87 Turns off the print queue for printer. Prevents new printer jobs
89 from being entered into the print queue for printerby lpr(1B). all
90 specifies that this command is performed on all locally attached
91 printers. printer indicates this command is performed on specific
92 printers. Specify printer as an atomic name. See printers.conf(4)
93 for information regarding naming conventions for atomic names.
94 down [all | printer ...] [message]
97 Turns the queue for printer off and disables printing on printer.
99 Inserts message in the printer status file. message does not need
100 to be quoted; multiple arguments to message are treated as argu‐
101 ments are to echo(1). Use down to take a printer down and inform
102 users. all specifies that this command is performed on all locally
103 attached printers. printer indicates this command is performed on
104 specific printers. Specify printer as an atomic name. See print‐
105 ers.conf(4) for information regarding naming conventions for atomic
106 names.
107 enable [all | printer ...]
110 Enables lpr(1B) to add new jobs in the spool queue. all specifies
112 that this command is performed on all locally attached printers.
113 printer indicates this command is performed on specific printers.
114 Specify printer as an atomic name. See printers.conf(4) for infor‐
115 mation regarding naming conventions for atomic names.
116 restart [all | printer...]
119 Attempts to start a new printer daemon. restart is useful when a
121 print daemon dies unexpectedly and leaves jobs in the print queue.
122 all specifies that this command is performed on all locally
123 attached printers. printer indicates that this command is performed
124 on specific printers. Specify printer as an atomic name. See print‐
125 ers.conf(4) for information regarding naming conventions for atomic
126 names.
127 start [all | printer...]
130 Enables printing. Starts a spooling daemon for the printer. all
132 specifies that this command is performed on all locally attached
133 printers. printer indicates the command is performed on specific
134 printers. Specify printer as an atomic name. See printers.conf(4)
135 for information regarding naming conventions for atomic names.
136 stop [all | printer...]
139 Stops a spooling daemon after the current job is complete. Disables
141 printing at that time. all specifies that this command is performed
142 on all locally attached printers. printer indicates this command is
143 performed on specific printers. Specify printer as an atomic name.
144 See printers.conf(4) for information regarding naming conventions
145 for atomic names.
146 topq printer[request-ID...] [user ...]
149 Moves request-ID or print jobs belonging to user on printer to the
151 beginning of the print queue. Specify user as a user's login name.
152 Specify printer as an atomic name. See printers.conf(4) for infor‐
153 mation regarding naming conventions for atomic names.
154 up [all | printer ...]
157 Turns the queue for printer on and enables printing on printer.
159 Deletes the message in the printer status file (inserted by down).
160 Use up to undo the effects of down. all specifies that this command
161 is performed on all locally attached printers. printer indicates
162 this command is performed on specific printers. Specify printer as
163 an atomic name. See printers.conf(4) for information regarding nam‐
164 ing conventions for atomic names.
165
168 The following exit values are returned:
169 0 Successful completion.
171 non-zero An error occurred.
174
177 /etc/printers.conf System printer configuration database
178 $HOME/.printers User-configurable printer database
181 printers.conf.byname NIS version of /etc/printers.conf
184 printers.org_dir NIS+ version of /etc/printers.conf
187 ou=printers LDAP version of /etc/printers.conf
190
193 See attributes(5) for descriptions of the following attributes:
194 ┌─────────────────────────────┬─────────────────────────────┐
199 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
200 ├─────────────────────────────┼─────────────────────────────┤
201 │Availability │SUNWlpr-cmds │
202 ├─────────────────────────────┼─────────────────────────────┤
203 │Interface Stability │Standard │
204 └─────────────────────────────┴─────────────────────────────┘
205
207 lpq(1B), lpr(1B), lprm(1B), lpstat(1), lpsched(1M), lpshut(1M),
208 svcadm(1M), printers.conf(4), attributes(5)
209
211 Use the svcs(1) utility to check if svc:/application/print/server is
212 running. If it is not running, use svcadm enable svc:/applica‐
213 tion/print/server to start lpsched. See svcadm(1M).
214
216 When IPP is in use, the user is prompted for a passphrase if the remote
217 print service is configured to require authentication.
218SunOS 5.11 2 Jun 2006 lpc(1B)