Debian Codegraph @

upstream/debian-unstable/man8/checkpc.8

raw
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