]>
Commit | Line | Data |
---|---|---|
ef416fc2 | 1 | .\" |
2 | .\" "$Id: cups-lpd.man 4867 2005-12-03 15:45:53Z mike $" | |
3 | .\" | |
4 | .\" cups-lpd man page for the Common UNIX Printing System (CUPS). | |
5 | .\" | |
6 | .\" Copyright 1997-2005 by Easy Software Products. | |
7 | .\" | |
8 | .\" These coded instructions, statements, and computer programs are the | |
9 | .\" property of Easy Software Products and are protected by Federal | |
10 | .\" copyright law. Distribution and use rights are outlined in the file | |
11 | .\" "LICENSE.txt" which should have been included with this file. If this | |
12 | .\" file is missing or damaged please contact Easy Software Products | |
13 | .\" at: | |
14 | .\" | |
15 | .\" Attn: CUPS Licensing Information | |
16 | .\" Easy Software Products | |
17 | .\" 44141 Airport View Drive, Suite 204 | |
18 | .\" Hollywood, Maryland 20636 USA | |
19 | .\" | |
20 | .\" Voice: (301) 373-9600 | |
21 | .\" EMail: cups-info@cups.org | |
22 | .\" WWW: http://www.cups.org | |
23 | .\" | |
24 | .TH cups-lpd 8 "Common UNIX Printing System" "3 December 2005" "Easy Software Products" | |
25 | .SH NAME | |
26 | cups-lpd \- receive print jobs and report printer status to lpd clients | |
27 | .SH SYNOPSIS | |
28 | .B cups-lpd | |
29 | [ -o | |
30 | .I option=value | |
31 | ] | |
32 | .SH DESCRIPTION | |
33 | \fBcups-lpd\fR is the CUPS Line Printer Daemon ("LPD") mini-server that | |
34 | supports legacy client systems that use the LPD protocol. | |
35 | \fBcups-lpd\fR does not act as a standalone network daemon but instead | |
36 | operates using the Internet "super-server" \fBinetd(8)\fR. Add the | |
37 | following line to the \fBinetd.conf\fR file to enable the | |
38 | \fBcups-lpd\fR daemon: | |
39 | .br | |
40 | .nf | |
41 | ||
42 | printer stream tcp nowait lp /path/to/cups/daemon/cups-lpd cups-lpd \\ | |
43 | -o document-format=application/octet-stream | |
44 | .fi | |
45 | .LP | |
46 | If you are using the newer \fIxinetd(8)\fR daemon, add the following | |
47 | lines to the \fBxinetd.conf\fR file: | |
48 | .br | |
49 | .nf | |
50 | ||
51 | service printer | |
52 | { | |
53 | socket_type = stream | |
54 | protocol = tcp | |
55 | wait = no | |
56 | user = lp | |
57 | group = sys | |
58 | passenv = | |
59 | server = /path/to/cups/daemon/cups-lpd | |
60 | server_args = -o document-format=application/octet-stream | |
61 | } | |
62 | .fi | |
63 | .LP | |
64 | The /path/to/cups/daemon is usually /usr/lib/cups/daemon or | |
65 | /usr/libexec/cups/daemon, depending on the operating system. | |
66 | Consult the cupsd.conf file for the local setting. | |
67 | .SH OPTIONS | |
68 | The \fI-o\fR option to \fBcups-lpd\fR inserts options for all | |
69 | print queues. Most often this is used to disable the "l" filter | |
70 | so that remote print jobs are filtered as needed for printing; | |
71 | the examples in the previous section set the "document-format" | |
72 | option to "application/octet-stream" which forces autodetection | |
73 | of the print file format. | |
74 | .SH PERFORMANCE | |
75 | \fBcups-lpd\fR performs well with small numbers of clients and | |
76 | printers. However, since a new process is created for each | |
77 | connection and since each process must query the printing system | |
78 | before each job submission, it does not scale to larger | |
79 | configurations. We highly recommend that large configurations | |
80 | use the native IPP support provided by CUPS instead. | |
81 | .SH SECURITY | |
82 | \fBcups-lpd\fR currently does not perform any access control | |
83 | based on the settings in \fIcupsd.conf(5)\fR or in the | |
84 | \fIhosts.allow(5)\fR or \fIhosts.deny\fR files used by TCP | |
85 | wrappers. Therefore, running \fBcups-lpd\fR on your server will | |
86 | allow any computer on your network (and perhaps the entire | |
87 | Internet) to print to your server. | |
88 | .LP | |
89 | While \fIxinetd\fR has built-in access control support, you | |
90 | should use the TCP wrappers package with \fIinetd\fR to limit | |
91 | access to only those computers that should be able to print | |
92 | through your server. | |
93 | .LP | |
94 | \fBcups-lpd\fR is not enabled by the standard CUPS distribution. | |
95 | Please consult with your operating system vendor to determine | |
96 | whether it is enabled in their distribution. | |
97 | .SH COMPATIBILITY | |
98 | \fBcups-lpd\fR does not enforce the restricted source port | |
99 | number specified in RFC 1179, as using restricted ports does not | |
100 | prevent users from submitting print jobs. While this behavior is | |
101 | different than standard Berkeley LPD implementations, it should | |
102 | not affect normal client operations. | |
103 | .LP | |
104 | The output of the status requests follows RFC 2569, Mapping | |
105 | between LPD and IPP Protocols. Since many LPD implementations | |
106 | stray from this definition, remote status reporting to LPD | |
107 | clients may be unreliable. | |
108 | .SH SEE ALSO | |
109 | cups(1), cupsd(8), inetd(8), xinetd(8) | |
110 | .SH COPYRIGHT | |
111 | Copyright 1993-2005 by Easy Software Products, All Rights Reserved. | |
112 | .\" | |
113 | .\" End of "$Id: cups-lpd.man 4867 2005-12-03 15:45:53Z mike $". | |
114 | .\" |