1lpc(1B)            SunOS/BSD Compatibility Package Commands            lpc(1B)
2
3
4

NAME

6       lpc - line printer control program
7

SYNOPSIS

9       /usr/ucb/lpc [command [parameter...]]
10
11

DESCRIPTION

13       The lpc utility controls the operation of local printers.
14
15
16       Use lpc to perform the following functions:
17
18           o      start or stop a printer,
19
20           o      disable or enable a printer's spooling queue,
21
22           o      rearrange the order of jobs in a print queue, or
23
24           o      display the status of a printer print queue and printer dae‐
25                  mon.
26
27
28       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

USAGE

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
40
41       All users can execute the following lpc commands:
42
43       ? [command ...] | help [command ...]
44
45           Displays a short description of command. command is an lpc command.
46           If command is not specified, displays a list of lpc commands.
47
48
49       exit | quit
50
51           Exits from lpc.
52
53
54       status [all | printer...]
55
56           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
62
63
64       Only a super-user can execute the following lpc commands:
65
66       abort [all | printer...]
67
68           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
75
76       clean [all | printer...]
77
78           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
85
86       disable [all | printer ...]
87
88           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
95
96       down [all | printer ...] [message]
97
98           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
108
109       enable [all | printer ...]
110
111           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
117
118       restart [all | printer...]
119
120           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
128
129       start [all | printer...]
130
131           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
137
138       stop [all | printer...]
139
140           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
147
148       topq printer[request-ID...] [user ...]
149
150           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
155
156       up [all | printer ...]
157
158           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
166

EXIT STATUS

168       The following exit values are returned:
169
170       0           Successful completion.
171
172
173       non-zero    An error occurred.
174
175

FILES

177       /etc/printers.conf       System printer configuration database
178
179
180       $HOME/.printers         User-configurable printer database
181
182
183       printers.conf.byname    NIS version of /etc/printers.conf
184
185
186       printers.org_dir         NIS+ version of /etc/printers.conf
187
188
189       ou=printers             LDAP version of /etc/printers.conf
190
191

ATTRIBUTES

193       See attributes(5) for descriptions of the following attributes:
194
195
196
197
198       ┌─────────────────────────────┬─────────────────────────────┐
199       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
200       ├─────────────────────────────┼─────────────────────────────┤
201       │Availability                 │SUNWlpr-cmds                 │
202       ├─────────────────────────────┼─────────────────────────────┤
203       │Interface Stability          │Standard                     │
204       └─────────────────────────────┴─────────────────────────────┘
205

SEE ALSO

207       lpq(1B),   lpr(1B),   lprm(1B),   lpstat(1),  lpsched(1M),  lpshut(1M),
208       svcadm(1M), printers.conf(4), attributes(5)
209

DIAGNOSTICS

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

NOTES

216       When IPP is in use, the user is prompted for a passphrase if the remote
217       print service is configured to require authentication.
218
219
220
221SunOS 5.11                        2 Jun 2006                           lpc(1B)
Impressum