SNMPCONF(1)                                                 Net-SNMP                                                 SNMPCONF(1)



NAME
       snmpconf - creates and modifies SNMP configuration files

SYNOPSIS
       snmpconf [OPTIONS] [fileToCreate]

       Start with:
              snmpconf -g basic_setup

       Or even just:
              snmpconf

DESCRIPTION
       snmpconf  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 showing sections of the various configuration  files  it
       knows  about.  When the user selects a section, a sub-menu is shown listing of the descriptions of the tokens that can be
       created in that section.  When a description is selected, the user is prompted with questions that construct the configu-
       ration 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 -g switch, which walks a user through a  specific  set  of  configuration  questions.
       Run:

              snmpconf -g basic_setup

       for an example.

OPTIONS
       -f      Force  overwriting  existing files in the current directory without prompting the user if this is a desired thing
               to do.

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

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

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

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

       -rall|none
               Read in either all or none of the found configuration files.  Normally snmpconf 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.

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

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

                      snmpconf -g basic_setup

               for a good example.

       -G      List all the known groups.

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

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

       -d      Turn on lots of debugging output.

       -D      Add even more debugging output in the form of Perl variable dumps.

NEAT TRICKS
       snmpconf -g basic_setup
              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.

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

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



4th Berkeley Distribution                                  08 Feb 2002                                               SNMPCONF(1)