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 "Aug 1, 2006"
   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 .sp
  17 .LP
  18 \fBin.lpd\fR implements the network listening service for the \fBBSD\fR print
  19 protocol specified in \fBRFC\fR 1179. The \fBBSD\fR print protocol provides a
  20 remote interface for systems to interact with a local spooling system. The
  21 protocol defines five standard requests from the client to the server: starting
  22 queue processing, transferring print jobs, retrieving terse status, retrieving
  23 verbose status, and canceling print jobs.
  24 .sp
  25 .LP
  26 The \fBin.lpd\fR service is managed by the service management facility,
  27 \fBsmf\fR(5), under the service identifier:
  28 .sp
  29 .in +2
  30 .nf
  31 svc:/network/lp
  32 .fi
  33 .in -2
  34 .sp
  35
  36 .sp
  37 .LP
  38 Administrative actions on this service, such as enabling, disabling, or
  39 requesting restart, can be performed using \fBsvcadm\fR(1M). Responsibility for
  40 initiating and restarting this service is delegated to \fBinetd\fR(1M). Use
  41 \fBinetadm\fR(1M) to make configuration changes and to view configuration
  42 information for this service. The service's status can be queried using the
  43 \fBsvcs\fR(1) command.
  44 .sp
  45 .LP
  46 \fBin.lpd\fR uses the \fBconfig/log_from_remote\fR property to allow or
  47 disallow remote access. The default value of this property, \fBlocalhost\fR,
  48 disallows remote access.
  49 .sp
  50 .LP
  51 \fBinetd\fR waits for connections on \fBTCP\fR port 515. Upon receipt of a
  52 connect request, \fBin.lpd\fR is started to service the connection. Once the
  53 request has been filled, \fBin.lpd\fR closes the connection and exits.
  54 .SH EXAMPLES
  55 .LP
  56 \fBExample 1 \fRAllowing Remote Access
  57 .sp
  58 .LP
  59 The following command allows remote access to \fBin.lpd\fR.
  60
  61 .sp
  62 .in +2
  63 .nf
  64 # \fBinetadm -m svc:/application/print/rfc1179:default bind_addr=""\fR
  65 .fi
  66 .in -2
  67 .sp
  68
  69 .SH EXIT STATUS
  70 .sp
  71 .LP
  72 The following exit values are returned:
  73 .sp
  74 .ne 2
  75 .na
  76 \fB\fB0\fR\fR
  77 .ad
  78 .RS 12n
  79 Successful completion.
  80 .RE
  81
  82 .sp
  83 .ne 2
  84 .na
  85 \fBnon-zero\fR
  86 .ad
  87 .RS 12n
  88 An error occurred.
  89 .RE
  90
  91 .SH FILES
  92 .sp
  93 .ne 2
  94 .na
  95 \fB\fB/etc/printers.conf\fR\fR
  96 .ad
  97 .sp .6
  98 .RS 4n
  99 System printer configuration database.
 100 .RE
 101
 102 .sp
 103 .ne 2
 104 .na
 105 \fB\fBprinters.conf.byname\fR\fR
 106 .ad
 107 .sp .6
 108 .RS 4n
 109 \fBNIS\fR version of \fB/etc/printers.conf\fR.
 110 .RE
 111
 112 .sp
 113 .ne 2
 114 .na
 115 \fB\fBprinters.org_dir\fR\fR
 116 .ad
 117 .sp .6
 118 .RS 4n
 119 \fBNIS+\fR version of \fB/etc/printers.conf\fR.
 120 .RE
 121
 122 .sp
 123 .ne 2
 124 .na
 125 \fB\fB/usr/lib/print/bsd-adaptor/bsd_*.so*\fR\fR
 126 .ad
 127 .sp .6
 128 .RS 4n
 129 Spooler translation modules.
 130 .RE
 131
 132 .SH SEE ALSO
 133 .sp
 134 .LP
 135 \fBsvcs\fR(1), \fBinetadm\fR(1M), \fBinetd\fR(1M), \fBsvcadm\fR(1M),
 136 \fBprinters.conf\fR(4), \fBattributes\fR(5), \fBsmf\fR(5)