man/cups-lpd.man.in

   1 .\"
   2 .\" "$Id: cups-lpd.man.in 7835 2008-08-09 06:37:04Z mike $"
   3 .\"
   4 .\"   cups-lpd man page for the Common UNIX Printing System (CUPS).
   5 .\"
   6 .\"   Copyright 2007-2008 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" "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 by Apple Inc.
 122 .\"
 123 .\" End of "$Id: cups-lpd.man.in 7835 2008-08-09 06:37:04Z mike $".
 124 .\"