man/cups-lpd.man

   1 .\"
   2 .\" "$Id: cups-lpd.man,v 1.11 2004/08/11 13:48:15 mike Exp $"
   3 .\"
   4 .\"   cups-lpd man page for the Common UNIX Printing System (CUPS).
   5 .\"
   6 .\"   Copyright 1997-2004 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-3142 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" "11 August 2004" "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 /path/to/cups/daemon/cups-lpd cups-lpd -o document-format=application/octet-stream
  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         group = sys
  57         passenv =
  58         server = /path/to/cups/daemon/cups-lpd
  59         server_args = -o document-format=application/octet-stream
  60     }
  61 .fi
  62 .LP
  63 The /path/to/cups/daemon is usually /usr/lib/cups/daemon or
  64 /usr/libexec/cups/daemon, depending on the operating system.
  65 Consult the cupsd.conf file for the local setting.
  66 .SH OPTIONS
  67 The \fI-o\fR option to \fBcups-lpd\fR inserts options for all print queues.
  68 Most often this is used to disable the "l" filter so that remote print jobs
  69 are filtered as needed for printing:
  70 .br
  71 .nf
  72
  73     printer stream tcp nowait lp /usr/lib/cups/daemon/cups-lpd cups-lpd \
  74         -o document-format=application/octet-stream
  75
  76     server = /usr/lib/cups/daemon/cups-lpd
  77     server_args = -o document-format=application/octet-stream
  78 .fi
  79 .LP
  80 The example shown resets the document format to be
  81 \fIapplication/octet-stream\fR, which forces auto-detection of the print
  82 file type.
  83 .SH PERFORMANCE
  84 \fBcups-lpd\fR performs well with small numbers of clients and
  85 printers. However, since a new process is created for each
  86 connection and since each process must query the printing system
  87 before each job submission, it does not scale to larger
  88 configurations. We highly recommend that large configurations
  89 use the native IPP support provided by CUPS instead.
  90 .SH SECURITY
  91 \fBcups-lpd\fR currently does not perform any access control
  92 based on the settings in \fIcupsd.conf(5)\fR or in the
  93 \fIhosts.allow(5)\fR or \fIhosts.deny\fR files used by TCP
  94 wrappers. Therefore, running \fBcups-lpd\fR on your server will
  95 allow any computer on your network (and perhaps the entire
  96 Internet) to print to your server.
  97 .LP
  98 While \fIxinetd\fR has built-in access control support, you
  99 should use the TCP wrappers package with \fIinetd\fR to limit
 100 access to only those computers that should be able to print
 101 through your server.
 102 .LP
 103 \fBcups-lpd\fR is not enabled by the standard CUPS distribution.
 104 Please consult with your operating system vendor to determine
 105 whether it is enabled in their distributions.
 106 .SH COMPATIBILITY
 107 \fBcups-lpd\fR does not enforce the restricted source port
 108 number specified in RFC 1179, as using restricted ports does not
 109 prevent users from submitting print jobs. While this behavior is
 110 different than standard Berkeley LPD implementations, it should
 111 not affect normal client operations.
 112 .LP
 113 The output of the status requests follows RFC 2569, Mapping
 114 between LPD and IPP Protocols. Since many LPD implementations
 115 stray from this definition, remote status reporting to LPD
 116 clients may be unreliable.
 117 .SH SEE ALSO
 118 cupsd(8), inetd(8), xinetd(8),
 119 CUPS Software Administrators Manual,
 120 http://localhost:631/documentation.html
 121 .SH COPYRIGHT
 122 Copyright 1993-2004 by Easy Software Products, All Rights Reserved.
 123 .\"
 124 .\" End of "$Id: cups-lpd.man,v 1.11 2004/08/11 13:48:15 mike Exp $".
 125 .\"