man/cups-lpd.man.in

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