]> git.ipfire.org Git - thirdparty/cups.git/blob - man/cups-lpd.man
Copyright update.
[thirdparty/cups.git] / man / cups-lpd.man
1 .\"
2 .\" "$Id: cups-lpd.man,v 1.5.2.4 2003/01/07 18:27:05 mike Exp $"
3 .\"
4 .\" cups-lpd man page for the Common UNIX Printing System (CUPS).
5 .\"
6 .\" Copyright 1997-2003 by Easy Software Products.
7 .\"
8 .\" These coded instructions, statements, and computer programs are the
9 .\" property of Easy Software Products and are protected by Federal
10 .\" copyright law. Distribution and use rights are outlined in the file
11 .\" "LICENSE.txt" which should have been included with this file. If this
12 .\" file is missing or damaged please contact Easy Software Products
13 .\" at:
14 .\"
15 .\" Attn: CUPS Licensing Information
16 .\" Easy Software Products
17 .\" 44141 Airport View Drive, Suite 204
18 .\" Hollywood, Maryland 20636-3111 USA
19 .\"
20 .\" Voice: (301) 373-9603
21 .\" EMail: cups-info@cups.org
22 .\" WWW: http://www.cups.org
23 .\"
24 .TH cups-lpd 8 "Common UNIX Printing System" "4 March 2002" "Easy Software Products"
25 .SH NAME
26 cups-lpd \- receive print jobs and report printer status to lpd clients
27 .SH SYNOPSIS
28 .B cups-lpd
29 [ -o
30 .I option=value
31 ]
32 .SH DESCRIPTION
33 \fBcups-lpd\fR is the CUPS Line Printer Daemon ("LPD") mini-server that
34 supports legacy client systems that use the LPD protocol.
35 \fBcups-lpd\fR does not act as a standalone network daemon but instead
36 operates using the Internet "super-server" \fBinetd(8)\fR. Add the
37 following line to the \fBinetd.conf\fR file to enable the
38 \fBcups-lpd\fR daemon:
39 .br
40 .nf
41
42 printer stream tcp nowait lp /usr/lib/cups/daemon/cups-lpd cups-lpd
43 .fi
44 .LP
45 If you are using the newer \fIxinetd(8)\fR daemon, add the following
46 lines to the \fBxinetd.conf\fR file:
47 .br
48 .nf
49
50 service printer
51 {
52 socket_type = stream
53 protocol = tcp
54 wait = no
55 user = lp
56 server = /usr/lib/cups/daemon/cups-lpd
57 }
58 .fi
59 .SH SECURITY
60 \fBcups-lpd\fR currently does not perform any access control
61 based on the settings in \fIcupsd.conf(5)\fR or in the
62 \fIhosts.allow(5)\fR or \fIhosts.deny\fR files used by TCP
63 wrappers. Therefore, running \fBcups-lpd\fR on your server will
64 allow any computer on your network (and perhaps the entire
65 Internet) to print to your server.
66 .LP
67 While \fIxinetd\fR has built-in access control support, you
68 should use the TCP wrappers package with \fIinetd\fR to limit
69 access to only those computers that should be able to print
70 through your server.
71 .SH OPTIONS
72 The \fI-o\fR option to \fBcups-lpd\fR inserts options for all print queues.
73 Most often this is used to disable the "l" filter so that remote print jobs
74 are filtered as needed for printing:
75 .br
76 .nf
77
78 printer stream tcp nowait lp /usr/lib/cups/daemon/cups-lpd cups-lpd \
79 -o document-format=application/octet-stream
80
81 server = /usr/lib/cups/daemon/cups-lpd
82 server_args = -o document-format=application/octet-stream
83 .fi
84 .LP
85 The example shown resets the document format to be
86 \fIapplication/octet-stream\fR, which forces auto-detection of the print
87 file type.
88 .SH COMPATIBILITY
89 \fBcups-lpd\fR does not enforce the restricted source port
90 number specified in RFC 1179, as using restricted ports does not
91 prevent determined users from submitting print jobs. While this
92 behavior is different than standard Berkeley LPD
93 implementations, it should not affect normal client operations.
94 .LP
95 The output of the status requests follows RFC 2569, Mapping
96 between LPD and IPP Protocols. Since many LPD implementations
97 stray from this definition, remote status reporting to LPD
98 clients may be unreliable.
99 .SH SEE ALSO
100 inetd(8), xinetd(8),
101 CUPS Software Administrators Manual,
102 http://localhost:631/documentation.html
103 .SH COPYRIGHT
104 Copyright 1993-2003 by Easy Software Products, All Rights Reserved.
105 .\"
106 .\" End of "$Id: cups-lpd.man,v 1.5.2.4 2003/01/07 18:27:05 mike Exp $".
107 .\"