snmpconf(1M)						  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 supplies 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 directory 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 configuration files and write them back out again. This has the  effect  of	"auto-com-
	   menting" 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 con-
	   figuration 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 recommended. It removes informa-
	   tion 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 attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWsmcmd 		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |External			   |
       +-----------------------------+-----------------------------+

SEE ALSO

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

SunOS 5.10							    20 Jan 2004 						      snmpconf(1M)