man/cups-lpd.man.in

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