|
|
1.1 root 1: .\" Copyright (c) 1983 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted provided
5: .\" that: (1) source distributions retain this entire copyright notice and
6: .\" comment, and (2) distributions including binaries display the following
7: .\" acknowledgement: ``This product includes software developed by the
8: .\" University of California, Berkeley and its contributors'' in the
9: .\" documentation or other materials provided with the distribution and in
10: .\" all advertising materials mentioning features or use of this software.
11: .\" Neither the name of the University nor the names of its contributors may
12: .\" be used to endorse or promote products derived from this software without
13: .\" specific prior written permission.
14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
17: .\"
18: .\" @(#)lpc.8 6.3 (Berkeley) 6/24/90
19: .\"
20: .TH LPC 8 "June 24, 1990"
21: .UC 5
22: .ad
23: .SH NAME
24: lpc \- line printer control program
25: .SH SYNOPSIS
26: .B lpc
27: [ command [ argument ... ] ]
28: .SH DESCRIPTION
29: .I Lpc
30: is used by the system administrator to control the
31: operation of the line printer system.
32: For each line printer configured in /etc/printcap,
33: .I lpc
34: may be used to:
35: .IP \(bu
36: disable or enable a printer,
37: .IP \(bu
38: disable or enable a printer's spooling queue,
39: .IP \(bu
40: rearrange the order of jobs in a spooling queue,
41: .IP \(bu
42: find the status of printers, and their associated
43: spooling queues and printer dameons.
44: .PP
45: Without any arguments,
46: .I lpc
47: will prompt for commands from the standard input.
48: If arguments are supplied,
49: .IR lpc
50: interprets the first argument as a command and the remaining
51: arguments as parameters to the command. The standard input
52: may be redirected causing
53: .I lpc
54: to read commands from file.
55: Commands may be abreviated;
56: the following is the list of recognized commands.
57: .TP
58: ? [ command ... ]
59: .TP
60: help [ command ... ]
61: .br
62: Print a short description of each command specified in the argument list,
63: or, if no arguments are given, a list of the recognized commands.
64: .TP
65: abort { all | printer ... }
66: .br
67: Terminate an active spooling daemon on the local host immediately and
68: then disable printing (preventing new daemons from being started by
69: .IR lpr )
70: for the specified printers.
71: .TP
72: clean { all | printer ... }
73: .br
74: Remove any temporary files, data files, and control files that cannot
75: be printed (i.e., do not form a complete printer job)
76: from the specified printer queue(s) on the local machine.
77: .TP
78: disable { all | printer ... }
79: .br
80: Turn the specified printer queues off. This prevents new
81: printer jobs from being entered into the queue by
82: .IR lpr .
83: .TP
84: down { all | printer } message ...
85: .br
86: Turn the specified printer queue off, disable printing and put
87: .I message
88: in the printer status file. The message doesn't need to be quoted, the
89: remaining arguments are treated like
90: .IR echo (1).
91: This is normally used to take a printer down and let others know why
92: (lpq will indicate the printer is down and print the status message).
93: .TP
94: enable { all | printer ... }
95: .br
96: Enable spooling on the local queue for the listed printers.
97: This will allow
98: .I lpr
99: to put new jobs in the spool queue.
100: .TP
101: exit
102: .TP
103: quit
104: .br
105: Exit from lpc.
106: .TP
107: restart { all | printer ... }
108: .br
109: Attempt to start a new printer daemon.
110: This is useful when some abnormal condition causes the daemon to
111: die unexpectedly leaving jobs in the queue.
112: .I Lpq
113: will report that there is no daemon present when this condition occurs.
114: If the user is the super-user,
115: try to abort the current daemon first (i.e., kill and restart a stuck daemon).
116: .TP
117: start { all | printer ... }
118: .br
119: Enable printing and start a spooling daemon for the listed printers.
120: .TP
121: status { all | printer ... }
122: Display the status of daemons and queues on the local machine.
123: .TP
124: stop { all | printer ... }
125: .br
126: Stop a spooling daemon after the current job completes and disable
127: printing.
128: .TP
129: topq printer [ jobnum ... ] [ user ... ]
130: .br
131: Place the jobs in the order listed at the top of the printer queue.
132: .TP
133: up { all | printer ... }
134: .br
135: Enable everything and start a new printer daemon. Undoes the effects of
136: .IR down .
137: .SH FILES
138: .nf
139: .ta \w'/etc/printcap 'u
140: /etc/printcap printer description file
141: /var/spool/* spool directories
142: /var/spool/*/lock lock file for queue control
143: .fi
144: .SH "SEE ALSO"
145: lpd(8),
146: lpr(1),
147: lpq(1),
148: lprm(1),
149: printcap(5)
150: .SH DIAGNOSTICS
151: .nf
152: .ta \w'?Ambiguous command 'u
153: ?Ambiguous command abreviation matches more than one command
154: ?Invalid command no match was found
155: ?Privileged command command can be executed by root only
156: .fi
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.