[thirdparty/cups.git] / man / cups-lpd.8

.\"
.\" cups-lpd man page for CUPS.
.\"
.\" Copyright © 2007-2019 by Apple Inc.
.\" Copyright © 1997-2006 by Easy Software Products.
.\"
.\" Licensed under Apache License v2.0.  See the file "LICENSE" for more
.\" information.
.\"
.TH cups-lpd 8 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
cups-lpd \- receive print jobs and report printer status to lpd clients (deprecated)
.SH SYNOPSIS
.B cups-lpd
[
\fB\-h \fIhostname\fR[\fB:\fIport\fR]
] [
.B -n
] [
.B -o
.I option=value
]
.SH DESCRIPTION
.B cups-lpd
is the CUPS Line Printer Daemon ("LPD") mini-server that supports legacy client systems that use the LPD protocol.
.B cups-lpd
does not act as a standalone network daemon but instead operates using any of the Internet "super-servers" such as
.BR inetd (8),
.BR launchd (8),
and
.BR systemd (8).
.SH OPTIONS
.TP 5
\fB-h \fIhostname\fR[\fB:\fIport\fR]
Sets the CUPS server (and port) to use.
.TP 5
.B -n
Disables reverse address lookups; normally
.B cups-lpd
will try to discover the hostname of the client via a reverse DNS lookup.
.TP 5
\fB-o \fIname=value\fR
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
.BR inetd (8)
example below sets the "document-format" option to "application/octet-stream" which forces autodetection of the print file format.
.SH CONFORMING TO
.B cups-lpd
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.
.LP
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.
.SH ERRORS
Errors are sent to the system log.
.SH FILES
.nf
.I /etc/inetd.conf
.I /etc/xinetd.d/cups-lpd
.I /System/Library/LaunchDaemons/org.cups.cups-lpd.plist
.fi
.SH NOTES
The
.B cups-lpd
program is deprecated and will no longer be supported in a future feature release of CUPS.
.SS PERFORMANCE
.B cups-lpd
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.
.SS SECURITY
.B cups-lpd
currently does not perform any access control based on the settings in \fIcupsd.conf(5)\fR or in the \fIhosts.allow(5)\fR or \fIhosts.deny(5)\fR files used by TCP wrappers.
Therefore, running
.B cups-lpd
on your server will allow any computer on your network (and perhaps the entire
Internet) to print to your server.
.LP
While
.BR xinetd (8)
has built-in access control support, you should use the TCP wrappers package with
.BR inetd (8)
to limit access to only those computers that should be able to print through your server.
.LP
.B cups-lpd
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.
.SH EXAMPLE
If you are using
.BR inetd (8),
add the following line to the \fIinetd.conf\fR file to enable the
.B cups-lpd
mini-server:
.nf

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

