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. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the 11.\" documentation and/or other materials provided with the distribution. 12.\" 3. All advertising materials mentioning features or use of this software 13.\" must display the following acknowledgement: 14.\" This product includes software developed by the University of 15.\" California, Berkeley and its contributors. 16.\" 4. Neither the name of the University nor the names of its contributors 17.\" may be used to endorse or promote products derived from this software 18.\" without specific prior written permission. 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 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$ 34.\" 35.Dd June 20, 2001 36.Dt LPC 8 37.Os 38.Sh NAME 39.Nm lpc 40.Nd line printer control program 41.Sh SYNOPSIS 42.Nm 43.Op Ar command Op Ar argument ... 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: 52.Bl -bullet -offset indent 53.It 54disable or enable a printer, 55.It 56disable or enable a printer's spooling queue, 57.It 58rearrange the order of jobs in a spooling queue, 59.It 60find the status of printers, and their associated 61spooling queues and printer daemons. 62.El 63.Pp 64Without any arguments, 65.Nm 66will prompt for commands from the standard input. 67If arguments are supplied, 68.Nm 69interprets the first argument as a command and the remaining 70arguments as parameters to the command. 71The standard input 72may be redirected causing 73.Nm 74to read commands from file. 75Commands may be abbreviated; 76the following is the list of recognized commands. 77.Pp 78.Bl -tag -width indent -compact 79.It Ic \&? Op Ar command ... 80.It Ic help Op Ar command ... 81Print a short description of each command specified in the argument list, 82or, if no argument is given, a list of the recognized commands. 83.Pp 84.It Ic abort Brq Cm all | Ar printer 85Terminate an active spooling daemon on the local host immediately and 86then disable printing (preventing new daemons from being started by 87.Xr lpr 1 ) 88for the specified printers. 89.Pp 90.It Ic clean Brq Cm all | Ar printer 91Remove any temporary files, data files, and control files that cannot 92be printed (i.e., do not form a complete printer job) 93from the specified printer queue(s) on the local machine. 94This command will also look for 95.Pa core 96files in spool directory 97for each printer queue, and list any that are found. 98It will not remove any 99.Pa core 100files. 101See also the 102.Ic tclean 103command. 104.Pp 105.It Ic disable Brq Cm all | Ar printer 106Turn the specified printer queues off. 107This prevents new 108printer jobs from being entered into the queue by 109.Xr lpr 1 . 110.Pp 111.It Ic down Bro Cm all | Ar printer Brc Ar message ... 112Turn the specified printer queue off, disable printing and put 113.Ar message 114in the printer status file. 115The message doesn't need to be quoted, the 116remaining arguments are treated like 117.Xr echo 1 . 118This is normally used to take a printer down and let others know why 119.Xr lpq 1 120will indicate the printer is down and print the status message). 121.Pp 122.It Ic enable Brq Cm all | Ar printer 123Enable spooling on the local queue for the listed printers. 124This will allow 125.Xr lpr 1 126to put new jobs in the spool queue. 127.Pp 128.It Ic exit 129.It Ic quit 130Exit from 131.Nm . 132.Pp 133.It Ic restart Brq Cm all | Ar printer 134Attempt to start a new printer daemon. 135This is useful when some abnormal condition causes the daemon to 136die unexpectedly, leaving jobs in the queue. 137.Xr lpq 1 138will report that there is no daemon present when this condition occurs. 139If the user is the super-user, 140try to abort the current daemon first (i.e., kill and restart a stuck daemon). 141.Pp 142.It Ic start Brq Cm all | Ar printer 143Enable printing and start a spooling daemon for the listed printers. 144.Pp 145.It Ic status Brq Cm all | Ar printer 146Display the status of daemons and queues on the local machine. 147.Pp 148.It Ic stop Brq Cm all | Ar printer 149Stop a spooling daemon after the current job completes and disable 150printing. 151.Pp 152.It Ic tclean Brq Cm all | Ar printer 153This will do a test-run of the 154.Ic clean 155command. 156All the same checking is done, but the command will only print out 157messages saying what a similar 158.Ic clean 159command would do if the user typed it in. 160It will not remove any files. 161Note that the 162.Ic clean 163command is a privileged command, while the 164.Ic tclean 165command is not restricted. 166.Pp 167.It Ic topq Ar printer Xo 168.Op Ar jobnum ... 169.Op Ar user ... 170.Xc 171Place the jobs in the order listed at the top of the printer queue. 172.Pp 173.It Ic up Brq Cm all | Ar printer 174Enable everything and start a new printer daemon. 175Undoes the effects of 176.Ic down . 177.El 178.Sh FILES 179.Bl -tag -width /var/spool/*/lockx -compact 180.It Pa /etc/printcap 181printer description file 182.It Pa /var/spool/* 183spool directories 184.It Pa /var/spool/*/lock 185lock file for queue control 186.El 187.Sh SEE ALSO 188.Xr lpq 1 , 189.Xr lpr 1 , 190.Xr lprm 1 , 191.Xr printcap 5 , 192.Xr lpd 8 193.Sh DIAGNOSTICS 194.Bl -diag 195.It "?Ambiguous command" 196abbreviation matches more than one command 197.It "?Invalid command" 198no match was found 199.It "?Privileged command" 200you must be a member of group "operator" or root to execute this command 201.El 202.Sh HISTORY 203The 204.Nm 205command appeared in 206.Bx 4.2 . 207