INNCHECK(8)

NAME
       inncheck - check inn configuration and database files.

SYNOPSIS
       inncheck  [  -a  ] [ -v ] [ -pedantic ] [ -f ] [ -perm ] [
       -noperm ] [ file=value | file ]

DESCRIPTION
       Inncheck  examines   various   configuration   files   and
       databases  and verifies things about them. Things verified
       depend on the file being checked, but generally are things
       like permissions, ownership, syntax errors in config files
       etc.

       Inncheck does not make changes to any  files  --  it  just
       reports  what  it thinks may be wrong, and it is up to the
       operator to fix the problem.

       The set of files checked may be restricted by  using  file
       or  file=value  arguments. For example, putting hosts.nntp
       causes only the hosts.nntp(5) file to  be  checked.  Using
       hosts.nntp=/tmp/hosts.nntp.tst  on  the  command line will
       cause inncheck to only verify the hosts.nntp file, and  it
       will  perform  the checks on the file /tmp/hosts.nntp file
       instead of the default one.

       Valid values for file are:
                  active
                  control.ctl
                  expire.ctl
                  hosts.nntp
                  inn.conf
                  moderators
                  newsfeeds
                  overview.fmt
                  nnrp.access
                  nntpsend.ctl
                  passwd.nntp

OPTIONS
       -a     If any ``file'' value or ``file=value'' pairs  (see
              below) are given, then normally only the files they
              refer to are checked. Use the ``-a'' flag to  spec-
              ify that all files should be checked regardless. In
              this case the form file=value will be the more use-
              ful.

       -v     Use the ``-v'' option to get more verbose output.

       -pedantic
              Use the ``-pedantic option to get reports on things
              that are not necessarily wrong, but may indicate  a
              bad  configuration -- such as inn.conf(5) missing a
              key.

       -f     Use the ``-f'' flag  to  have  inncheck  print  the
              appropriate  chown/chgrp/chmod command necessary to
              fix a problem that it reports.   Any  other  output
              lines  will  be  prefixed with a ``#'' character to
              make the output be valid input for a  shell.   Note
              that  the  ``-perm'' flag must be used as well when
              using this flag.

       -perm  Inncheck checks all files for permission  problems.
              If  the ``-perm'' flag is used, then only the files
              specified by the file or  file=value  command  line
              arguments  will  be checked for problems other than
              permission problems.

       -noperm
              To avoid doing any checking of file permissions  or
              ownership, use the ``-noperm'' option.

EXAMPLES
       To have inncheck check all files for syntax and permission
       problems simply:
              inncheck

       To have inncheck check all files for  permission  problems
       and  to  verify  the  syntax  of the active and hosts.nntp
       files do:
              inncheck -perm active hosts.nntp

       To  have  inncheck  check  the  test  newsfeeds  file   in
       /var/tmp/newsfeeds.testing, do:
              inncheck newsfeeds=/var/tmp/newsfeeds.testing

       To  have inncheck check all the files as it normally does,
       but to specify a  different  location  for  the  newsfeeds
       file, so:
              inncheck -a newsfeeds=/var/tmp/newsfeeds.testing

BUGS
       If  the  ``-f''  and  ``-perm'' options are used together,
       along with -a or some ``file'' or ``file=value'' arguments
       that  refer to a file with a syntax problem, then the out-
       put will no longer be valid input for a shell.

HISTORY
       Written by Brendan  Kehoe  lt;brendan@cygnus.com  and  Rich
       Salz  lt;rsalz@uunet.uu.net  This  is  revision  1.1, dated
       1996/10/29.

SEE ALSO
       active(5) expire.ctl(5) history(5) hosts.nntp(5) 
       inn.conf(5) newsfeeds(5)