lpc.8 (70403) | lpc.8 (71898) |
---|---|
1.\" Copyright (c) 1983, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)lpc.8 8.5 (Berkeley) 4/28/95 | 1.\" Copyright (c) 1983, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)lpc.8 8.5 (Berkeley) 4/28/95 |
33.\" $FreeBSD: head/usr.sbin/lpr/lpc/lpc.8 70403 2000-12-27 15:30:30Z ru $ | 33.\" $FreeBSD: head/usr.sbin/lpr/lpc/lpc.8 71898 2001-02-01 16:44:04Z ru $ |
34.\" 35.Dd April 28, 1995 36.Dt LPC 8 37.Os BSD 4.2 38.Sh NAME 39.Nm lpc 40.Nd line printer control program 41.Sh SYNOPSIS 42.Nm | 34.\" 35.Dd April 28, 1995 36.Dt LPC 8 37.Os BSD 4.2 38.Sh NAME 39.Nm lpc 40.Nd line printer control program 41.Sh SYNOPSIS 42.Nm |
43.Oo 44.Ar command 45.Op Ar argument ... 46.Oc | 43.Op Ar command Op Ar argument ... |
47.Sh DESCRIPTION 48.Nm Lpc 49is used by the system administrator to control the 50operation of the line printer system. 51For each line printer configured in 52.Pa /etc/printcap , 53.Nm 54may be used to: --- 17 unchanged lines hidden (view full) --- 72interprets the first argument as a command and the remaining 73arguments as parameters to the command. The standard input 74may be redirected causing 75.Nm 76to read commands from file. 77Commands may be abbreviated; 78the following is the list of recognized commands. 79.Pp | 44.Sh DESCRIPTION 45.Nm Lpc 46is used by the system administrator to control the 47operation of the line printer system. 48For each line printer configured in 49.Pa /etc/printcap , 50.Nm 51may be used to: --- 17 unchanged lines hidden (view full) --- 69interprets the first argument as a command and the remaining 70arguments as parameters to the command. The standard input 71may be redirected causing 72.Nm 73to read commands from file. 74Commands may be abbreviated; 75the following is the list of recognized commands. 76.Pp |
80.Bl -tag -width Ds -compact 81.It Ic \&? No [ command ... ] 82.It Ic help No [ command ... ] | 77.Bl -tag -width indent -compact 78.It Ic \&? Op Ar command ... 79.It Ic help Op Ar command ... |
83Print a short description of each command specified in the argument list, 84or, if no argument is given, a list of the recognized commands. 85.Pp | 80Print a short description of each command specified in the argument list, 81or, if no argument is given, a list of the recognized commands. 82.Pp |
86.It Ic abort No {\ all\ |\ printer\ } | 83.It Ic abort Xo 84.Es \&{ \&} 85.En Cm all | Ar printer 86.Xc |
87Terminate an active spooling daemon on the local host immediately and 88then disable printing (preventing new daemons from being started by 89.Xr lpr 1 ) 90for the specified printers. 91.Pp | 87Terminate an active spooling daemon on the local host immediately and 88then disable printing (preventing new daemons from being started by 89.Xr lpr 1 ) 90for the specified printers. 91.Pp |
92.It Ic clean No {\ all\ |\ printer\ } | 92.It Ic clean Xo 93.Es \&{ \&} 94.En Cm all | Ar printer 95.Xc |
93Remove any temporary files, data files, and control files that cannot 94be printed (i.e., do not form a complete printer job) 95from the specified printer queue(s) on the local machine. 96.Pp | 96Remove any temporary files, data files, and control files that cannot 97be printed (i.e., do not form a complete printer job) 98from the specified printer queue(s) on the local machine. 99.Pp |
97.It Ic disable No {\ all\ |\ printer\ } | 100.It Ic disable Xo 101.Es \&{ \&} 102.En Cm all | Ar printer 103.Xc |
98Turn the specified printer queues off. This prevents new 99printer jobs from being entered into the queue by 100.Xr lpr 1 . 101.Pp | 104Turn the specified printer queues off. This prevents new 105printer jobs from being entered into the queue by 106.Xr lpr 1 . 107.Pp |
102.It Ic down No {\ all\ |\ printer\ } message ... | 108.It Ic down Xo 109.Es \&{ \&} 110.En Cm all | Ar printer 111.Ar message ... 112.Xc |
103Turn the specified printer queue off, disable printing and put | 113Turn the specified printer queue off, disable printing and put |
104.Em message | 114.Ar message |
105in the printer status file. 106The message doesn't need to be quoted, the 107remaining arguments are treated like 108.Xr echo 1 . 109This is normally used to take a printer down and let others know why 110.Xr lpq 1 111will indicate the printer is down and print the status message). 112.Pp | 115in the printer status file. 116The message doesn't need to be quoted, the 117remaining arguments are treated like 118.Xr echo 1 . 119This is normally used to take a printer down and let others know why 120.Xr lpq 1 121will indicate the printer is down and print the status message). 122.Pp |
113.It Ic enable No {\ all\ |\ printer\ } | 123.It Ic enable Xo 124.Es \&{ \&} 125.En Cm all | Ar printer 126.Xc |
114Enable spooling on the local queue for the listed printers. 115This will allow 116.Xr lpr 1 117to put new jobs in the spool queue. 118.Pp 119.It Ic exit 120.It Ic quit | 127Enable spooling on the local queue for the listed printers. 128This will allow 129.Xr lpr 1 130to put new jobs in the spool queue. 131.Pp 132.It Ic exit 133.It Ic quit |
121Exit from lpc. 122.\" ne 1i | 134Exit from 135.Nm . |
123.Pp | 136.Pp |
124.It Ic restart No {\ all\ |\ printer\ } | 137.It Ic restart Xo 138.Es \&{ \&} 139.En Cm all | Ar printer 140.Xc |
125Attempt to start a new printer daemon. 126This is useful when some abnormal condition causes the daemon to 127die unexpectedly, leaving jobs in the queue. | 141Attempt to start a new printer daemon. 142This is useful when some abnormal condition causes the daemon to 143die unexpectedly, leaving jobs in the queue. |
128.Xr Lpq 1 | 144.Xr lpq 1 |
129will report that there is no daemon present when this condition occurs. 130If the user is the super-user, 131try to abort the current daemon first (i.e., kill and restart a stuck daemon). 132.Pp | 145will report that there is no daemon present when this condition occurs. 146If the user is the super-user, 147try to abort the current daemon first (i.e., kill and restart a stuck daemon). 148.Pp |
133.It Ic start No {\ all\ |\ printer\ } | 149.It Ic start Xo 150.Es \&{ \&} 151.En Cm all | Ar printer 152.Xc |
134Enable printing and start a spooling daemon for the listed printers. 135.Pp | 153Enable printing and start a spooling daemon for the listed printers. 154.Pp |
136.It Ic status No {\ all\ |\ printer\ } | 155.It Ic status Xo 156.Es \&{ \&} 157.En Cm all | Ar printer 158.Xc |
137Display the status of daemons and queues on the local machine. 138.Pp | 159Display the status of daemons and queues on the local machine. 160.Pp |
139.It Ic stop No {\ all\ |\ printer\ } | 161.It Ic stop Xo 162.Es \&{ \&} 163.En Cm all | Ar printer 164.Xc |
140Stop a spooling daemon after the current job completes and disable 141printing. 142.Pp | 165Stop a spooling daemon after the current job completes and disable 166printing. 167.Pp |
143.It Ic topq No printer\ [\ jobnum\ ...\ ]\ [\ user\ ...\ ] | 168.It Ic topq Ar printer Xo 169.Op Ar jobnum ... 170.Op Ar user ... 171.Xc |
144Place the jobs in the order listed at the top of the printer queue. 145.Pp | 172Place the jobs in the order listed at the top of the printer queue. 173.Pp |
146.It Ic up No {\ all\ |\ printer\ } | 174.It Ic up Xo 175.Es \&{ \&} 176.En Cm all | Ar printer 177.Xc |
147Enable everything and start a new printer daemon. 148Undoes the effects of 149.Ic down . 150.El 151.Sh FILES 152.Bl -tag -width /var/spool/*/lockx -compact 153.It Pa /etc/printcap 154printer description file --- 4 unchanged lines hidden (view full) --- 159.El 160.Sh SEE ALSO 161.Xr lpq 1 , 162.Xr lpr 1 , 163.Xr lprm 1 , 164.Xr printcap 5 , 165.Xr lpd 8 166.Sh DIAGNOSTICS | 178Enable everything and start a new printer daemon. 179Undoes the effects of 180.Ic down . 181.El 182.Sh FILES 183.Bl -tag -width /var/spool/*/lockx -compact 184.It Pa /etc/printcap 185printer description file --- 4 unchanged lines hidden (view full) --- 190.El 191.Sh SEE ALSO 192.Xr lpq 1 , 193.Xr lpr 1 , 194.Xr lprm 1 , 195.Xr printcap 5 , 196.Xr lpd 8 197.Sh DIAGNOSTICS |
167.Bl -tag -width Ds | 198.Bl -tag -width indent |
168.It Sy "?Ambiguous command" 169abbreviation matches more than one command 170.It Sy "?Invalid command" 171no match was found 172.It Sy "?Privileged command" 173you must be a member of group "operator" or root to execute this command 174.El 175.Sh HISTORY 176The 177.Nm 178command appeared in 179.Bx 4.2 . | 199.It Sy "?Ambiguous command" 200abbreviation matches more than one command 201.It Sy "?Invalid command" 202no match was found 203.It Sy "?Privileged command" 204you must be a member of group "operator" or root to execute this command 205.El 206.Sh HISTORY 207The 208.Nm 209command appeared in 210.Bx 4.2 . |