Return to lpc.8 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.sbin / lpr / lpc

Annotation of 43BSDReno/usr.sbin/lpr/lpc/lpc.8, revision 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

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