|
|
address in use
|
|
|
|
snmpd(1M) System Administration Commands snmpd(1M) NAME
snmpd - daemon to respond to SNMP request packets SYNOPSIS
/usr/sfw/sbin/snmpd [options] [listening addresses] DESCRIPTION
The snmpd daemon is an SNMP agent that binds to a port and awaits requests from SNMP management software. Upon receiving a request, it pro- cesses the request(s), collects the requested information, performs any requested operation(s), and, finally, returns information to the requester. OPTIONS
The following options are supported: -a Log the source addresses of incoming requests. -A Append to the log file rather than truncating it. -c file Read file as a configuration file. -C Do not read any configuration files except the one optionally specified by the -c option. Note that this behavior also covers the persistent configuration files. This can result in dynamically-assigned values being reset fol- lowing an agent restart, unless the relevant persistent configuration files are explicitly loaded using the -c option. -d Dump (in hexadecimal) the sent and received SNMP packets. -D[token[,...]] Turn on debugging output for the given token(s). Without any tokens specified, this option defaults to printing all of the tokens (which is equivalent to the keyword ALL). Use ALL for extremely verbose output. Note that you must not put a space between the -D flag and the listed tokens. -f Do not fork() from the calling shell. -g GID Change to the numerical group ID GID after opening listening sockets. -h, --help Display a brief usage message and then exit. -H Display a list of configuration file directives understood by the agent and then exit. -I -initlist This option specifies which modules you do (or do not) want to be initialized when the agent starts up. If the comma-separated initlist is preceded with an hyphen (-), it is the list of modules that you do not want to be started. Otherwise, initlist is the list of mod- ules to be started. To obtain a list of compiled modules, run the agent with the arguments -Dmib_init -H This command assumes you have debugging support compiled in. -l [file] Log all output from the agent (including stdout and stderr) to file. If no filename is given, log to a default file set at compile time, normally /var/log/snmpd.log. -L Do not open a log file. Send all messages to stderr instead. -P file Save the process ID of the daemon in file. -q Print simpler output for easier automated parsing. -r Do not require root access to run the daemon. Specifically, do not exit if files accessible only to root (such as /dev/kmem) cannot be opened. -s Use syslog for logging. See syslogd(1M) -S d[0-7] Specifies the syslog facility to use when logging to syslog. d means LOG_DAEMON and the integers 0 through 7 refer to LOG_LOCAL0 through LOG_LOCAL7. LOG_DAEMON is the default. -u UID Change to the user ID UID (which can be given in numerical or text form) after opening listening sockets. -v --version Display version information for the agent and then exit. -V Symbolically dump SNMP transactions. -x address Listens for AgentX connections on address rather than on the default /var/agentx/master. The address can either be a Unix domain socket path or the address of a network interface. The format is the same as the format of listening addresses described below. Note that it is a possible security risk to expose the master agent listening address through TCP/UDP. See section 9 of RFC 2741 for more details. -X Run as an AgentX subagent rather than as an SNMP master agent. Listening Addresses By default, snmpd listens for incoming SNMP requests only on UDP port 161. However, it is possible to modify this behavior by specifying one or more listening addresses as arguments to the daemon. A listening address takes the form: [<transport-specifier>:]<transport-address> At its simplest, a listening address can consist of only a port number, in which case snmpd listens on that UDP port on all IPv4 inter- faces. Otherwise, the <transport-address> part of the specification is parsed according to the following table: <transport-specifier> <transport-address> format udp hostname[:port] or IPv4-address[:port] tcp hostname[:port] or IPv4-address[:port] unix pathname Currently transports TCP/UDP over IPv4/IPv6 and unix domain sockets. Note that <transport-specifier> strings are case-insensitive so that, for example, tcp and TCP are equivalent. Below are some examples, with accompanying explanations. 127.0.0.1:161 Listen on UDP port 161, but only on the loopback interface. This prevents snmpd from being queried remotely. The :161 is redundant because that is the default SNMP port. TCP:1161 Listen on TCP port 1161 on all IPv4 interfaces. unix:/tmp/local-agent Listen on the Unix domain socket /tmp/local-agent. /tmp/local-agent Identical to the previous specification, because the Unix domain is the default transport if and only if the first character of <trans- port-address> is a slash (/). udp6:10161 Listen on port 10161 on all IPv6 interfaces. Note that not all the transport domains listed above will always be available. For example, hosts with no IPv6 support will not be able to use udp6 transport addresses, and attempts to do so will result in the error "Error opening specified endpoint". FILES
snmpd checks for the existence of and parses the following files: snmp.conf Common configuration for the agent and applications. See snmp.conf(4) for details. snmpd.local.conf Agent-specific configuration. See snmp.conf(4) for details. These files are optional and can be used to configure access control, trap generation, subagent protocols, and other features. In addition to these two configuration files, 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, the default location upon agent startup are /etc/sma/snmp and /usr/local/share/snmp. /etc/sma/snmp/mibs The agent loads all files in this directory as MIBs. It does not, however, load any file that begins with a dot (.) or descend into subdirectories. EXIT STATUS
0 Successful completion. 1 A usage syntax error. A usage message is displayed. Also used for timeout errors. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWsmagt | +-----------------------------+-----------------------------+ |Interface Stability |Stable | +-----------------------------+-----------------------------+ SEE ALSO
snmp.conf(4), attributes(5) NOTES
In addition to basic privileges, to run successfully, the agent requires PRIV_NET_PRIVADDR. See privileges(5). SunOS 5.10 20 Jan 2004 snmpd(1M)
