projects / thirdparty / cups.git / blame
| Commit | Line | Data |
|---|---|---|
| c277f98c | 1 | <!DOCTYPE HTML> |
| 94436c5a MS |
2 | <html> |
| 3 | <!-- SECTION: Man Pages --> | |
| 4 | <head> | |
| 5 | <link rel="stylesheet" type="text/css" href="../cups-printable.css"> | |
| 6 | <title>cups-lpd(8)</title> | |
| 7 | </head> | |
| 8 | <body> | |
| 9 | <h1 class="title">cups-lpd(8)</h1> | |
| 10 | <h2 class="title"><a name="NAME">Name</a></h2> | |
| 11 | cups-lpd - receive print jobs and report printer status to lpd clients | |
| 12 | <h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2> | |
| c277f98c MS |
13 | <b>cups-lpd</b> |
| 14 | [ -h | |
| 15 | <i>hostname[:port]</i> | |
| 16 | ] [ -n ] [ -o | |
| 17 | <i>option=value</i> | |
| 18 | ] | |
| 94436c5a MS |
19 | <h2 class="title"><a name="DESCRIPTION">Description</a></h2> |
| 20 | <i>cups-lpd</i> is the CUPS Line Printer Daemon ("LPD") | |
| 21 | mini-server that supports legacy client systems that use the LPD | |
| 22 | protocol. <i>cups-lpd</i> does not act as a standalone network | |
| 23 | daemon but instead operates using the Internet "super-server" | |
| 24 | <i>inetd(8)</i> or <i>xinetd(8)</i>. If you are using <i>inetd</i>, | |
| 25 | add the following line to the <i>inetd.conf</i> file to enable the | |
| 26 | <i>cups-lpd</i> mini-server: | |
| 27 | <br> | |
| 28 | <pre> | |
| 29 | ||
| ffa2ca90 | 30 | printer stream tcp nowait lp /usr/lib/cups/daemon/cups-lpd cups-lpd \ |
| 94436c5a MS |
31 | -o document-format=application/octet-stream |
| 32 | </pre> | |
| 33 | <p><p><b>Note:</b> If you are using Solaris 10 or higher, you must run | |
| 34 | the <i>inetdconv(1m)</i> program to register the changes to the | |
| 35 | inetd.conf file. | |
| 36 | <p>If you are using the newer <i>xinetd(8)</i> daemon, create a file | |
| 37 | named <i>/etc/xinetd.d/cups</i> containing the following lines: | |
| 38 | <br> | |
| 39 | <pre> | |
| 40 | ||
| 41 | service printer | |
| 42 | { | |
| 43 | socket_type = stream | |
| 44 | protocol = tcp | |
| 45 | wait = no | |
| 46 | user = lp | |
| 47 | group = sys | |
| 48 | passenv = | |
| ffa2ca90 | 49 | server = /usr/lib/cups/daemon/cups-lpd |
| 94436c5a MS |
50 | server_args = -o document-format=application/octet-stream |
| 51 | } | |
| 52 | </pre> | |
| 53 | <h2 class="title"><a name="OPTIONS">Options</a></h2> | |
| c277f98c MS |
54 | <p style="margin-left: 5.0em; text-indent: -5.0em">-h hostname[:port] |
| 55 | <br> | |
| 56 | <br> | |
| 57 | Sets the CUPS server (and port) to use. | |
| 58 | <p style="margin-left: 5.0em; text-indent: -5.0em">-n | |
| 59 | <br> | |
| 60 | <br> | |
| 61 | Disables reverse address lookups; normally <i>cups-lpd</i> will | |
| 94436c5a MS |
62 | try to discover the hostname of the client via a reverse DNS |
| 63 | lookup. | |
| c277f98c MS |
64 | <p style="margin-left: 5.0em; text-indent: -5.0em">-o name=value |
| 65 | <br> | |
| 66 | <br> | |
| 67 | Inserts options for all print queues. Most often this is used to | |
| 94436c5a MS |
68 | disable the "l" filter so that remote print jobs are filtered as |
| 69 | needed for printing; the examples in the previous section set the | |
| 70 | "document-format" option to "application/octet-stream" which | |
| 71 | forces autodetection of the print file format. | |
| 94436c5a MS |
72 | <h2 class="title"><a name="PERFORMANCE">Performance</a></h2> |
| 73 | <i>cups-lpd</i> performs well with small numbers of clients and | |
| 74 | printers. However, since a new process is created for each | |
| 75 | connection and since each process must query the printing system | |
| 76 | before each job submission, it does not scale to larger | |
| 77 | configurations. We highly recommend that large configurations | |
| 78 | use the native IPP support provided by CUPS instead. | |
| 79 | <h2 class="title"><a name="SECURITY">Security</a></h2> | |
| 80 | <i>cups-lpd</i> currently does not perform any access control | |
| c277f98c | 81 | based on the settings in <i>cupsd.conf(5)</i> or in the |
| 94436c5a MS |
82 | <i>hosts.allow(5)</i> or <i>hosts.deny(5)</i> files used by TCP |
| 83 | wrappers. Therefore, running <i>cups-lpd</i> on your server will | |
| 84 | allow any computer on your network (and perhaps the entire | |
| 85 | Internet) to print to your server. | |
| 86 | <p>While <i>xinetd</i> has built-in access control support, you | |
| 87 | should use the TCP wrappers package with <i>inetd</i> to limit | |
| 88 | access to only those computers that should be able to print | |
| 89 | through your server. | |
| 90 | <p><i>cups-lpd</i> is not enabled by the standard CUPS distribution. | |
| 91 | Please consult with your operating system vendor to determine | |
| 92 | whether it is enabled on your system. | |
| 93 | <h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2> | |
| 94 | <i>cups-lpd</i> does not enforce the restricted source port | |
| 95 | number specified in RFC 1179, as using restricted ports does not | |
| 96 | prevent users from submitting print jobs. While this behavior is | |
| 97 | different than standard Berkeley LPD implementations, it should | |
| 98 | not affect normal client operations. | |
| 99 | <p>The output of the status requests follows RFC 2569, Mapping | |
| 100 | between LPD and IPP Protocols. Since many LPD implementations | |
| 101 | stray from this definition, remote status reporting to LPD | |
| 102 | clients may be unreliable. | |
| 103 | <h2 class="title"><a name="SEE_ALSO">See Also</a></h2> | |
| c277f98c | 104 | <i>cups(1)</i>, <i>cupsd(8)</i>, <i>inetconv(1m)</i>, |
| 94436c5a MS |
105 | <i>inetd(8)</i>, <i>xinetd(8)</i>, |
| 106 | <br> | |
| c277f98c | 107 | <a href="http://localhost:631/help">http://localhost:631/help</a> |
| 94436c5a MS |
108 | <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2> |
| 109 | Copyright 2007-2013 by Apple Inc. | |
| 110 | ||
| 111 | </body> | |
| 112 | </html> |