1.ds VE LPRng-3.9.0
2.TH CHECKPC 8 \*(VE "LPRng"
3.ig
4checkpc.8,v 3.33 1998/03/29 18:37:49 papowell Exp
5LPRng
6Mon Jul 17 20:13:09 PDT 1995 Patrick Powell
7..
8.SH NAME
9checkpc \- check out the printcap database
10.SH SYNOPSIS
11.B checkpc
12[
13.B \-aflprsCV
14] [
15.B \-A age[DHMS]
16] [
17.B \-D debugflags
18] [
19.B \-P printer
20] [
21.B \-t size[kM]
22]
23.SH DESCRIPTION
24.B Checkpc
25is used to check for the existence and correct permissions of entries
26in the
27.I printcap
28database.
29It is useful when installing a new printcap database and cleaning up
30existing printer spoolers.
31.IP "\fB\-a\fI" 5
32Do not create accounting files (:lf).
33.IP "\fB\-f\fI" 5
34The fix flag will cause the checkpc program create and fix
35various files and permissions.
36It does this in a simple minded manner,
37and the program may have to be run several times until all permissions
38are correct.
39It also reports in extremely verbose details its actions.
40.IP "\fB\-l\fI" 5
41Do not create log files (:lf).
42.IP "\fB\-p\fI" 5
43Print verbose printcap information.
44Useful if interested in the printcap values.
45.IP "\fB\-r\fI" 5
46remove junk or job files older than the age set by -A.
47You must set the age to a non-zero value otherwise no files are removed.
48.IP "\fB\-s\fI" 5
49Do not create filter status files (:ps).
50.IP "\fB\-A\fI Age[DHMS]" 5
51Report junk or job files older than age.
52The age time can have a suffix
53days (D)
54hours (H),
55minutes (M),
56or
57seconds (S);
58default is days.
59.IP "\fB\-D\fI debugflags" 5
60Run the program with debugging flags.
61See the LPRng HOWTO for details of the flags actions.
62.IP "\fB\-V\fI" 5
63Verbose mode.
64.IP "\fB\-P\fI printer" 5
65Process only the specified print queue.
66.IP "\fB\-t\fI size[kM]" 5
67Truncate log files (:lf) to the specified size in Kbytes
68or Mbytes (default is Mbytes).
69.SH "ANNOYING FEATURES"
70If the
71.B \-f
72(fix)
73option is specified and you do not run this as root,
74it will complain,
75but attempt to carry out the operations.
76This will lead to a large number of failures reports
77if the ownership and/or permissions are incorrect.
78.SH FILES
79.PP
80The files used by LPRng are set by values in the
81printer configuration file and by configuration options.
82The following are a commonly used set of default values.
83.nf
84.ta \w'/var/spool/lpd/printcap.<hostname>           'u
85_LPD_CONF_PATH_	LPRng configuration file
86${HOME}/.printcap	user printer description file
87_PRINTCAP_PATH_	printer description file
88_LPD_PERMS_PATH_	permissions
89_LOCKFILE_	lock file for queue control
90/var/spool/lpd		spool directories
91/var/spool/lpd/QUEUE/control	queue control
92/var/spool/lpd/QUEUE/log	trace or debug log file
93/var/spool/lpd/QUEUE/acct	accounting file
94/var/spool/lpd/QUEUE/status	status file
95.fi
96.SH "SEE ALSO"
97lpd.conf(5),
98lpc(8),
99lpd(8),
100lpr(1),
101lpq(1),
102lprm(1),
103printcap(5),
104lpd.perms(5),
105pr(1), lprng_certs(1), lprng_index_certs(1).
106.SH DIAGNOSTICS
107.nf
108Most of the diagnostics are self explanatory.
109If you are puzzled over the exact cause of failure,
110set the debugging level on (-D5) and run again.
111The debugging information will 
112help you to pinpoint the exact cause of failure.
113.fi
114.SH "HISTORY"
115LPRng is a enhanced printer spooler system
116with functionality similar to the Berkeley LPR software.
117The LPRng mailing list is lprng@lprng.com;
118subscribe by sending mail to lprng-request@lprng.com with
119the word subscribe in the body.
120The software is available from ftp://ftp.lprng.com/pub/LPRng.
121.SH "AUTHOR"
122Patrick Powell <papowell@lprng.com>.
123