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