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.\" $FreeBSD: src/usr.sbin/lpr/chkprintcap/chkprintcap.8,v 1.3.2.4 2002/09/01 00:37:35 gad Exp $ 29.\" $DragonFly: src/usr.sbin/lpr/chkprintcap/chkprintcap.8,v 1.2 2003/06/17 04:29:55 dillon Exp $ 30.Dd November 30, 1997 31.Dt CHKPRINTCAP 8 32.Os 33.Sh NAME 34.Nm chkprintcap 35.Nd check validity of entries in the print spooler database 36.Sh SYNOPSIS 37.Nm 38.Op Fl d 39.Op Fl f Ar printcap 40.Sh DESCRIPTION 41The 42.Nm 43utility scans a 44.Xr printcap 5 45database 46(named by the 47.Ar printcap 48argument, or by default 49.Pa /etc/printcap ) , 50looking for entries which are invalid in one way or another. 51The following checks are currently implemented: 52.Bl -enum -offset indent 53.It 54.Sq Li tc= 55references were properly expanded 56.It 57.Sq Li tc= 58references did not form a loop 59.It 60No two printers share the same spool directory 61.Sq ( Li sd= 62capability). 63.El 64.Pp 65The 66.Nm 67utility exits with a status equal to the number of errors encountered before 68processing stopped. (In some cases, processing can stop before the 69entire file is scanned.) 70.Pp 71If the 72.Fl d 73flag is given, 74.Nm 75will attempt to create any missing spool directories, giving them 76.Sq Li u=rwx,go=rx 77(0755) mode, group 78.Sq Li daemon , 79and the owner specified by the 80.Sq Li du= 81capability in the database (default 1, which corresponds to user 82.Sq Li daemon ) . 83.Sh SEE ALSO 84.Xr lpr 1 , 85.Xr printcap 5 , 86.Xr lpd 8 87.Sh AUTHORS 88The 89.Nm 90utility was written by 91.An Garrett A. Wollman Aq wollman@lcs.mit.edu . 92.Sh BUGS 93Not enough sanity-checking is done. At a minimum, the ownership and 94mode of the spool directories should also be checked. Other 95parameters whose value could cause 96.Xr lpd 8 97to fail should be diagnosed. 98