Annotation of 43BSDReno/share/doc/smm/06.lpd/2.t, 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
                      5: .\" provided that the above copyright notice and this paragraph are
                      6: .\" duplicated in all such forms and that any documentation,
                      7: .\" advertising materials, and other materials related to such
                      8: .\" distribution and use acknowledge that the software was developed
                      9: .\" by the University of California, Berkeley.  The name of the
                     10: .\" University may not be used to endorse or promote products derived
                     11: .\" from this software without specific prior written permission.
                     12: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
                     13: .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
                     14: .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     15: .\"
                     16: .\"    @(#)2.t 6.4 (Berkeley) 3/7/89
                     17: .\"
                     18: .NH 1
                     19: Commands
                     20: .NH 2
                     21: lpd \- line printer daemon
                     22: .PP
                     23: The program
                     24: .IR lpd (8),
                     25: usually invoked at boot time from the /etc/rc file, acts as
                     26: a master server for coordinating and controlling
                     27: the spooling queues configured in the printcap file.
                     28: When
                     29: .I lpd
                     30: is started it makes a single pass through the
                     31: .I printcap
                     32: database restarting any printers that have jobs.
                     33: In normal operation
                     34: .I lpd
                     35: listens for service requests on multiple sockets,
                     36: one in the UNIX domain (named ``/dev/printer'') for
                     37: local requests, and one in the Internet domain
                     38: (under the ``printer'' service specification)
                     39: for requests for printer access from off machine;
                     40: see \fIsocket\fP\|(2) and \fIservices\fP\|(5)
                     41: for more information on sockets and service
                     42: specifications, respectively.
                     43: .I Lpd
                     44: spawns a copy of itself to process the request; the master daemon
                     45: continues to listen for new requests.
                     46: .PP
                     47: Clients communicate with 
                     48: .I lpd
                     49: using a simple transaction oriented protocol.
                     50: Authentication of remote clients is done based
                     51: on the ``privilege port'' scheme employed by
                     52: \fIrshd\fP\|(8C) and \fIrcmd\fP\|(3X).
                     53: The following table shows the requests 
                     54: understood by
                     55: .IR lpd .
                     56: In each request the first byte indicates the
                     57: ``meaning'' of the request, followed by the name
                     58: of the printer to which it should be applied.  Additional
                     59: qualifiers may follow, depending on the request.
                     60: .DS
                     61: .TS
                     62: l l.
                     63: Request        Interpretation
                     64: _
                     65: ^Aprinter\en   check the queue for jobs and print any found
                     66: ^Bprinter\en   receive and queue a job from another machine
                     67: ^Cprinter [users ...] [jobs ...]\en    return short list of current queue state
                     68: ^Dprinter [users ...] [jobs ...]\en    return long list of current queue state
                     69: ^Eprinter person [users ...] [jobs ...]\en     remove jobs from a queue
                     70: .TE
                     71: .DE
                     72: .PP
                     73: The \fIlpr\fP\|(1) command
                     74: is used by users to enter a print job in a local queue and to notify
                     75: the local
                     76: .I lpd
                     77: that there are new jobs in the spooling area.
                     78: .I Lpd
                     79: either schedules the job to be printed locally, or if
                     80: printing remotely, attempts to forward
                     81: the job to the appropriate machine.
                     82: If the printer cannot be opened or the destination
                     83: machine is unreachable, the job will remain queued until it is
                     84: possible to complete the work.
                     85: .NH 2
                     86: lpq \- show line printer queue
                     87: .PP
                     88: The \fIlpq\fP\|(1)
                     89: program works recursively backwards displaying the queue of the machine with
                     90: the printer and then the queue(s) of the machine(s) that lead to it.
                     91: .I Lpq
                     92: has two forms of output: in the default, short, format it
                     93: gives a single line of output per queued job; in the long 
                     94: format it shows the list of files, and their sizes, that
                     95: comprise a job.
                     96: .NH 2
                     97: lprm \- remove jobs from a queue
                     98: .PP
                     99: The \fIlprm\fP\|(1) command deletes jobs from a spooling
                    100: queue.  If necessary, \fIlprm\fP will first kill off a
                    101: running daemon that is servicing the queue and restart
                    102: it after the required files are removed.  When removing
                    103: jobs destined for a remote printer, \fIlprm\fP acts
                    104: similarly to \fIlpq\fP except it first checks locally
                    105: for jobs to remove and then
                    106: tries to remove files in queues off-machine.
                    107: .NH 2
                    108: lpc \- line printer control program
                    109: .PP
                    110: The
                    111: .IR lpc (8)
                    112: program is used by the system administrator to control the
                    113: operation of the line printer system.  
                    114: For each line printer configured in /etc/printcap,
                    115: .I lpc
                    116: may be used to:
                    117: .IP \(bu
                    118: disable or enable a printer,
                    119: .IP \(bu
                    120: disable or enable a printer's spooling queue,
                    121: .IP \(bu
                    122: rearrange the order of jobs in a spooling queue,
                    123: .IP \(bu
                    124: find the status of printers, and their associated
                    125: spooling queues and printer daemons.

unix.superglobalmegacorp.com

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