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 overview.fmt
38 nntpsend.ctl
39 passwd.nntp
40 readers.conf
41
43 -a If any ``file'' value or ``file=value'' pairs (see below) are
44 given, then normally only the files they refer to are checked.
45 Use the ``-a'' flag to specify that all files should be checked
46 regardless. In this case the form file=value will be the more
47 useful.
48 -v Use the ``-v'' option to get more verbose output.
50 -pedantic
52 Use the ``-pedantic'' option to get reports on things that are
53 not necessarily wrong, but may indicate a bad configuration —
54 such as inn.conf missing a key.
55 -f Use the ``-f'' flag to have inncheck print the appropriate
57 chown/chgrp/chmod command necessary to fix a problem that it
58 reports. Any other output lines will be prefixed with a ``#''
59 character to make the output be valid input for a shell. Note
60 that the ``-perm'' flag must be used as well when using this
61 flag.
62 -perm Inncheck checks all files for permission problems. If the
64 ``-perm'' flag is used, then only the files specified by the
65 file or file=value command line arguments will be checked for
66 problems other than permission problems.
67 -noperm
69 To avoid doing any checking of file permissions or ownership,
70 use the ``-noperm'' option.
71
73 To have inncheck check all files for syntax and permission problems
74 simply:
75 inncheck
77 To have inncheck check all files for permission problems and to verify
79 the syntax of the active and incoming.conf files do:
80 inncheck -perm active incoming.conf
82 To fix the permissions problems noted in the output of the above com‐
84 mand, modify it as follow:
85 inncheck -f -perm | sh
87 To have inncheck check the test newsfeeds file in /var/tmp/news‐
89 feeds.testing, do:
90 inncheck newsfeeds=/var/tmp/newsfeeds.testing
92 To have inncheck check all the files as it normally does, but to spec‐
94 ify a different location for the newsfeeds file, so:
95 inncheck -a newsfeeds=/var/tmp/newsfeeds.testing
97
99 If the ``-f'' and ``-perm'' options are used together, along with
100 ``-a'' or some ``file'' or ``file=value'' arguments that refer to a
101 file with a syntax problem, then the output will no longer be valid
102 input for a shell.
103
105 Written by Brendan Kehoe <brendan@cygnus.com> and Rich Salz
106 <rsalz@uunet.uu.net> This is revision 5909, dated 2002-12-03.
107
109 active(5), expire.ctl(5), history(5), incoming.conf(5), inn.conf(5),
110 newsfeeds(5)
111 INNCHECK(8)