xref: /freebsd/contrib/bsnmp/README (revision 8ddb146abcdf061be9f2c0db7e391697dafad85c)
1Fri Dec  5 15:01:16 CET 2003
2
3This is a mini-SNMP daemon. The basic daemon implements the system group
4and a number of private extensions to manage the UDP transport mapping,
5communities, trap destinations and loadable modules. In this form it can
6be used to provide remote access to arbitrary data that can be described in
7the form as required by the SMI. The daemon speaks both SNMPv1 and SNMPv2c.
8
9One basic loadable module is provided together with the daemon:
10
11- snmp_mibII provides the information groups for ip, tcp, and udp.
12
13Installation
14------------
15
16As usual by doing:
17
18	configure [--with-libbegemot[=path]]
19	make
20	make install
21
22This does not install a configuration file. The standard location for the
23configuration is /etc/snmpd.config, but can be overwritten on the command
24line. An example configuration file is provided. Use --with-libbegemot
25to use libbegemot instead of libisc.
26
27Running
28-------
29
30	snmpd [-m name[=value]] [-p pid-file] [-c config-file] [-d] [-l prefix]
31	      [-D debug-flags] [-I path]
32
33	-m	defines a configuration macro. If no value is given it
34		is set to the empty string.
35
36	-p	specify the file where to store the PID. Default is
37		/var/run/{prefix}.pid.
38
39	-c	specify the configuration file. Default is /etc/{prefix}.config.
40
41	-d	don't go into daemon mode.
42
43	-l	specify the prefix. This is used for the default config and
44		pid file names and for the syslog. Default is "snmpd".
45
46	-D	specify debug flags:
47
48		d	dump all PDUs.
49
50		e	debug event library.
51
52	-I	specify the include path for system configuration files.
53		Default is /etc:/usr/etc:/usr/local/etc.
54
55The directory snmpd contains a snmpd.sh script, which can be copied to
56/usr/local/etc/rc.d to automatically start and stop the daemon. snmpd.config
57is an example config script.
58
59Bug reports:
60-----------
61
62Please report bugs to harti@freebsd.org.
63
64Happy hacking,
65harti
66