.fi
.LP
\fINote:\fR If you are using Solaris 10 or higher, you must run the
.BR inetdconv (1m)
program to register the changes to the \fIinetd.conf\fR file.
.LP
CUPS includes configuration files for
.BR launchd (8),
.BR systemd (8),
and
.BR xinetd (8).
Simply enable the
.B cups-lpd
service using the corresponding control program.
.SH SEE ALSO
.BR cups (1),
.BR cupsd (8),
.BR inetconv (1m),
.BR inetd (8),
.BR launchd (8),
.BR xinetd (8),
CUPS Online Help (http://localhost:631/help),
RFC 2569
.SH COPYRIGHT
Copyright \[co] 2007-2019 by Apple Inc.
Commit	Line	Data
	1	.\"
	2	.\" cups-lpd man page for CUPS.
	3	.\"
	4	.\" Copyright © 2007-2019 by Apple Inc.
	5	.\" Copyright © 1997-2006 by Easy Software Products.
	6	.\"
	7	.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
	8	.\" information.
	9	.\"
	10	.TH cups-lpd 8 "CUPS" "26 April 2019" "Apple Inc."
	11	.SH NAME
	12	cups-lpd \- receive print jobs and report printer status to lpd clients (deprecated)
	13	.SH SYNOPSIS
	14	.B cups-lpd
	15	[
	16	\fB\-h \fIhostname\fR[\fB:\fIport\fR]
	17	] [
	18	.B -n
	19	] [
	20	.B -o
	21	.I option=value
	22	]
	23	.SH DESCRIPTION
	24	.B cups-lpd
	25	is the CUPS Line Printer Daemon ("LPD") mini-server that supports legacy client systems that use the LPD protocol.
	26	.B cups-lpd
	27	does not act as a standalone network daemon but instead operates using any of the Internet "super-servers" such as
	28	.BR inetd (8),
	29	.BR launchd (8),
	30	and
	31	.BR systemd (8).
	32	.SH OPTIONS
	33	.TP 5
	34	\fB-h \fIhostname\fR[\fB:\fIport\fR]
	35	Sets the CUPS server (and port) to use.
	36	.TP 5
	37	.B -n
	38	Disables reverse address lookups; normally
	39	.B cups-lpd
	40	will try to discover the hostname of the client via a reverse DNS lookup.
	41	.TP 5
	42	\fB-o \fIname=value\fR
	43	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
	44	.BR inetd (8)
	45	example below sets the "document-format" option to "application/octet-stream" which forces autodetection of the print file format.
	46	.SH CONFORMING TO
	47	.B cups-lpd
	48	does not enforce the restricted source port number specified in RFC 1179, as using restricted ports does not prevent users from submitting print jobs.
	49	While this behavior is different than standard Berkeley LPD implementations, it should not affect normal client operations.
	50	.LP
	51	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.
	52	.SH ERRORS
	53	Errors are sent to the system log.
	54	.SH FILES
	55	.nf
	56	.I /etc/inetd.conf
	57	.I /etc/xinetd.d/cups-lpd
	58	.I /System/Library/LaunchDaemons/org.cups.cups-lpd.plist
	59	.fi
	60	.SH NOTES
	61	The
	62	.B cups-lpd
	63	program is deprecated and will no longer be supported in a future feature release of CUPS.
	64	.SS PERFORMANCE
	65	.B cups-lpd
	66	performs well with small numbers of clients and printers.
	67	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.
	68	We highly recommend that large configurations use the native IPP support provided by CUPS instead.
	69	.SS SECURITY
	70	.B cups-lpd
	71	currently does not perform any access control based on the settings in \fIcupsd.conf(5)\fR or in the \fIhosts.allow(5)\fR or \fIhosts.deny(5)\fR files used by TCP wrappers.
	72	Therefore, running
	73	.B cups-lpd
	74	on your server will allow any computer on your network (and perhaps the entire
	75	Internet) to print to your server.
	76	.LP
	77	While
	78	.BR xinetd (8)
	79	has built-in access control support, you should use the TCP wrappers package with
	80	.BR inetd (8)
	81	to limit access to only those computers that should be able to print through your server.
	82	.LP
	83	.B cups-lpd
	84	is not enabled by the standard CUPS distribution.
	85	Please consult with your operating system vendor to determine whether it is enabled by default on your system.
	86	.SH EXAMPLE
	87	If you are using
	88	.BR inetd (8),
	89	add the following line to the \fIinetd.conf\fR file to enable the
	90	.B cups-lpd
	91	mini-server:
	92	.nf
	93
	94	printer stream tcp nowait lp /usr/lib/cups/daemon/cups\-lpd cups\-lpd \\
	95	\-o document\-format=application/octet\-stream
	96
	97	.fi
	98	.LP
	99	\fINote:\fR If you are using Solaris 10 or higher, you must run the
	100	.BR inetdconv (1m)
	101	program to register the changes to the \fIinetd.conf\fR file.
	102	.LP
	103	CUPS includes configuration files for
	104	.BR launchd (8),
	105	.BR systemd (8),
	106	and
	107	.BR xinetd (8).
	108	Simply enable the
	109	.B cups-lpd
	110	service using the corresponding control program.
	111	.SH SEE ALSO
	112	.BR cups (1),
	113	.BR cupsd (8),
	114	.BR inetconv (1m),
	115	.BR inetd (8),
	116	.BR launchd (8),
	117	.BR xinetd (8),
	118	CUPS Online Help (http://localhost:631/help),
	119	RFC 2569
	120	.SH COPYRIGHT
	121	Copyright \[co] 2007-2019 by Apple Inc.