SNMPCONF(1) Net-SNMP SNMPCONF(1)

NAME
       snmpconf - creates and modifies SNMP configuration files

SYNOPSIS
       ssnnmmppccoonnff [OPTIONS] [fileToCreate]

       Start with:
              ssnnmmppccoonnff -g basicsetup

       Or even just:
              ssnnmmppccoonnff

DESCRIPTION
       ssnnmmppccoonnff  is  a  simple Perl script that walks you through setting up a
       configuration file step by step.  It should be fairly straight  forward
       to use.  Merely run it and answer its questions.

       In  its default mode of operation, it prompts the user with menus show-
       ing sections of the various configuration files it knows  about.   When
       the user selects a section, a sub-menu is shown listing of the descrip-
       tions of the tokens that can  be  created  in  that  section.   When  a
       description  is selected, the user is prompted with questions that con-
       struct the configuration line in question.

       Finally, when the user quits the program any configuration  files  that
       have  been  edited  by the user are saved to the local directory, fully
       commented.

       A particularly useful option is the  -gg  switch,  which  walks  a  user
       through a specific set of configuration questions.  Run:

              snmpconf -g basicsetup

       for an example.

OOPPTTIIOONNSS
       -ff      Force overwriting existing files in the current directory with-
               out prompting the user if this is a desired thing to do.

       -ii      When finished, install the files into the  location  where  the
               global system commands expect to find them.

       -pp      When  finished,  install  the  files into the users home direc-
               tory's .snmp subdirectory (where  the  applications  will  also
               search for configuration files).

       -II DIRECTORY
               When  finished, install the files into the directory DIRECTORY.

       -aa      Don't ask any questions.  Simply read in the various known con-
               figuration  files  and write them back out again.  This has the
               effect of "auto-commenting" the configuration  files  for  you.
               See the NNEEAATT TTRRIICCKKSS section below.

       -rrall|none
               Read  in  either  all or none of the found configuration files.
               Normally ssnnmmppccoonnff prompts you for which files you wish to  read
               in.   Reading  in  these  configuration  files will merge these
               files with the results of the questions that it asks of you.

       -RR FILE,...
               Read in a specific list of configuration files.

       -gg GROUPNAME
               Groups of configuration entries can be created that can be used
               to  walk a user through a series of questions to create an ini-
               tial configuration file.  There are no menus to navigate,  just
               a list of questions.  Run:

                      snmpconf -g basicsetup

               for a good example.

       -GG      List all the known groups.

       -cc CONFIGDIR
               ssnnmmppccoonnff uses a directory of configuration information to learn
               about the files and questions that it should be  asking.   This
               option tells ssnnmmppccoonnff to use a different location for configur-
               ing itself.

       -qq      Run slightly more quietly.  Since this is an  interactive  pro-
               gram,  I  don't  recommend  this  option  since it only removes
               information from the output that is designed to help you.

       -dd      Turn on lloottss of debugging output.

       -DD      Add eevveenn mmoorree debugging output in the  form  of  Perl  variable
               dumps.


NNEEAATT TTRRIICCKKSS
       snmpconf -g basicsetup
              Have I mentioned this command enough yet?  It's designed to walk
              someone through  an  initial  setup  for  the  snmpd(8)  daemon.
              Really, you should try it.

       snmpconf -R /usr/local/snmp/snmpd.conf -a -f snmpd.conf
              Automatically reads in an snmpd.conf file (for example) and adds
              comments to them describing what each token does.  Try it.  It's
              cool.

NNOOTTEESS
       ssnnmmppccoonnff  is  actually a very generic utility that could be easily con-
       figured to help construct just about any kind  of  configuration  file.
       Its default configuration set of files are SNMP based.

SEE ALSO
       snmpd(8), snmpconfig(5), snmp.conf(5), snmpd.conf(5)



4th Berkeley Distribution         08 Feb 2002                      SNMPCONF(1)