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