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 July 16, 2002 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 45The 46.Nm 47utility is used by the system administrator to control the 48operation of the line printer system. 49For each line printer configured in 50.Pa /etc/printcap , 51.Nm 52may be used to: 53.Bl -bullet -offset indent 54.It 55disable or enable a printer, 56.It 57disable or enable a printer's spooling queue, 58.It 59rearrange the order of jobs in a spooling queue, 60.It 61find the status of printers, and their associated 62spooling queues and printer daemons, 63.It 64change the status message for printer queues (the status message 65may be seen by users as part of the output of the 66.Xr lpq 1 67utility). 68.El 69.Pp 70Without any arguments, 71.Nm 72will prompt for commands from the standard input. 73If arguments are supplied, 74.Nm 75interprets the first argument as a command and the remaining 76arguments as parameters to the command. 77The standard input 78may be redirected causing 79.Nm 80to read commands from file. 81Commands may be abbreviated; 82the following is the list of recognized commands. 83.Pp 84.Bl -tag -width indent -compact 85.It Ic \&? Op Ar command ... 86.It Ic help Op Ar command ... 87Print a short description of each command specified in the argument list, 88or, if no argument is given, a list of the recognized commands. 89.Pp 90.It Ic abort Brq Cm all | Ar printer 91Terminate an active spooling daemon on the local host immediately and 92then disable printing (preventing new daemons from being started by 93.Xr lpr 1 ) 94for the specified printers. 95.Pp 96.It Ic bottomq Ar printer Op Ar jobspec ... 97Take the specified jobs in the order specified and move them to the 98bottom of the printer queue. 99Each 100.Ar jobspec 101can match multiple print jobs. 102The full description of a 103.Ar jobspec 104is given below. 105.Pp 106.It Ic clean Brq Cm all | Ar printer 107Remove any temporary files, data files, and control files that cannot 108be printed (i.e., do not form a complete printer job) 109from the specified printer queue(s) on the local machine. 110This command will also look for 111.Pa core 112files in spool directory 113for each printer queue, and list any that are found. 114It will not remove any 115.Pa core 116files. 117See also the 118.Ic tclean 119command. 120.Pp 121.It Ic disable Brq Cm all | Ar printer 122Turn the specified printer queues off. 123This prevents new 124printer jobs from being entered into the queue by 125.Xr lpr 1 . 126.Pp 127.It Ic down Bro Cm all | Ar printer ... Brc Cm -msg Ar message ... 128.It Ic down Bro Cm all | Ar printer Brc Ar message ... 129Turn the specified printer queue off, disable printing and put 130.Ar message 131in the printer status file. 132When specifying more than one printer queue, the 133.Ic -msg 134argument is required to separate the list of printers from the text 135that will be the new status message. 136The message doesn't need to be quoted, the 137remaining arguments are treated like 138.Xr echo 1 . 139This is normally used to take a printer down, and let other users 140find out why it is down (the 141.Xr lpq 1 142utility will indicate that the printer is down and will print the 143status message). 144.Pp 145.It Ic enable Brq Cm all | Ar printer 146Enable spooling on the local queue for the listed printers. 147This will allow 148.Xr lpr 1 149to put new jobs in the spool queue. 150.Pp 151.It Ic exit 152.It Ic quit 153Exit from 154.Nm . 155.Pp 156.It Ic restart Brq Cm all | Ar printer 157Attempt to start a new printer daemon. 158This is useful when some abnormal condition causes the daemon to 159die unexpectedly, leaving jobs in the queue. 160.Xr lpq 1 161will report that there is no daemon present when this condition occurs. 162If the user is the super-user, 163try to abort the current daemon first (i.e., kill and restart a stuck daemon). 164.Pp 165.It Ic setstatus Bro Cm all | Ar printer Brc Cm -msg Ar message ... 166Set the status message for the specified printers. 167The 168.Ic -msg 169argument is required to separate the list of printers from the text 170that will be the new status message. 171This is normally used to change the status message when the printer 172queue is no longer active after printing has been disabled, and you 173want to change what users will see in the output of the 174.Xr lpq 1 utility. 175.Pp 176.It Ic start Brq Cm all | Ar printer 177Enable printing and start a spooling daemon for the listed printers. 178.Pp 179.It Ic status Brq Cm all | Ar printer 180Display the status of daemons and queues on the local machine. 181.Pp 182.It Ic stop Brq Cm all | Ar printer 183Stop a spooling daemon after the current job completes and disable 184printing. 185.Pp 186.It Ic tclean Brq Cm all | Ar printer 187This will do a test-run of the 188.Ic clean 189command. 190All the same checking is done, but the command will only print out 191messages saying what a similar 192.Ic clean 193command would do if the user typed it in. 194It will not remove any files. 195Note that the 196.Ic clean 197command is a privileged command, while the 198.Ic tclean 199command is not restricted. 200.Pp 201.It Ic topq Ar printer Op Ar jobspec ... 202Take the specified jobs in the order specified and move them to the 203top of the printer queue. 204Each 205.Ar jobspec 206can match multiple print jobs. 207The full description of a 208.Ar jobspec 209is given below. 210.Pp 211.It Ic up Brq Cm all | Ar printer 212Enable everything and start a new printer daemon. 213Undoes the effects of 214.Ic down . 215.El 216.Pp 217Commands such as 218.Ic topq 219and 220.Ic bottomq 221can take one or more 222.Ar jobspec 223to specify which jobs the command should operate on. 224A 225.Ar jobspec 226can be: 227.Bl -bullet 228.It 229a single job number, which will match all jobs in the printer's queue 230which have the same job number. 231Eg: 232.Ar 17 , 233.It 234a range of job numbers, which will match all jobs with a number between 235the starting and ending job numbers, inclusive. 236Eg: 237.Ar 21-32 , 238.It 239a specific userid, which will match all jobs which were sent by that 240user. 241Eg: 242.Ar jones , 243.It 244a host name, when prefixed by an `@', which will match all jobs in 245the queue which were sent from the given host. 246Eg: 247.Ar @freebsd.org , 248.It 249a job range and a userid, separated by a `:', which will match all jobs 250which both match the job range and were sent by the specified user. 251Eg: 252.Ar jones:17 253or 254.Ar 21-32:jones , 255.It 256a job range and/or a userid, followed by a host name, which will match 257all jobs which match all the specified criteria. 258Eg: 259.Ar jones@freebsd.org 260or 261.Ar 21-32@freebsd.org 262or 263.Ar jones:17@freebsd.org . 264.El 265.Pp 266The values for userid and host name can also include pattern-matching 267characters, similar to the pattern matching done for filenames in 268most command shells. 269Note that if you enter a 270.Ic topq 271or 272.Ic bottomq 273command as parameters on the initial 274.Nm 275command, then the shell will expand any pattern-matching characters 276that it can (based on what files in finds in the current directory) 277before 278.Nm 279processes the command. 280In that case, any parameters which include pattern-matching characters 281should be enclosed in quotes, so that the shell will not try to 282expand them. 283.Sh FILES 284.Bl -tag -width /var/spool/*/lockx -compact 285.It Pa /etc/printcap 286printer description file 287.It Pa /var/spool/* 288spool directories 289.It Pa /var/spool/*/lock 290lock file for queue control 291.El 292.Sh SEE ALSO 293.Xr lpq 1 , 294.Xr lpr 1 , 295.Xr lprm 1 , 296.Xr printcap 5 , 297.Xr chkprintcap 8 , 298.Xr lpd 8 299.Sh DIAGNOSTICS 300.Bl -diag 301.It "?Ambiguous command" 302abbreviation matches more than one command 303.It "?Invalid command" 304no match was found 305.It "?Privileged command" 306you must be a member of group "operator" or root to execute this command 307.El 308.Sh HISTORY 309The 310.Nm 311utility appeared in 312.Bx 4.2 . 313