xref: /freebsd/usr.sbin/lpr/chkprintcap/chkprintcap.8 (revision a8445737e740901f5f2c8d24c12ef7fc8b00134e)
1.\" Copyright 1997 Massachusetts Institute of Technology
2.\"
3.\" Permission to use, copy, modify, and distribute this software and
4.\" its documentation for any purpose and without fee is hereby
5.\" granted, provided that both the above copyright notice and this
6.\" permission notice appear in all copies, that both the above
7.\" copyright notice and this permission notice appear in all
8.\" supporting documentation, and that the name of M.I.T. not be used
9.\" in advertising or publicity pertaining to distribution of the
10.\" software without specific, written prior permission.  M.I.T. makes
11.\" no representations about the suitability of this software for any
12.\" purpose.  It is provided "as is" without express or implied
13.\" warranty.
14.\"
15.\" THIS SOFTWARE IS PROVIDED BY M.I.T. ``AS IS''.  M.I.T. DISCLAIMS
16.\" ALL EXPRESS OR IMPLIED WARRANTIES WITH REGARD TO THIS SOFTWARE,
17.\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
18.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT
19.\" SHALL M.I.T. BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
20.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
21.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
22.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
23.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
24.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
25.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
28.\"	$Id: chkprintcap.8,v 1.1 1997/12/02 20:45:09 wollman Exp $
29.Dd November 30, 1997
30.Dt CHKPRINTCAP 8
31.Os
32.Sh NAME
33.Nm chkprintcap
34.Nd check validity of entries in the print spooler database
35.Sh SYNOPSIS
36.Nm chkprintcap
37.Op Fl d
38.Op Fl f Ar printcap
39.Sh DESCRIPTION
40.Nm Chkprintcap
41scans a
42.Xr printcap 5
43database
44(named by the
45.Ar printcap
46argument, or by default
47.Pa /etc/printcap ) ,
48looking for entries which are invalid in one way or another.
49The following checks are currently implemented:
50.Bl -enum -offset indent
51.It
52.Sq Li tc=
53references were properly expanded
54.It
55.Sq Li tc=
56references did not form a loop
57.It
58No two printers share the same spool directory
59.Po
60.Sq Li sd=
61capability
62.Pc .
63.El
64.Pp
65.Nm Chkprintcap
66exits with a status equal to the number of errors encountered before
67processing stopped.  (In some cases, processing can stop before the
68entire file is scanned.)
69.Pp
70If the
71.Fl d
72flag is given,
73.Nm chkprintcap
74will attempt to create any missing spool directories, giving them
75.Sq Li u=rwx,go=rx
76(0755) mode, group
77.Sq Li daemon ,
78and the owner specified by the
79.Sq Li du=
80capability in the database (default 1, which corresponds to user
81.Sq Li daemon ) .
82.Sh SEE ALSO
83.Xr lpr 1 ,
84.Xr printcap 5 ,
85.Xr lpd 8
86.Sh AUTHORS
87The
88.Nm chkprintcap
89command was written by
90.An Garrett A. Wollman Aq wollman@lcs.mit.edu .
91.Sh BUGS
92Not enough sanity-checking is done.  At a minimum, the ownership and
93mode of the spool directories should also be checked.  Other
94parameters whose value could cause
95.Xr lpd 8
96to fail should be diagnosed.
97