]> git.ipfire.org Git - thirdparty/cups.git/blobdiff - doc/help/man-cups-lpd.html
Add HTML man pages.
[thirdparty/cups.git] / doc / help / man-cups-lpd.html
diff --git a/doc/help/man-cups-lpd.html b/doc/help/man-cups-lpd.html
new file mode 100644 (file)
index 0000000..fc89160
--- /dev/null
@@ -0,0 +1,117 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<!-- SECTION: Man Pages -->
+<head>
+       <link rel="stylesheet" type="text/css" href="../cups-printable.css">
+       <title>cups-lpd(8)</title>
+</head>
+<body>
+<h1 class="title">cups-lpd(8)</h1>
+<h2 class="title"><a name="NAME">Name</a></h2>
+cups-lpd - receive print jobs and report printer status to lpd clients
+<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
+<b>cups-lpd
+</b>[ -h
+<i>hostname[:port]
+</i>] [ -n ] [ -o
+<i>option=value
+</i>]
+<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
+<i>cups-lpd</i> is the CUPS Line Printer Daemon ("LPD")
+mini-server that supports legacy client systems that use the LPD
+protocol. <i>cups-lpd</i> does not act as a standalone network
+daemon but instead operates using the Internet "super-server"
+<i>inetd(8)</i> or <i>xinetd(8)</i>. If you are using <i>inetd</i>,
+add the following line to the <i>inetd.conf</i> file to enable the
+<i>cups-lpd</i> mini-server:
+<br>
+<pre>
+
+    printer stream tcp nowait lp /usr/lib/cups/daemon/cups-lpd cups-lpd \
+        -o document-format=application/octet-stream
+</pre>
+<p><p><b>Note:</b> If you are using Solaris 10 or higher, you must run
+the <i>inetdconv(1m)</i> program to register the changes to the
+inetd.conf file.
+<p>If you are using the newer <i>xinetd(8)</i> daemon, create a file
+named <i>/etc/xinetd.d/cups</i> containing the following lines:
+<br>
+<pre>
+
+    service printer
+    {
+        socket_type = stream
+        protocol = tcp
+        wait = no
+        user = lp
+       group = sys
+       passenv =
+        server = /usr/lib/cups/daemon/cups-lpd
+       server_args = -o document-format=application/octet-stream
+    }
+</pre>
+<h2 class="title"><a name="OPTIONS">Options</a></h2>
+<dl>
+<dt>-h hostname[:port]
+</dt>
+<dd></dd>
+<dd>Sets the CUPS server (and port) to use.
+</dd>
+<dt>-n
+</dt>
+<dd></dd>
+<dd>Disables reverse address lookups; normally <i>cups-lpd</i> will
+try to discover the hostname of the client via a reverse DNS
+lookup.
+</dd>
+<dt>-o name=value
+</dt>
+<dd></dd>
+<dd>Inserts options for all print queues. Most often this is used to
+disable the "l" filter so that remote print jobs are filtered as
+needed for printing; the examples in the previous section set the
+"document-format" option to "application/octet-stream" which
+forces autodetection of the print file format.
+</dd>
+</dl>
+<h2 class="title"><a name="PERFORMANCE">Performance</a></h2>
+<i>cups-lpd</i> performs well with small numbers of clients and
+printers. However, since a new process is created for each
+connection and since each process must query the printing system
+before each job submission, it does not scale to larger
+configurations. We highly recommend that large configurations
+use the native IPP support provided by CUPS instead.
+<h2 class="title"><a name="SECURITY">Security</a></h2>
+<i>cups-lpd</i> currently does not perform any access control
+based on the settings in <a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a> or in the
+<i>hosts.allow(5)</i> or <i>hosts.deny(5)</i> files used by TCP
+wrappers. Therefore, running <i>cups-lpd</i> on your server will
+allow any computer on your network (and perhaps the entire
+Internet) to print to your server.
+<p>While <i>xinetd</i> has built-in access control support, you
+should use the TCP wrappers package with <i>inetd</i> to limit
+access to only those computers that should be able to print
+through your server.
+<p><i>cups-lpd</i> is not enabled by the standard CUPS distribution.
+Please consult with your operating system vendor to determine
+whether it is enabled on your system.
+<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
+<i>cups-lpd</i> does not enforce the restricted source port
+number specified in RFC 1179, as using restricted ports does not
+prevent users from submitting print jobs. While this behavior is
+different than standard Berkeley LPD implementations, it should
+not affect normal client operations.
+<p>The output of the status requests follows RFC 2569, Mapping
+between LPD and IPP Protocols. Since many LPD implementations
+stray from this definition, remote status reporting to LPD
+clients may be unreliable.
+<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
+<i>cups(1)</i>, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>, <i>inetconv(1m)</i>,
+<i>inetd(8)</i>, <i>xinetd(8)</i>,
+<br>
+<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
+Copyright 2007-2013 by Apple Inc.
+
+</body>
+</html>