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  per-
     missions, 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  specify
          that  all  files  should be checked regardless. In this
          case the form file=value will be the more useful.

     -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 speci-
          fied 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 own-
          ership, 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 output  will
     no longer be valid input for a shell.

HISTORY

     Written by Brendan Kehoe <brendan@cygnus.com> and Rich  Salz
     <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)