blob: d5e1bcec2582c430c6094dde7ae61fdb10861875 [file] [log] [blame]
.TH SNMPD 1 "9 Sep 1995"
.ds )H U.C. Davis
.ds ]W VVERSIONINFO
.UC 4
.SH NAME
snmpd - daemon to respond to SNMP request packets.
.SH SYNOPSIS
.B "snmpd [-v] [-a] [-V] [-d] [-q] [-D] [-p port] [-f] [-l logfile] [-L] [-c file] [-C]"
.SH DESCRIPTION
.B snmpd
is a SNMP agent which binds to a port and awaits requests from
SNMP management software. Upon receiving a request, it processes the
request(s), collects the requested information and/or performs the
requested operation(s) and returns the information to the sender.
.SH OPTIONS
.RS
.TP 6
.B -v
Print version information for the agent, and exit.
.B -a
Dumps the addresses the agent corresponds with to stderr or logfile.
.TP
.B -V
Makes a symbolic dump of the protocol transaction.
.TP
.B -d
Dumps the sent and received UDP packets to stderr or logfile.
.TP
.B -q
Print simpler output for easier automated parsing.
.TP
.B -D
Turn on debugging output
.TP
.B -p port
Opens on
.I port
instead of the default SNMP agent port, 161.
.TP
.B -f
Don't fork() from the calling shell.
.TP
.B -l logfile
Log's all output from the agent (including stdout/stderr) to
.I logfile.
Defaults to a compiled option.
.TP
.B -L
Don't open a log file; use stdout/stderr instead.
.TP
.B -A
Append to the log file rather than truncating it.
.TP
.B -c file
Read
.I file
as a configuration file.
.TP
.B -C
Don't read any configuration files except the one optionally specified by the
.B -c
option.
.RE
.SH CONFIGURATION FILES
.PP
.B snmpd
checks for the existence of and parses the following files:
.RS
.TP 6
.B DATADIR/snmp/snmp.conf
Common configuration for the agend and the application. See snmp.conf(5)
for details.
.TP
.B DATADIR/snmp/snmpd.conf
.TP
.B DATADIR/snmp/snmpd.local.conf
Configures the agent. See snmpd.conf(5) for details. These files are
optional and are only used to configure the extensible portions of the
agent, the values of the community strings, and the optional trap
destinations. By default, the first community string ("public" by
default) is allowed read-only access and the second ("private" by
default) is allowed write access as well. The 3-5th community strings
are read-only as well.
.IP
In addition to these two configuration files in DATADIR/snmp, the
agent will read any files with the names snmpd.conf and
snmpd.local.conf in a colon separated path specified in the
SNMPCONFPATH environment variable.
.TP
.B DATADIR/snmp/mibs/
The agent will also load all files in this directory as mibs also. It
will not, however, load any file that begins with a '.' or descend into
subdirectories.
.B
.TP
.B DATADIR/snmp/party.conf
Defines the classic SNMP V2 parties.
.TP
.B DATADIR/snmp/view.conf
Defines which parties defined in the
.B party.conf
have access to which parts of the mib.
.TP
.B DATADIR/snmp/context.conf
Maps names to numerical view contexts.
.TP
.B DATADIR/snmp/acl.conf
Defines the classic SNMP V2 action types usable by two communicating parties.
.RE
.PP
See the associated manual pages for information on the content of
these files.
.SH FILES
DATADIR/snmp/snmpd.conf
.br
DATADIR/snmp/party.conf
.br
DATADIR/snmp/view.conf
.br
DATADIR/snmp/context.conf
.br
DATADIR/snmp/acl.conf
.SH SEE ALSO
(in recommended reading order)
.PP
snmp.conf(5),
snmpd.conf(5),
party.conf(5),
view.conf(5),
context.conf(5),
acl.conf(5)
.\" Local Variables:
.\" mode: nroff
.\" End: