[thirdparty/cups.git] / doc / help / man-cups-lpd.html

<!DOCTYPE HTML>
<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 (deprecated)
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>cups-lpd</b>
[
<b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
] [
<b>-n</b>
] [
<b>-o</b>
<i>option=value</i>
]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<b>cups-lpd</b>
is the CUPS Line Printer Daemon ("LPD") mini-server that supports legacy client systems that use the LPD protocol.
<b>cups-lpd</b>
does not act as a standalone network daemon but instead operates using any of the Internet "super-servers" such as
<b>inetd</b>(8),
<b>launchd</b>(8),
and
<b>systemd</b>(8).
<h2 class="title"><a name="OPTIONS">Options</a></h2>
<dl class="man">
<dt><b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
<dd style="margin-left: 5.0em">Sets the CUPS server (and port) to use.
<dt><b>-n</b>
<dd style="margin-left: 5.0em">Disables reverse address lookups; normally
<b>cups-lpd</b>
will try to discover the hostname of the client via a reverse DNS lookup.
<dt><b>-o </b><i>name=value</i>
<dd style="margin-left: 5.0em">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
<b>inetd</b>(8)
example below sets the "document-format" option to "application/octet-stream" which forces autodetection of the print file format.
</dl>
<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
<b>cups-lpd</b>
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="ERRORS">Errors</a></h2>
Errors are sent to the system log.
<h2 class="title"><a name="FILES">Files</a></h2>
<pre class="man">
<i>/etc/inetd.conf</i>
<i>/etc/xinetd.d/cups-lpd</i>
<i>/System/Library/LaunchDaemons/org.cups.cups-lpd.plist</i>
</pre>
<h2 class="title"><a name="NOTES">Notes</a></h2>
The
<b>cups-lpd</b>
program is deprecated and will no longer be supported in a future feature release of CUPS.
<h3><a name="PERFORMANCE">Performance</a></h3>
<b>cups-lpd</b>
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.
<h3><a name="SECURITY">Security</a></h3>
<b>cups-lpd</b>
currently does not perform any access control based on the settings in <i>cupsd.conf(5)</i> or in the <i>hosts.allow(5)</i> or <i>hosts.deny(5)</i> files used by TCP wrappers.
Therefore, running
<b>cups-lpd</b>
on your server will allow any computer on your network (and perhaps the entire
Internet) to print to your server.
<p>While
<b>xinetd</b>(8)
has built-in access control support, you should use the TCP wrappers package with
<b>inetd</b>(8)
to limit access to only those computers that should be able to print through your server.
<p><b>cups-lpd</b>
is not enabled by the standard CUPS distribution.
Please consult with your operating system vendor to determine whether it is enabled by default on your system.
<h2 class="title"><a name="EXAMPLE">Example</a></h2>
If you are using
<b>inetd</b>(8),
add the following line to the <i>inetd.conf</i> file to enable the
<b>cups-lpd</b>
mini-server:
<pre class="man">

    printer stream tcp nowait lp /usr/lib/cups/daemon/cups-lpd cups-lpd \
        -o document-format=application/octet-stream

</pre>
<p><i>Note:</i> If you are using Solaris 10 or higher, you must run the
<b>inetdconv</b>(1m)
program to register the changes to the <i>inetd.conf</i> file.
<p>CUPS includes configuration files for
<b>launchd</b>(8),
<b>systemd</b>(8),
and
<b>xinetd</b>(8).
Simply enable the
<b>cups-lpd</b>
service using the corresponding control program.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<b>cups</b>(1),
<b>cupsd</b>(8),
<b>inetconv</b>(1m),
<b>inetd</b>(8),
<b>launchd</b>(8),
<b>xinetd</b>(8),
CUPS Online Help (<a href="http://localhost:631/help)">http://localhost:631/help)</a>,
RFC 2569
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright &copy; 2007-2019 by Apple Inc.

</body>
</html>
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>
87030afb	11	cups-lpd - receive print jobs and report printer status to lpd clients (deprecated)
94436c5a	12	<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
c277f98c	13	<b>cups-lpd</b>
e94cac03 MS	14	[
	15	<b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
	16	] [
	17	<b>-n</b>
	18	] [
	19	<b>-o</b>
c277f98c MS	20	<i>option=value</i>
c277f98c MS	21	]
94436c5a	22	<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
e94cac03 MS	23	<b>cups-lpd</b>
	24	is the CUPS Line Printer Daemon ("LPD") mini-server that supports legacy client systems that use the LPD protocol.
	25	<b>cups-lpd</b>
	26	does not act as a standalone network daemon but instead operates using any of the Internet "super-servers" such as
	27	<b>inetd</b>(8),
	28	<b>launchd</b>(8),
	29	and
	30	<b>systemd</b>(8).
	31	<h2 class="title"><a name="OPTIONS">Options</a></h2>
	32	<dl class="man">
	33	<dt><b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
	34	<dd style="margin-left: 5.0em">Sets the CUPS server (and port) to use.
	35	<dt><b>-n</b>
	36	<dd style="margin-left: 5.0em">Disables reverse address lookups; normally
	37	<b>cups-lpd</b>
	38	will try to discover the hostname of the client via a reverse DNS lookup.
	39	<dt><b>-o </b><i>name=value</i>
	40	<dd style="margin-left: 5.0em">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
	41	<b>inetd</b>(8)
	42	example below sets the "document-format" option to "application/octet-stream" which forces autodetection of the print file format.
	43	</dl>
	44	<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
	45	<b>cups-lpd</b>
	46	does not enforce the restricted source port number specified in RFC 1179, as using restricted ports does not prevent users from submitting print jobs.
	47	While this behavior is different than standard Berkeley LPD implementations, it should not affect normal client operations.
	48	<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.
	49	<h2 class="title"><a name="ERRORS">Errors</a></h2>
	50	Errors are sent to the system log.
	51	<h2 class="title"><a name="FILES">Files</a></h2>
	52	<pre class="man">
	53	<i>/etc/inetd.conf</i>
	54	<i>/etc/xinetd.d/cups-lpd</i>
	55	<i>/System/Library/LaunchDaemons/org.cups.cups-lpd.plist</i>
	56	</pre>
	57	<h2 class="title"><a name="NOTES">Notes</a></h2>
87030afb MS	58	The
	59	<b>cups-lpd</b>
	60	program is deprecated and will no longer be supported in a future feature release of CUPS.
e94cac03 MS	61	<h3><a name="PERFORMANCE">Performance</a></h3>
	62	<b>cups-lpd</b>
	63	performs well with small numbers of clients and printers.
	64	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.
	65	We highly recommend that large configurations use the native IPP support provided by CUPS instead.
	66	<h3><a name="SECURITY">Security</a></h3>
	67	<b>cups-lpd</b>
	68	currently does not perform any access control based on the settings in <i>cupsd.conf(5)</i> or in the <i>hosts.allow(5)</i> or <i>hosts.deny(5)</i> files used by TCP wrappers.
	69	Therefore, running
	70	<b>cups-lpd</b>
	71	on your server will allow any computer on your network (and perhaps the entire
	72	Internet) to print to your server.
	73	<p>While
	74	<b>xinetd</b>(8)
	75	has built-in access control support, you should use the TCP wrappers package with
	76	<b>inetd</b>(8)
	77	to limit access to only those computers that should be able to print through your server.
	78	<p><b>cups-lpd</b>
	79	is not enabled by the standard CUPS distribution.
	80	Please consult with your operating system vendor to determine whether it is enabled by default on your system.
	81	<h2 class="title"><a name="EXAMPLE">Example</a></h2>
	82	If you are using
	83	<b>inetd</b>(8),
94436c5a	84	add the following line to the <i>inetd.conf</i> file to enable the
e94cac03 MS	85	<b>cups-lpd</b>
e94cac03 MS	86	mini-server:
2909c66c	87	<pre class="man">
94436c5a	88
ffa2ca90	89	printer stream tcp nowait lp /usr/lib/cups/daemon/cups-lpd cups-lpd \
94436c5a	90	-o document-format=application/octet-stream
94436c5a	91
94436c5a	92	</pre>
e94cac03 MS	93	<p><i>Note:</i> If you are using Solaris 10 or higher, you must run the
	94	<b>inetdconv</b>(1m)
	95	program to register the changes to the <i>inetd.conf</i> file.
	96	<p>CUPS includes configuration files for
	97	<b>launchd</b>(8),
	98	<b>systemd</b>(8),
	99	and
47eb8d30	100	<b>xinetd</b>(8).
e94cac03 MS	101	Simply enable the
	102	<b>cups-lpd</b>
	103	service using the corresponding control program.
94436c5a	104	<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
87030afb MS	105	<b>cups</b>(1),
87030afb MS	106	<b>cupsd</b>(8),
e94cac03 MS	107	<b>inetconv</b>(1m),
	108	<b>inetd</b>(8),
	109	<b>launchd</b>(8),
	110	<b>xinetd</b>(8),
	111	CUPS Online Help (<a href="http://localhost:631/help)">http://localhost:631/help)</a>,
	112	RFC 2569
94436c5a	113	<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
87030afb	114	Copyright © 2007-2019 by Apple Inc.
94436c5a MS	115
	116	</body>
	117	</html>