|
|
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.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.