System Administration Commands                       snmpconf(1M)

NAME
     snmpconf - creates and modifies SNMP configuration files

SYNOPSIS
     snmpconf

     snmpconf -g basic_setup

     snmpconf [options] [file_to_create]

DESCRIPTION
     The snmpconf utility is  a  simple  script  that  walks  you
     through  setting  up  a configuration file, step-by-step. It
     works by asking you a series of questions.  It  creates  the
     configuration file based on your responses.

     In its default mode of operation, snmpconf prompts you  with
     menus showing sections of the various configuration files it
     knows about. When you selects a section, a submenu is  shown
     listing  the  descriptions of the tokens that can be created
     in that section. When a description  is  selected,  you  are
     prompted  with questions that determine the specification of
     the selected token.

     When you quit snmpconf, any configuration  files  that  have
     been  edited are saved to the local directory. snmpconf sup-
     plies comments in the configuration files for each change.

     A particularly useful option is the -g switch,  which  walks
     you  through  a specific set of configuration questions. For
     an example, invoke:

     # snmpconf -g basic_setup

     This command walks you through an initial setup of the snmpd
     daemon.

OPTIONS
     The following options are supported:

     -f

         Force overwriting existing files in the  current  direc-
         tory without prompting the user.



     -i

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



     -p

         When finished, install the files into  the  user's  home
         directory's .snmp subdirectory. Applications will search
         for configuration files in this location.



     -I directory

         When finished, install  the  files  into  the  directory
         directory.



     -a

         Do not issue queries. Read in the various  known  confi-
         guration  files  and write them back out again. This has
         the effect of "auto-commenting" the configuration  files
         for you.



     -r all | none

         Read in either all or none of  the  found  configuration
         files.  Normally,  snmpconf  prompts you for which files
         you wish to read in.



     -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.  The command:


         # snmpconf -g basic_setup

         provides 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 the utility to use a different
         location for configuring itself.



     -q

         Run slightly more quietly than the default. Because this
         is  an  interactive  program,  this option is not recom-
         mended. It removes  information  from  the  output  that
         might be helpful to you.



     -d

         Turn on copious debugging output.



     -D

         Add more (beyond -d) debugging output  in  the  form  of
         Perl variable dumps.



EXAMPLES
     Example 1: Adding Comments to snmpd.conf

     The following command reads in an snmpd.conf file  and  adds
     comments describing what each token does.

     # snmpconf -R /etc/sma/snmp/snmpd.conf -a -f snmpd.conf

EXIT STATUS
     0

         Successful completion.


     1

         A usage syntax error. A usage message displays.



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWsmcmd                   |
    |_____________________________|_____________________________|
    | Interface Stability         | External                    |
    |_____________________________|_____________________________|


SEE ALSO
     snmpd(1M), snmpd.conf(4), snmp_config(4), attributes(5)