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