Annotation of 43BSDReno/usr.sbin/lpr/lpc/lpc.8, revision 1.1.1.1

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

unix.superglobalmegacorp.com

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