usr.sbin/lpr/SMM.doc/7.t

   1 .\" $NetBSD: 7.t,v 1.3 1997/07/09 02:34:44 jtc Exp $
   2 .\" Copyright (c) 1983, 1993
   3 .\"     The Regents of the University of California.  All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\" 3. Neither the name of the University nor the names of its contributors
  14 .\"    may be used to endorse or promote products derived from this software
  15 .\"    without specific prior written permission.
  16 .\"
  17 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  18 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  19 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  20 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  21 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  22 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  23 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  24 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  25 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  26 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  27 .\" SUCH DAMAGE.
  28 .\"
  29 .\"     @(#)7.t 8.1 (Berkeley) 6/8/93
  30 .\"
  31 .NH 1
  32 Troubleshooting
  33 .PP
  34 There are several messages that may be generated by the
  35 the line printer system.  This section
  36 categorizes the most common and explains the cause
  37 for their generation.  Where the message implies a failure,
  38 directions are given to remedy the problem.
  39 .PP
  40 In the examples below, the name
  41 .I printer
  42 is the name of the printer from the
  43 .I printcap
  44 database.
  45 .NH 2
  46 LPR
  47 .SH
  48 lpr: \fIprinter\fP\|: unknown printer
  49 .IP
  50 The
  51 .I printer
  52 was not found in the
  53 .I printcap
  54 database.  Usually this is a typing mistake; however, it may indicate
  55 a missing or incorrect entry in the /etc/printcap file.
  56 .SH
  57 lpr: \fIprinter\fP\|: jobs queued, but cannot start daemon.
  58 .IP
  59 The connection to
  60 .I lpd
  61 on the local machine failed.
  62 This usually means the printer server started at
  63 boot time has died or is hung.  Check the local socket
  64 /var/run/printer to be sure it still exists (if it does not exist,
  65 there is no
  66 .I lpd
  67 process running).
  68 Usually it is enough to get a super-user to type the following to
  69 restart
  70 .IR lpd .
  71 .DS
  72 % /usr/lib/lpd
  73 .DE
  74 You can also check the state of the master printer daemon with the following.
  75 .DS
  76 % ps l`cat /var/spool/output/lpd.lock`
  77 .DE
  78 .IP
  79 Another possibility is that the
  80 .I lpr
  81 program is not set-user-id to \fIroot\fP, set-group-id to group \fIdaemon\fP.
  82 This can be checked with
  83 .DS
  84 % ls \-lg /usr/bin/lpr
  85 .DE
  86 .SH
  87 lpr: \fIprinter\fP\|: printer queue is disabled
  88 .IP
  89 This means the queue was turned off with
  90 .DS
  91 % lpc disable \fIprinter\fP
  92 .DE
  93 to prevent
  94 .I lpr
  95 from putting files in the queue.  This is normally
  96 done by the system manager when a printer is
  97 going to be down for a long time.  The
  98 printer can be turned back on by a super-user with
  99 .IR lpc .
 100 .NH 2
 101 LPQ
 102 .SH
 103 waiting for \fIprinter\fP to become ready (offline ?)
 104 .IP
 105 The printer device could not be opened by the daemon.
 106 This can happen for several reasons,
 107 the most common is that the printer is turned off-line.
 108 This message can also be generated if the printer is out
 109 of paper, the paper is jammed, etc.
 110 The actual reason is dependent on the meaning
 111 of error codes returned by system device driver.
 112 Not all printers supply enough information
 113 to distinguish when a printer is off-line or having
 114 trouble (e.g. a printer connected through a serial line).
 115 Another possible cause of this message is
 116 some other process, such as an output filter,
 117 has an exclusive open on the device.  Your only recourse
 118 here is to kill off the offending program(s) and
 119 restart the printer with
 120 .IR lpc .
 121 .SH
 122 \fIprinter\fP is ready and printing
 123 .IP
 124 The
 125 .I lpq
 126 program checks to see if a daemon process exists for
 127 .I printer
 128 and prints the file \fIstatus\fP located in the spooling directory.
 129 If the daemon is hung, a super user can use
 130 .I lpc
 131 to abort the current daemon and start a new one.
 132 .SH
 133 waiting for \fIhost\fP to come up
 134 .IP
 135 This implies there is a daemon trying to connect to the remote
 136 machine named
 137 .I host
 138 to send the files in the local queue.
 139 If the remote machine is up,
 140 .I lpd
 141 on the remote machine is probably dead or
 142 hung and should be restarted as mentioned for
 143 .IR lpr .
 144 .SH
 145 sending to \fIhost\fP
 146 .IP
 147 The files should be in the process of being transferred to the remote
 148 .IR host .
 149 If not, the local daemon should be aborted and started with
 150 .IR lpc .
 151 .SH
 152 Warning: \fIprinter\fP is down
 153 .IP
 154 The printer has been marked as being unavailable with
 155 .IR lpc .
 156 .SH
 157 Warning: no daemon present
 158 .IP
 159 The \fIlpd\fP process overseeing
 160 the spooling queue, as specified in the ``lock'' file
 161 in that directory, does not exist.  This normally occurs
 162 only when the daemon has unexpectedly died.
 163 The error log file for the printer and the \fIsyslogd\fP logs
 164 should be checked for a
 165 diagnostic from the deceased process.
 166 To restart an \fIlpd\fP, use
 167 .DS
 168 % lpc restart \fIprinter\fP
 169 .DE
 170 .SH
 171 no space on remote; waiting for queue to drain
 172 .IP
 173 This implies that there is insufficient disk space on the remote.
 174 If the file is large enough, there will never be enough space on
 175 the remote (even after the queue on the remote is empty). The solution here
 176 is to move the spooling queue or make more free space on the remote.
 177 .NH 2
 178 LPRM
 179 .SH
 180 lprm: \fIprinter\fP\|: cannot restart printer daemon
 181 .IP
 182 This case is the same as when
 183 .I lpr
 184 prints that the daemon cannot be started.
 185 .NH 2
 186 LPD
 187 .PP
 188 The
 189 .I lpd
 190 program can log many different messages using \fIsyslogd\fP\|(8).
 191 Most of these messages are about files that can not
 192 be opened and usually imply that the
 193 .I printcap
 194 file or the protection modes of the files are
 195 incorrect.   Files may also be inaccessible if people
 196 manually manipulate the line printer system (i.e. they
 197 bypass the
 198 .I lpr
 199 program).
 200 .PP
 201 In addition to messages generated by
 202 .IR lpd ,
 203 any of the filters that
 204 .I lpd
 205 spawns may log messages using \fIsyslogd\fP or to the error log file
 206 (the file specified in the \fBlf\fP entry in \fIprintcap\fP\|).
 207 .NH 2
 208 LPC
 209 .PP
 210 .SH
 211 couldn't start printer
 212 .IP
 213 This case is the same as when
 214 .I lpr
 215 reports that the daemon cannot be started.
 216 .SH
 217 cannot examine spool directory
 218 .IP
 219 Error messages beginning with ``cannot ...'' are usually because of
 220 incorrect ownership or protection mode of the lock file, spooling
 221 directory or the
 222 .I lpc
 223 program.