1SNMPCONF(1)                        Net-SNMP                        SNMPCONF(1)
2
3
4

NAME

6       snmpconf - creates and modifies SNMP configuration files
7

SYNOPSIS

9       snmpconf [OPTIONS] [fileToCreate]
10
11       Start with:
12              snmpconf -g basic_setup
13
14       Or even just:
15              snmpconf
16

DESCRIPTION

18       snmpconf  is  a  simple Perl script that walks you through setting up a
19       configuration file step by step.  It should be fairly straight  forward
20       to use.  Merely run it and answer its questions.
21
22       In  its default mode of operation, it prompts the user with menus show‐
23       ing sections of the various configuration files it knows  about.   When
24       the user selects a section, a sub-menu is shown listing of the descrip‐
25       tions of the tokens that can  be  created  in  that  section.   When  a
26       description  is selected, the user is prompted with questions that con‐
27       struct the configuration line in question.
28
29       Finally, when the user quits the program any configuration  files  that
30       have  been  edited  by the user are saved to the local directory, fully
31       commented.
32
33       A particularly useful option is the  -g  switch,  which  walks  a  user
34       through a specific set of configuration questions.  Run:
35
36              snmpconf -g basic_setup
37
38       for an example.
39

OPTIONS

41       -f      Force overwriting existing files in the current directory with‐
42               out prompting the user if this is a desired thing to do.
43
44       -i      When finished, install the files into the  location  where  the
45               global system commands expect to find them.
46
47       -p      When  finished,  install  the  files into the users home direc‐
48               tory's .snmp subdirectory (where  the  applications  will  also
49               search for configuration files).
50
51       -I DIRECTORY
52               When finished, install the files into the directory DIRECTORY.
53
54       -a      Don't ask any questions.  Simply read in the various known con‐
55               figuration files and write them back out again.  This  has  the
56               effect  of  "auto-commenting"  the configuration files for you.
57               See the NEAT TRICKS section below.
58
59       -rall|none
60               Read in either all or none of the  found  configuration  files.
61               Normally  snmpconf prompts you for which files you wish to read
62               in.  Reading in these  configuration  files  will  merge  these
63               files with the results of the questions that it asks of you.
64
65       -R FILE,...
66               Read in a specific list of configuration files.
67
68       -g GROUPNAME
69               Groups of configuration entries can be created that can be used
70               to walk a user through a series of questions to create an  ini‐
71               tial  configuration file.  There are no menus to navigate, just
72               a list of questions.  Run:
73
74                      snmpconf -g basic_setup
75
76               for a good example.
77
78       -G      List all the known groups.
79
80       -c CONFIGDIR
81               snmpconf uses a directory of configuration information to learn
82               about  the  files and questions that it should be asking.  This
83               option tells snmpconf to use a different location for configur‐
84               ing itself.
85
86       -q      Run  slightly  more quietly.  Since this is an interactive pro‐
87               gram, I don't recommend  this  option  since  it  only  removes
88               information from the output that is designed to help you.
89
90       -d      Turn on lots of debugging output.
91
92       -D      Add  even  more  debugging  output in the form of Perl variable
93               dumps.
94

NEAT TRICKS

96       snmpconf -g basic_setup
97              Have I mentioned this command enough yet?  It's designed to walk
98              someone  through  an  initial  setup  for  the  snmpd(8) daemon.
99              Really, you should try it.
100
101       snmpconf -R /usr/local/snmp/snmpd.conf -a -f snmpd.conf
102              Automatically reads in an snmpd.conf file (for example) and adds
103              comments to them describing what each token does.  Try it.  It's
104              cool.
105

NOTES

107       snmpconf is actually a very generic utility that could be  easily  con‐
108       figured  to  help  construct just about any kind of configuration file.
109       Its default configuration set of files are SNMP based.
110

SEE ALSO

112       snmpd(8), snmp_config(5), snmp.conf(5), snmpd.conf(5)
113
114
115
1164th Berkeley Distribution         08 Feb 2002                      SNMPCONF(1)
Impressum