[src/trunk]: src/share/man/man5 PR/17399: John Heasley: describe filter error...

[christos <christos%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/4b88c6803302
branches:  trunk
changeset: 544231:4b88c6803302
user:      christos <christos%NetBSD.org@localhost>
date:      Sat Mar 15 04:45:52 2003 +0000

description:
PR/17399: John Heasley: describe filter error codes and lock file modes.

diffstat:

 share/man/man5/printcap.5 |  21 ++++++++++++++++++++-
 1 files changed, 20 insertions(+), 1 deletions(-)

diffs (35 lines):

diff -r ded38f82dec1 -r 4b88c6803302 share/man/man5/printcap.5
--- a/share/man/man5/printcap.5 Sat Mar 15 04:41:17 2003 +0000
+++ b/share/man/man5/printcap.5 Sat Mar 15 04:45:52 2003 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: printcap.5,v 1.13 2003/03/04 16:10:04 fredb Exp $
+.\"    $NetBSD: printcap.5,v 1.14 2003/03/15 04:45:52 christos Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -264,6 +264,25 @@
 .Xr syslog 3 ,
 and must not ignore
 .Dv SIGINT .
+.Pp
+Filters can communicate errors to lpd by their exit code and by modifying
+the mode of the spool lock file as follows:
+.Bl -column "Exit-code" Description
+.Sy "Exit-code"       Description
+.It 0 Success.
+.It 1 An attempt is made to reprint the job and mail is sent if it fails.
+.It 2 \c
+.Xr lpd 8
+silently discards the job.
+.It n \c
+.Xr lpd 8
+discards the job and mail is sent.
+.El
+.Bl -column "lock mode" Description
+.Sy "lock mode"       Description
+.It u+x       Stop printing and leave queue disabled (S_IXUSR).
+.It o+x       Rebuild the queue (S_IXOTH).
+.El
 .Sh LOGGING
 Error messages generated by the line printer programs themselves
 (that is, the lp* programs) are logged by