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