man pages section 1M: System Administration Commands

Exit Print View

Updated: July 2014

cups-lpd (1m)


cups-lpd - receive print jobs and report printer status to lpd clients


cups-lpd [ -h hostname[:port] ] [ -n ] [ -o option=value ]


Apple Inc.                                            cups-lpd(8)

     cups-lpd  -  receive print jobs and report printer status to
     lpd clients

     cups-lpd [ -h hostname[:port] ] [ -n ] [ -o option=value ]

     cups-lpd is the CUPS Line Printer Daemon ("LPD") mini-server
     that  supports legacy client systems that use the LPD proto-
     col. cups-lpd does not act as a  standalone  network  daemon
     but  instead  operates  using  the  Internet  "super-server"
     inetd(8) or xinetd(8). If you are using inetd, add the  fol-
     lowing  line  to  the inetd.conf file to enable the cups-lpd

         printer stream tcp nowait lp /usr/lib/cups/daemon/cups-lpd cups-lpd \
             -o document-format=application/octet-stream

     Note: If you are using Solaris 10 or higher,  you  must  run
     the  inetdconv(1m)  program  to  register the changes to the
     inetd.conf file.

     If you are using the newer xinetd(8) daemon, create  a  file
     named /etc/xinetd.d/cups containing the following lines:

         service printer
             socket_type = stream
             protocol = tcp
             wait = no
             user = lp
          group = sys
          passenv =
             server = /usr/lib/cups/daemon/cups-lpd
          server_args = -o document-format=application/octet-stream

     -h hostname[:port]
          Sets the CUPS server (and port) to use.

          Disables  reverse  address  lookups;  normally cups-lpd
          will try to discover the hostname of the client  via  a
          reverse DNS lookup.

     -o name=value
          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 examples
          in  the  previous  section  set  the  "document-format"

4 August 2008           Last change: CUPS                       1

Apple Inc.                                            cups-lpd(8)

          option   to   "application/octet-stream"  which  forces
          autodetection of the print file format.

     cups-lpd performs well with small  numbers  of  clients  and
     printers.  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. We highly recommend that  large  con-
     figurations  use  the  native  IPP  support provided by CUPS

     cups-lpd currently does not perform any access control based
     on the settings in cupsd.conf(5) or in the hosts.allow(5) or
     hosts.deny(5) files used by TCP wrappers. Therefore, running
     cups-lpd on your server will allow any computer on your net-
     work (and perhaps the entire  Internet)  to  print  to  your

     While xinetd has built-in access control support, you should
     use the TCP wrappers package with inetd to limit  access  to
     only  those  computers  that should be able to print through
     your server.

     cups-lpd is not enabled by the standard  CUPS  distribution.
     Please  consult  with your operating system vendor to deter-
     mine whether it is enabled on your system.

     cups-lpd does not enforce the restricted source port  number
     specified  in  RFC  1179, as using restricted ports does not
     prevent users from submitting print jobs. While this  behav-
     ior is different than standard Berkeley LPD implementations,
     it should not affect normal client operations.

     The output of the status requests follows RFC 2569,  Mapping
     between  LPD  and  IPP Protocols. Since many LPD implementa-
     tions stray from this definition, remote status reporting to
     LPD clients may be unreliable.

     See   attributes(5)   for   descriptions  of  the  following

4 August 2008           Last change: CUPS                       2

Apple Inc.                                            cups-lpd(8)

     |Availability   | print/cups       |
     |Stability      | Volatile         |
     cups(1), cupsd(8), inetconv(1m), inetd(8), xinetd(8),

     Copyright 2007-2009 by Apple Inc.

     This  software  was   built   from   source   available   at    The  original
     community       source       was       downloaded       from

     Further information about this software can be found on  the
     open source community website at

4 August 2008           Last change: CUPS                       3