man/cups-lpd.8

   1 .\"
   2 .\" cups-lpd man page for CUPS.
   3 .\"
   4 .\" Copyright © 2007-2019 by Apple Inc.
   5 .\" Copyright © 1997-2006 by Easy Software Products.
   6 .\"
   7 .\" Licensed under Apache License v2.0.  See the file "LICENSE" for more
   8 .\" information.
   9 .\"
  10 .TH cups-lpd 8 "CUPS" "26 April 2019" "Apple Inc."
  11 .SH NAME
  12 cups-lpd \- receive print jobs and report printer status to lpd clients (deprecated)
  13 .SH SYNOPSIS
  14 .B cups-lpd
  15 [
  16 \fB\-h \fIhostname\fR[\fB:\fIport\fR]
  17 ] [
  18 .B -n
  19 ] [
  20 .B -o
  21 .I option=value
  22 ]
  23 .SH DESCRIPTION
  24 .B cups-lpd
  25 is the CUPS Line Printer Daemon ("LPD") mini-server that supports legacy client systems that use the LPD protocol.
  26 .B cups-lpd
  27 does not act as a standalone network daemon but instead operates using any of the Internet "super-servers" such as
  28 .BR inetd (8),
  29 .BR launchd (8),
  30 and
  31 .BR systemd (8).
  32 .SH OPTIONS
  33 .TP 5
  34 \fB-h \fIhostname\fR[\fB:\fIport\fR]
  35 Sets the CUPS server (and port) to use.
  36 .TP 5
  37 .B -n
  38 Disables reverse address lookups; normally
  39 .B cups-lpd
  40 will try to discover the hostname of the client via a reverse DNS lookup.
  41 .TP 5
  42 \fB-o \fIname=value\fR
  43 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
  44 .BR inetd (8)
  45 example below sets the "document-format" option to "application/octet-stream" which forces autodetection of the print file format.
  46 .SH CONFORMING TO
  47 .B cups-lpd
  48 does not enforce the restricted source port number specified in RFC 1179, as using restricted ports does not prevent users from submitting print jobs.
  49 While this behavior is different than standard Berkeley LPD implementations, it should not affect normal client operations.
  50 .LP
  51 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.
  52 .SH ERRORS
  53 Errors are sent to the system log.
  54 .SH FILES
  55 .nf
  56 .I /etc/inetd.conf
  57 .I /etc/xinetd.d/cups-lpd
  58 .I /System/Library/LaunchDaemons/org.cups.cups-lpd.plist
  59 .fi
  60 .SH NOTES
  61 The
  62 .B cups-lpd
  63 program is deprecated and will no longer be supported in a future feature release of CUPS.
  64 .SS PERFORMANCE
  65 .B cups-lpd
  66 performs well with small numbers of clients and printers.
  67 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.
  68 We highly recommend that large configurations use the native IPP support provided by CUPS instead.
  69 .SS SECURITY
  70 .B cups-lpd
  71 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.
  72 Therefore, running
  73 .B cups-lpd
  74 on your server will allow any computer on your network (and perhaps the entire
  75 Internet) to print to your server.
  76 .LP
  77 While
  78 .BR xinetd (8)
  79 has built-in access control support, you should use the TCP wrappers package with
  80 .BR inetd (8)
  81 to limit access to only those computers that should be able to print through your server.
  82 .LP
  83 .B cups-lpd
  84 is not enabled by the standard CUPS distribution.
  85 Please consult with your operating system vendor to determine whether it is enabled by default on your system.
  86 .SH EXAMPLE
  87 If you are using
  88 .BR inetd (8),
  89 add the following line to the \fIinetd.conf\fR file to enable the
  90 .B cups-lpd
  91 mini-server:
  92 .nf
  93
  94     printer stream tcp nowait lp /usr/lib/cups/daemon/cups\-lpd cups\-lpd \\
  95         \-o document\-format=application/octet\-stream
  96
  97 .fi
  98 .LP
  99 \fINote:\fR If you are using Solaris 10 or higher, you must run the
 100 .BR inetdconv (1m)
 101 program to register the changes to the \fIinetd.conf\fR file.
 102 .LP
 103 CUPS includes configuration files for
 104 .BR launchd (8),
 105 .BR systemd (8),
 106 and
 107 .BR xinetd (8).
 108 Simply enable the
 109 .B cups-lpd
 110 service using the corresponding control program.
 111 .SH SEE ALSO
 112 .BR cups (1),
 113 .BR cupsd (8),
 114 .BR inetconv (1m),
 115 .BR inetd (8),
 116 .BR launchd (8),
 117 .BR xinetd (8),
 118 CUPS Online Help (http://localhost:631/help),
 119 RFC 2569
 120 .SH COPYRIGHT
 121 Copyright \[co] 2007-2019 by Apple Inc.