| 1 |
.TH CHECKPC 8 2007-02-22 "LPRng" "checkpc command" |
| 2 |
.SH NAME |
| 3 |
checkpc \- check out the printcap database |
| 4 |
.SH SYNOPSIS |
| 5 |
.B checkpc |
| 6 |
.RB [ " \-aflprsV " ] |
| 7 |
.RB [ " \-A" \fIage\fP[ DHMS "] ]" |
| 8 |
.RB [ " \-D\fIdebugflags\fP " ] |
| 9 |
.RB [ " \-P\fIprinter\fP " ] |
| 10 |
.RB [ " \-t " \fIsize\fP[ kM "] ]" |
| 11 |
.SH DESCRIPTION |
| 12 |
.B Checkpc |
| 13 |
is used to check for the existence and correct permissions of entries |
| 14 |
in the |
| 15 |
.I printcap |
| 16 |
database. |
| 17 |
It is useful when installing a new printcap database and cleaning up |
| 18 |
existing printer spoolers. |
| 19 |
.TP |
| 20 |
.B \-a |
| 21 |
Do not create accounting files (:af). |
| 22 |
.TP |
| 23 |
.B \-f |
| 24 |
The fix flag will cause the checkpc program create and fix |
| 25 |
various files and permissions. |
| 26 |
It does this in a simple minded manner, |
| 27 |
and the program may have to be run several times until all permissions |
| 28 |
are correct. |
| 29 |
It also reports in extremely verbose details its actions. |
| 30 |
.TP |
| 31 |
.B \-l |
| 32 |
Do not create log files (:lf). |
| 33 |
.TP |
| 34 |
.B \-p |
| 35 |
Print verbose printcap information. |
| 36 |
Useful if interested in the printcap values. |
| 37 |
.TP |
| 38 |
.B \-r |
| 39 |
remove junk or job files older than the age set by -A. |
| 40 |
You must set the age to a non-zero value otherwise no files are removed. |
| 41 |
.TP |
| 42 |
.B \-s |
| 43 |
Do not create filter status files (:ps). |
| 44 |
.TP |
| 45 |
.B "\-A \fIAge\fR[\fBDHMS\fR]" |
| 46 |
Report junk or job files older than age. |
| 47 |
The age time can have a suffix |
| 48 |
days (D) |
| 49 |
hours (H), |
| 50 |
minutes (M), |
| 51 |
or |
| 52 |
seconds (S); |
| 53 |
default is days. |
| 54 |
.TP |
| 55 |
.BI "\-D " debugflags |
| 56 |
Run the program with debugging flags. |
| 57 |
See the LPRng HOWTO for details of the flags actions. |
| 58 |
.TP |
| 59 |
.B \-V |
| 60 |
Verbose mode. |
| 61 |
.TP |
| 62 |
.BI "\-P " printer |
| 63 |
Process only the specified print queue. |
| 64 |
.TP |
| 65 |
.B "\-t \fIsize\fR[\fBkM\fR]" |
| 66 |
Truncate log files (:lf) to the specified size in Kbytes |
| 67 |
or Mbytes (default is Mbytes). |
| 68 |
.TP |
| 69 |
.BI "\-T " serial-line |
| 70 |
set process name and start feature test |
| 71 |
.SH "ANNOYING FEATURES" |
| 72 |
If the |
| 73 |
.BR \-f (fix) |
| 74 |
option is specified and you do not run this as root, |
| 75 |
it will complain, |
| 76 |
but attempt to carry out the operations. |
| 77 |
This will lead to a large number of failures reports |
| 78 |
if the ownership and/or permissions are incorrect. |
| 79 |
.SH FILES |
| 80 |
The files used by LPRng are set by values in the |
| 81 |
printer configuration file and by configuration options. |
| 82 |
The following are a commonly used set of default values. |
| 83 |
.nf |
| 84 |
.ta \w'/var/spool/lpd/printcap.<hostname> 'u |
| 85 |
/etc/lprng/lpd.conf LPRng configuration file |
| 86 |
${HOME}/.printcap user printer description file |
| 87 |
/etc/printcap printer description file |
| 88 |
/etc/lprng/lpd.perms permissions |
| 89 |
/var/run/lprng/lpd 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" |
| 97 |
.BR lpd.conf (5), |
| 98 |
.BR lpc (8), |
| 99 |
.BR lpd (8), |
| 100 |
.BR lpr (1), |
| 101 |
.BR lpq (1), |
| 102 |
.BR lprm (1), |
| 103 |
.BR printcap (5), |
| 104 |
.BR lpd.perms (5), |
| 105 |
.BR pr (1), |
| 106 |
.BR lprng_certs (1), |
| 107 |
.BR lprng_index_certs (1). |
| 108 |
.SH "AUTHOR" |
| 109 |
Patrick Powell <[email protected]>. |
| 110 |
.SH DIAGNOSTICS |
| 111 |
Most of the diagnostics are self explanatory. |
| 112 |
If you are puzzled over the exact cause of failure, |
| 113 |
set the debugging level on (-D5) and run again. |
| 114 |
|
| 115 |
The debugging information will |
| 116 |
help you to pinpoint the exact cause of failure. |
| 117 |
.SH "HISTORY" |
| 118 |
LPRng is a enhanced printer spooler system |
| 119 |
with functionality similar to the Berkeley LPR software. |
| 120 |
The LPRng developer mailing list is [email protected]; |
| 121 |
subscribe by visiting |
| 122 |
.B https://lists.sourceforge.net/lists/listinfo/lprng-devel |
| 123 |
or sending mail to |
| 124 |
.B [email protected] |
| 125 |
with |
| 126 |
the word |
| 127 |
.I subscribe |
| 128 |
in the body. |
| 129 |
.br |
| 130 |
The software is available via |
| 131 |
.B http://lprng.sourceforge.net |