Annotation of 43BSDTahoe/man/man8/lpc.8, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)lpc.8       6.1 (Berkeley) 4/27/85
                      6: .\"
                      7: .TH LPC 8 "April 27, 1985"
                      8: .UC 5
                      9: .ad
                     10: .SH NAME
                     11: lpc \- line printer control program
                     12: .SH SYNOPSIS
                     13: .B /etc/lpc
                     14: [ command [ argument ... ] ]
                     15: .SH DESCRIPTION
                     16: .I Lpc
                     17: is used by the system administrator to control the
                     18: operation of the line printer system.  
                     19: For each line printer configured in /etc/printcap,
                     20: .I lpc
                     21: may be used to:
                     22: .IP \(bu
                     23: disable or enable a printer,
                     24: .IP \(bu
                     25: disable or enable a printer's spooling queue,
                     26: .IP \(bu
                     27: rearrange the order of jobs in a spooling queue,
                     28: .IP \(bu
                     29: find the status of printers, and their associated
                     30: spooling queues and printer dameons.
                     31: .PP
                     32: Without any arguments,
                     33: .I lpc
                     34: will prompt for commands from the standard input.
                     35: If arguments are supplied,
                     36: .IR lpc
                     37: interprets the first argument as a command and the remaining
                     38: arguments as parameters to the command.  The standard input
                     39: may be redirected causing
                     40: .I lpc
                     41: to read commands from file.
                     42: Commands may be abreviated;
                     43: the following is the list of recognized commands.
                     44: .TP
                     45: ? [ command ... ]
                     46: .TP
                     47: help [ command ... ]
                     48: .br
                     49: Print a short description of each command specified in the argument list,
                     50: or, if no arguments are given, a list of the recognized commands.
                     51: .TP
                     52: abort { all | printer ... }
                     53: .br
                     54: Terminate an active spooling daemon on the local host immediately and
                     55: then disable printing (preventing new daemons from being started by
                     56: .IR lpr )
                     57: for the specified printers.
                     58: .TP
                     59: clean { all | printer ... }
                     60: .br
                     61: Remove any temporary files, data files, and control files that cannot
                     62: be printed (i.e., do not form a complete printer job)
                     63: from the specified printer queue(s) on the local machine.
                     64: .TP
                     65: disable { all | printer ... }
                     66: .br
                     67: Turn the specified printer queues off.  This prevents new
                     68: printer jobs from being entered into the queue by
                     69: .IR lpr .
                     70: .TP
                     71: down { all | printer } message ...
                     72: .br
                     73: Turn the specified printer queue off, disable printing and put
                     74: .I message
                     75: in the printer status file. The message doesn't need to be quoted, the
                     76: remaining arguments are treated like
                     77: .IR echo (1).
                     78: This is normally used to take a printer down and let others know why
                     79: (lpq will indicate the printer is down and print the status message).
                     80: .TP
                     81: enable { all | printer ... }
                     82: .br
                     83: Enable spooling on the local queue for the listed printers. 
                     84: This will allow
                     85: .I lpr
                     86: to put new jobs in the spool queue.
                     87: .TP
                     88: exit
                     89: .TP
                     90: quit
                     91: .br
                     92: Exit from lpc.
                     93: .TP
                     94: restart { all | printer ... }
                     95: .br
                     96: Attempt to start a new printer daemon. 
                     97: This is useful when some abnormal condition causes the daemon to
                     98: die unexpectedly leaving jobs in the queue.
                     99: .I Lpq
                    100: will report that there is no daemon present when this condition occurs. 
                    101: If the user is the super-user,
                    102: try to abort the current daemon first (i.e., kill and restart a stuck daemon).
                    103: .TP
                    104: start { all | printer ... }
                    105: .br
                    106: Enable printing and start a spooling daemon for the listed printers.
                    107: .TP
                    108: status { all | printer ... }
                    109: Display the status of daemons and queues on the local machine.
                    110: .TP
                    111: stop { all | printer ... }
                    112: .br
                    113: Stop a spooling daemon after the current job completes and disable
                    114: printing.
                    115: .TP
                    116: topq printer [ jobnum ... ] [ user ... ]
                    117: .br
                    118: Place the jobs in the order listed at the top of the printer queue.
                    119: .TP
                    120: up { all | printer ... }
                    121: .br
                    122: Enable everything and start a new printer daemon. Undoes the effects of
                    123: .IR down .
                    124: .SH FILES
                    125: .nf
                    126: .ta \w'/etc/printcap           'u
                    127: /etc/printcap  printer description file
                    128: /usr/spool/*   spool directories
                    129: /usr/spool/*/lock      lock file for queue control
                    130: .fi
                    131: .SH "SEE ALSO"
                    132: lpd(8),
                    133: lpr(1),
                    134: lpq(1),
                    135: lprm(1),
                    136: printcap(5)
                    137: .SH DIAGNOSTICS
                    138: .nf
                    139: .ta \w'?Ambiguous command      'u
                    140: ?Ambiguous command     abreviation matches more than one command
                    141: ?Invalid command       no match was found
                    142: ?Privileged command    command can be executed by root only
                    143: .fi

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.