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)