~ubuntu-branches/ubuntu/wily/cups/wily

« back to all changes in this revision

Viewing changes to .pc/manpage-hyphen-minus.patch/man/cups-lpd.man.in

  • Committer: Package Import Robot
  • Author(s): Didier Raboud
  • Date: 2013-05-03 11:30:59 UTC
  • mfrom: (100.1.11 experimental)
  • Revision ID: package-import@ubuntu.com-20130503113059-u4vwqd3op51vu7o7
Update the patch adding libusb error handling to also discard its
errors in the counting of warning messages; this should make the
error-suite succeed in more cases.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\"
 
2
.\" "$Id: cups-lpd.man.in 10791 2013-01-10 16:58:21Z mike $"
 
3
.\"
 
4
.\"   cups-lpd man page for CUPS.
 
5
.\"
 
6
.\"   Copyright 2007-2013 by Apple Inc.
 
7
.\"   Copyright 1997-2006 by Easy Software Products.
 
8
.\"
 
9
.\"   These coded instructions, statements, and computer programs are the
 
10
.\"   property of Apple Inc. and are protected by Federal copyright
 
11
.\"   law.  Distribution and use rights are outlined in the file "LICENSE.txt"
 
12
.\"   which should have been included with this file.  If this file is
 
13
.\"   file is missing or damaged, see the license at "http://www.cups.org/".
 
14
.\"
 
15
.TH cups-lpd 8 "CUPS" "4 August 2008" "Apple Inc."
 
16
.SH NAME
 
17
cups-lpd \- receive print jobs and report printer status to lpd clients
 
18
.SH SYNOPSIS
 
19
.B cups-lpd
 
20
[ -h
 
21
.I hostname[:port]
 
22
] [ -n ] [ -o
 
23
.I option=value
 
24
]
 
25
.SH DESCRIPTION
 
26
\fIcups-lpd\fR is the CUPS Line Printer Daemon ("LPD")
 
27
mini-server that supports legacy client systems that use the LPD
 
28
protocol. \fIcups-lpd\fR does not act as a standalone network
 
29
daemon but instead operates using the Internet "super-server"
 
30
\fIinetd(8)\fR or \fIxinetd(8)\fR. If you are using \fIinetd\fR,
 
31
add the following line to the \fIinetd.conf\fR file to enable the
 
32
\fIcups-lpd\fR mini-server:
 
33
.br
 
34
.nf
 
35
 
 
36
    printer stream tcp nowait lp @CUPS_SERVERBIN@/daemon/cups-lpd cups-lpd \\
 
37
        -o document-format=application/octet-stream
 
38
.fi
 
39
.LP
 
40
.LP
 
41
\fBNote:\fR If you are using Solaris 10 or higher, you must run
 
42
the \fIinetdconv(1m)\fR program to register the changes to the
 
43
inetd.conf file.
 
44
.LP
 
45
If you are using the newer \fIxinetd(8)\fR daemon, create a file
 
46
named \fI/etc/xinetd.d/cups\fR containing the following lines:
 
47
.br
 
48
.nf
 
49
 
 
50
    service printer
 
51
    {
 
52
        socket_type = stream
 
53
        protocol = tcp
 
54
        wait = no
 
55
        user = lp
 
56
        group = sys
 
57
        passenv =
 
58
        server = @CUPS_SERVERBIN@/daemon/cups-lpd
 
59
        server_args = -o document-format=application/octet-stream
 
60
    }
 
61
.fi
 
62
.SH OPTIONS
 
63
.TP 5
 
64
-h hostname[:port]
 
65
.br
 
66
Sets the CUPS server (and port) to use.
 
67
.TP 5
 
68
-n
 
69
.br
 
70
Disables reverse address lookups; normally \fIcups-lpd\fR will
 
71
try to discover the hostname of the client via a reverse DNS
 
72
lookup.
 
73
.TP 5
 
74
-o name=value
 
75
.br
 
76
Inserts options for all print queues. Most often this is used to
 
77
disable the "l" filter so that remote print jobs are filtered as
 
78
needed for printing; the examples in the previous section set the
 
79
"document-format" option to "application/octet-stream" which
 
80
forces autodetection of the print file format.
 
81
.SH PERFORMANCE
 
82
\fIcups-lpd\fR performs well with small numbers of clients and
 
83
printers. However, since a new process is created for each
 
84
connection and since each process must query the printing system
 
85
before each job submission, it does not scale to larger
 
86
configurations. We highly recommend that large configurations
 
87
use the native IPP support provided by CUPS instead.
 
88
.SH SECURITY
 
89
\fIcups-lpd\fR currently does not perform any access control
 
90
based on the settings in \fIcupsd.conf(5)\fR or in the
 
91
\fIhosts.allow(5)\fR or \fIhosts.deny(5)\fR files used by TCP
 
92
wrappers. Therefore, running \fIcups-lpd\fR on your server will
 
93
allow any computer on your network (and perhaps the entire
 
94
Internet) to print to your server.
 
95
.LP
 
96
While \fIxinetd\fR has built-in access control support, you
 
97
should use the TCP wrappers package with \fIinetd\fR to limit
 
98
access to only those computers that should be able to print
 
99
through your server.
 
100
.LP
 
101
\fIcups-lpd\fR is not enabled by the standard CUPS distribution.
 
102
Please consult with your operating system vendor to determine
 
103
whether it is enabled on your system.
 
104
.SH COMPATIBILITY
 
105
\fIcups-lpd\fR does not enforce the restricted source port
 
106
number specified in RFC 1179, as using restricted ports does not
 
107
prevent users from submitting print jobs. While this behavior is
 
108
different than standard Berkeley LPD implementations, it should
 
109
not affect normal client operations.
 
110
.LP
 
111
The output of the status requests follows RFC 2569, Mapping
 
112
between LPD and IPP Protocols. Since many LPD implementations
 
113
stray from this definition, remote status reporting to LPD
 
114
clients may be unreliable.
 
115
.SH SEE ALSO
 
116
\fIcups(1)\fR, \fIcupsd(8)\fR, \fIinetconv(1m)\fR,
 
117
\fIinetd(8)\fR, \fIxinetd(8)\fR,
 
118
.br
 
119
http://localhost:631/help
 
120
.SH COPYRIGHT
 
121
Copyright 2007-2013 by Apple Inc.
 
122
.\"
 
123
.\" End of "$Id: cups-lpd.man.in 10791 2013-01-10 16:58:21Z mike $".
 
124
.\"