man/cups-lpd.man.in

   1 .\"
   2 .\" "$Id$"
   3 .\"
   4 .\" cups-lpd man page for CUPS.
   5 .\"
   6 .\" Copyright 2007-2014 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" "3 June 2014" "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 [
  21 \fB\-h \fIhostname\fR[\fB:\fIport\fR]
  22 ] [
  23 .B -n
  24 ] [
  25 .B -o
  26 .I option=value
  27 ]
  28 .SH DESCRIPTION
  29 .B cups-lpd
  30 is the CUPS Line Printer Daemon ("LPD") mini-server that supports legacy client systems that use the LPD protocol.
  31 .B cups-lpd
  32 does not act as a standalone network daemon but instead operates using any of the Internet "super-servers" such as
  33 .BR inetd (8),
  34 .BR launchd (8),
  35 and
  36 .BR systemd (8).
  37 .SH OPTIONS
  38 .TP 5
  39 \fB-h \fIhostname\fR[\fB:\fIport\fR]
  40 Sets the CUPS server (and port) to use.
  41 .TP 5
  42 .B -n
  43 Disables reverse address lookups; normally
  44 .B cups-lpd
  45 will try to discover the hostname of the client via a reverse DNS lookup.
  46 .TP 5
  47 \fB-o \fIname=value\fR
  48 Inserts options for all print queues. Most often this is used to disable the "l" filter so that remote print jobs are filtered as needed for printing; the
  49 .BR inetd (8)
  50 example below sets the "document-format" option to "application/octet-stream" which forces autodetection of the print file format.
  51 .SH CONFORMING TO
  52 .B cups-lpd
  53 does not enforce the restricted source port number specified in RFC 1179, as using restricted ports does not prevent users from submitting print jobs.
  54 While this behavior is different than standard Berkeley LPD implementations, it should not affect normal client operations.
  55 .LP
  56 The output of the status requests follows RFC 2569, Mapping between LPD and IPP Protocols. Since many LPD implementations stray from this definition, remote status reporting to LPD clients may be unreliable.
  57 .SH ERRORS
  58 Errors are sent to the system log.
  59 .SH FILES
  60 .nf
  61 .I /etc/inetd.conf
  62 .I /etc/xinetd.d/cups-lpd
  63 .I /System/Library/LaunchDaemons/org.cups.cups-lpd.plist
  64 .fi
  65 .SH NOTES
  66 .SS PERFORMANCE
  67 .B cups-lpd
  68 performs well with small numbers of clients and printers.
  69 However, since a new process is created for each connection and since each process must query the printing system before each job submission, it does not scale to larger configurations.
  70 We highly recommend that large configurations use the native IPP support provided by CUPS instead.
  71 .SS SECURITY
  72 .B cups-lpd
  73 currently does not perform any access control based on the settings in \fIcupsd.conf(5)\fR or in the \fIhosts.allow(5)\fR or \fIhosts.deny(5)\fR files used by TCP wrappers.
  74 Therefore, running
  75 .B cups-lpd
  76 on your server will allow any computer on your network (and perhaps the entire
  77 Internet) to print to your server.
  78 .LP
  79 While
  80 .BR xinetd (8)
  81 has built-in access control support, you should use the TCP wrappers package with
  82 .BR inetd (8)
  83 to limit access to only those computers that should be able to print through your server.
  84 .LP
  85 .B cups-lpd
  86 is not enabled by the standard CUPS distribution.
  87 Please consult with your operating system vendor to determine whether it is enabled by default on your system.
  88 .SH EXAMPLE
  89 If you are using
  90 .BR inetd (8),
  91 add the following line to the \fIinetd.conf\fR file to enable the
  92 .B cups-lpd
  93 mini-server:
  94 .nf
  95
  96     printer stream tcp nowait lp /usr/lib/cups/daemon/cups\-lpd cups\-lpd \\
  97         \-o document\-format=application/octet\-stream
  98
  99 .fi
 100 .LP
 101 \fINote:\fR If you are using Solaris 10 or higher, you must run the
 102 .BR inetdconv (1m)
 103 program to register the changes to the \fIinetd.conf\fR file.
 104 .LP
 105 CUPS includes configuration files for
 106 .BR launchd (8),
 107 .BR systemd (8),
 108 and
 109 .BR xinetd(8).
 110 Simply enable the
 111 .B cups-lpd
 112 service using the corresponding control program.
 113 .SH SEE ALSO
 114 .BR cups (1),
 115 .BR cupsd (8),
 116 .BR inetconv (1m),
 117 .BR inetd (8),
 118 .BR launchd (8),
 119 .BR xinetd (8),
 120 CUPS Online Help (http://localhost:631/help),
 121 RFC 2569
 122 .SH COPYRIGHT
 123 Copyright \[co] 2007-2015 by Apple Inc.
 124 .\"
 125 .\" End of "$Id$".
 126 .\"