1INNCHECK(8) System Manager's Manual INNCHECK(8)
2
6 inncheck - check inn configuration and database files.
7
9 inncheck [ -a ] [ -v ] [ -pedantic ] [ -f ] [ -perm ] [ -noperm ] [
10 file=value | file ]
11
13 Inncheck examines various configuration files and databases and veri‐
14 fies things about them. Things verified depend on the file being
15 checked, but generally are things like permissions, ownership, syntax
16 errors in config files, etc.
17 Inncheck does not make changes to any files — it just reports what it
19 thinks may be wrong, and it is up to the operator to fix the problem.
20 The set of files checked may be restricted by using file or file=value
22 arguments. For example, putting incoming.conf causes only the incom‐
23 ing.conf file to be checked. Using incoming.conf=/tmp/incoming.conf on
24 the command line will cause inncheck to only verify the incoming.conf
25 file, and it will perform the checks on the file /tmp/incoming.conf
26 file instead of the default one.
27 Valid values for file are:
29 active
31 control.ctl
32 expire.ctl
33 incoming.conf
34 inn.conf
35 moderators
36 newsfeeds
37 nntpsend.ctl
38 passwd.nntp
39 readers.conf
40
42 -a If any ``file'' value or ``file=value'' pairs (see below) are
43 given, then normally only the files they refer to are checked.
44 Use the ``-a'' flag to specify that all files should be checked
45 regardless. In this case the form file=value will be the more
46 useful.
47 -v Use the ``-v'' option to get more verbose output.
49 -pedantic
51 Use the ``-pedantic'' option to get reports on things that are
52 not necessarily wrong, but may indicate a bad configuration —
53 such as inn.conf missing a key.
54 -f Use the ``-f'' flag to have inncheck print the appropriate
56 chown/chgrp/chmod command necessary to fix a problem that it
57 reports. Any other output lines will be prefixed with a ``#''
58 character to make the output be valid input for a shell. Note
59 that the ``-perm'' flag must be used as well when using this
60 flag.
61 -perm Inncheck checks all files for permission problems. If the
63 ``-perm'' flag is used, then only the files specified by the
64 file or file=value command line arguments will be checked for
65 problems other than permission problems.
66 -noperm
68 To avoid doing any checking of file permissions or ownership,
69 use the ``-noperm'' option.
70
72 To have inncheck check all files for syntax and permission problems
73 simply:
74 inncheck
76 To have inncheck check all files for permission problems and to verify
78 the syntax of the active and incoming.conf files do:
79 inncheck -perm active incoming.conf
81 To fix the permissions problems noted in the output of the above com‐
83 mand, modify it as follow:
84 inncheck -f -perm | sh
86 To have inncheck check the test newsfeeds file in /var/tmp/news‐
88 feeds.testing, do:
89 inncheck newsfeeds=/var/tmp/newsfeeds.testing
91 To have inncheck check all the files as it normally does, but to spec‐
93 ify a different location for the newsfeeds file, so:
94 inncheck -a newsfeeds=/var/tmp/newsfeeds.testing
96
98 If the ``-f'' and ``-perm'' options are used together, along with
99 ``-a'' or some ``file'' or ``file=value'' arguments that refer to a
100 file with a syntax problem, then the output will no longer be valid
101 input for a shell.
102
104 Written by Brendan Kehoe <brendan@cygnus.com> and Rich Salz
105 <rsalz@uunet.uu.net> This is revision 8409, dated 2009-04-11.
106
108 active(5), expire.ctl(5), history(5), incoming.conf(5), inn.conf(5),
109 newsfeeds(5)
110 INNCHECK(8)