]>
Commit | Line | Data |
---|---|---|
8032d749 | 1 | .\" |
b2e10895 | 2 | .\" "$Id$" |
8032d749 | 3 | .\" |
5b9bc2e0 | 4 | .\" cups-lpd man page for CUPS. |
8032d749 | 5 | .\" |
dc0f86cb | 6 | .\" Copyright 2007-2013 by Apple Inc. |
766ef83d | 7 | .\" Copyright 1997-2006 by Easy Software Products. |
8032d749 | 8 | .\" |
9 | .\" These coded instructions, statements, and computer programs are the | |
4e8d321f | 10 | .\" property of Apple Inc. and are protected by Federal copyright |
11 | .\" law. Distribution and use rights are outlined in the file "LICENSE.txt" | |
12 | .\" which should have been included with this file. If this file is | |
13 | .\" file is missing or damaged, see the license at "http://www.cups.org/". | |
8032d749 | 14 | .\" |
86de9054 | 15 | .TH cups-lpd 8 "CUPS" "4 August 2008" "Apple Inc." |
8032d749 | 16 | .SH NAME |
17 | cups-lpd \- receive print jobs and report printer status to lpd clients | |
18 | .SH SYNOPSIS | |
19 | .B cups-lpd | |
8062c49f | 20 | [ -h |
21 | .I hostname[:port] | |
22 | ] [ -n ] [ -o | |
c6a97407 | 23 | .I option=value |
24 | ] | |
8032d749 | 25 | .SH DESCRIPTION |
766ef83d | 26 | \fIcups-lpd\fR is the CUPS Line Printer Daemon ("LPD") |
27 | mini-server that supports legacy client systems that use the LPD | |
28 | protocol. \fIcups-lpd\fR does not act as a standalone network | |
29 | daemon but instead operates using the Internet "super-server" | |
30 | \fIinetd(8)\fR or \fIxinetd(8)\fR. If you are using \fIinetd\fR, | |
31 | add the following line to the \fIinetd.conf\fR file to enable the | |
32 | \fIcups-lpd\fR mini-server: | |
8032d749 | 33 | .br |
34 | .nf | |
35 | ||
766ef83d | 36 | printer stream tcp nowait lp @CUPS_SERVERBIN@/daemon/cups-lpd cups-lpd \\ |
125ef8b3 | 37 | -o document-format=application/octet-stream |
8032d749 | 38 | .fi |
db09e458 | 39 | .LP |
e479e53c | 40 | .LP |
41 | \fBNote:\fR If you are using Solaris 10 or higher, you must run | |
42 | the \fIinetdconv(1m)\fR program to register the changes to the | |
43 | inetd.conf file. | |
44 | .LP | |
766ef83d | 45 | If you are using the newer \fIxinetd(8)\fR daemon, create a file |
46 | named \fI/etc/xinetd.d/cups\fR containing the following lines: | |
db09e458 | 47 | .br |
48 | .nf | |
49 | ||
c6a97407 | 50 | service printer |
51 | { | |
52 | socket_type = stream | |
53 | protocol = tcp | |
54 | wait = no | |
55 | user = lp | |
46d749d8 | 56 | group = sys |
57 | passenv = | |
766ef83d | 58 | server = @CUPS_SERVERBIN@/daemon/cups-lpd |
46d749d8 | 59 | server_args = -o document-format=application/octet-stream |
c6a97407 | 60 | } |
db09e458 | 61 | .fi |
c6a97407 | 62 | .SH OPTIONS |
766ef83d | 63 | .TP 5 |
0904f2c7 | 64 | -h hostname[:port] |
8062c49f | 65 | .br |
66 | Sets the CUPS server (and port) to use. | |
67 | .TP 5 | |
5afa2430 | 68 | -n |
69 | .br | |
70 | Disables reverse address lookups; normally \fIcups-lpd\fR will | |
71 | try to discover the hostname of the client via a reverse DNS | |
72 | lookup. | |
73 | .TP 5 | |
766ef83d | 74 | -o name=value |
75 | .br | |
76 | Inserts options for all print queues. Most often this is used to | |
77 | disable the "l" filter so that remote print jobs are filtered as | |
78 | needed for printing; the examples in the previous section set the | |
79 | "document-format" option to "application/octet-stream" which | |
80 | forces autodetection of the print file format. | |
46d749d8 | 81 | .SH PERFORMANCE |
766ef83d | 82 | \fIcups-lpd\fR performs well with small numbers of clients and |
46d749d8 | 83 | printers. However, since a new process is created for each |
84 | connection and since each process must query the printing system | |
85 | before each job submission, it does not scale to larger | |
86 | configurations. We highly recommend that large configurations | |
87 | use the native IPP support provided by CUPS instead. | |
88 | .SH SECURITY | |
766ef83d | 89 | \fIcups-lpd\fR currently does not perform any access control |
46d749d8 | 90 | based on the settings in \fIcupsd.conf(5)\fR or in the |
766ef83d | 91 | \fIhosts.allow(5)\fR or \fIhosts.deny(5)\fR files used by TCP |
92 | wrappers. Therefore, running \fIcups-lpd\fR on your server will | |
46d749d8 | 93 | allow any computer on your network (and perhaps the entire |
94 | Internet) to print to your server. | |
95 | .LP | |
96 | While \fIxinetd\fR has built-in access control support, you | |
97 | should use the TCP wrappers package with \fIinetd\fR to limit | |
98 | access to only those computers that should be able to print | |
99 | through your server. | |
100 | .LP | |
766ef83d | 101 | \fIcups-lpd\fR is not enabled by the standard CUPS distribution. |
46d749d8 | 102 | Please consult with your operating system vendor to determine |
766ef83d | 103 | whether it is enabled on your system. |
8032d749 | 104 | .SH COMPATIBILITY |
766ef83d | 105 | \fIcups-lpd\fR does not enforce the restricted source port |
db09e458 | 106 | number specified in RFC 1179, as using restricted ports does not |
46d749d8 | 107 | prevent users from submitting print jobs. While this behavior is |
108 | different than standard Berkeley LPD implementations, it should | |
109 | not affect normal client operations. | |
8032d749 | 110 | .LP |
db09e458 | 111 | The output of the status requests follows RFC 2569, Mapping |
112 | between LPD and IPP Protocols. Since many LPD implementations | |
113 | stray from this definition, remote status reporting to LPD | |
114 | clients may be unreliable. | |
8032d749 | 115 | .SH SEE ALSO |
e479e53c | 116 | \fIcups(1)\fR, \fIcupsd(8)\fR, \fIinetconv(1m)\fR, |
117 | \fIinetd(8)\fR, \fIxinetd(8)\fR, | |
766ef83d | 118 | .br |
119 | http://localhost:631/help | |
8032d749 | 120 | .SH COPYRIGHT |
dc0f86cb | 121 | Copyright 2007-2013 by Apple Inc. |
8032d749 | 122 | .\" |
b2e10895 | 123 | .\" End of "$Id$". |
8032d749 | 124 | .\" |