usr/src/man/man1m/in.lpd.1m

   1 '\" te
   2 .\" Copyright (C) 2004, Sun Microsystems, Inc. All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH IN.LPD 1M "Feb 25, 2017"
   7 .SH NAME
   8 in.lpd \- BSD print protocol adaptor
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/lib/print/in.lpd\fR
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .LP
  17 \fBin.lpd\fR implements the network listening service for the \fBBSD\fR print
  18 protocol specified in \fBRFC\fR 1179. The \fBBSD\fR print protocol provides a
  19 remote interface for systems to interact with a local spooling system. The
  20 protocol defines five standard requests from the client to the server: starting
  21 queue processing, transferring print jobs, retrieving terse status, retrieving
  22 verbose status, and canceling print jobs.
  23 .sp
  24 .LP
  25 The \fBin.lpd\fR service is managed by the service management facility,
  26 \fBsmf\fR(5), under the service identifier:
  27 .sp
  28 .in +2
  29 .nf
  30 svc:/network/lp
  31 .fi
  32 .in -2
  33 .sp
  34
  35 .sp
  36 .LP
  37 Administrative actions on this service, such as enabling, disabling, or
  38 requesting restart, can be performed using \fBsvcadm\fR(1M). Responsibility for
  39 initiating and restarting this service is delegated to \fBinetd\fR(1M). Use
  40 \fBinetadm\fR(1M) to make configuration changes and to view configuration
  41 information for this service. The service's status can be queried using the
  42 \fBsvcs\fR(1) command.
  43 .sp
  44 .LP
  45 \fBin.lpd\fR uses the \fBconfig/log_from_remote\fR property to allow or
  46 disallow remote access. The default value of this property, \fBlocalhost\fR,
  47 disallows remote access.
  48 .sp
  49 .LP
  50 \fBinetd\fR waits for connections on \fBTCP\fR port 515. Upon receipt of a
  51 connect request, \fBin.lpd\fR is started to service the connection. Once the
  52 request has been filled, \fBin.lpd\fR closes the connection and exits.
  53 .SH EXAMPLES
  54 .LP
  55 \fBExample 1 \fRAllowing Remote Access
  56 .sp
  57 .LP
  58 The following command allows remote access to \fBin.lpd\fR.
  59
  60 .sp
  61 .in +2
  62 .nf
  63 # \fBinetadm -m svc:/application/print/rfc1179:default bind_addr=""\fR
  64 .fi
  65 .in -2
  66 .sp
  67
  68 .SH EXIT STATUS
  69 .LP
  70 The following exit values are returned:
  71 .sp
  72 .ne 2
  73 .na
  74 \fB\fB0\fR\fR
  75 .ad
  76 .RS 12n
  77 Successful completion.
  78 .RE
  79
  80 .sp
  81 .ne 2
  82 .na
  83 \fBnon-zero\fR
  84 .ad
  85 .RS 12n
  86 An error occurred.
  87 .RE
  88
  89 .SH FILES
  90 .ne 2
  91 .na
  92 \fB\fB/etc/printers.conf\fR\fR
  93 .ad
  94 .sp .6
  95 .RS 4n
  96 System printer configuration database.
  97 .RE
  98
  99 .sp
 100 .ne 2
 101 .na
 102 \fB\fBprinters.conf.byname\fR\fR
 103 .ad
 104 .sp .6
 105 .RS 4n
 106 \fBNIS\fR version of \fB/etc/printers.conf\fR.
 107 .RE
 108
 109 .sp
 110 .ne 2
 111 .na
 112 \fB\fB/usr/lib/print/bsd-adaptor/bsd_*.so*\fR\fR
 113 .ad
 114 .sp .6
 115 .RS 4n
 116 Spooler translation modules.
 117 .RE
 118
 119 .SH SEE ALSO
 120 .LP
 121 \fBsvcs\fR(1), \fBinetadm\fR(1M), \fBinetd\fR(1M), \fBsvcadm\fR(1M),
 122 \fBprinters.conf\fR(4), \fBattributes\fR(5), \fBsmf\fR(5)