inncheck



INNCHECK(8)                                                        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  veri-
       fies  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 incoming.conf causes only the incom-
       ing.conf file to be checked. Using incoming.conf=/tmp/incoming.conf  on
       the  command  line will cause inncheck to only verify the incoming.conf
       file, and it will perform the checks  on  the  file  /tmp/incoming.conf
       file instead of the default one.

       Valid values for file are:

                  active
                  control.ctl
                  expire.ctl
                  incoming.conf
                  inn.conf
                  moderators
                  newsfeeds
                  overview.fmt
                  nntpsend.ctl
                  passwd.nntp
                  readers.conf


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 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 incoming.conf files do:

              inncheck -perm active incoming.conf

       To fix the permissions problems noted in the output of the  above  com-
       mand, modify it as follow:

              inncheck -f -perm | sh

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

              inncheck newsfeeds=/var/tmp/newsfeeds.testing

       To have inncheck check all the files as it normally does, but to  spec-
       ify 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.6, dated 2002/12/03.


SEE ALSO

       active(5),  expire.ctl(5),  history(5),  incoming.conf(5), inn.conf(5),
       newsfeeds(5)



                                                                   INNCHECK(8)

Man(1) output converted with man2html