unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

sma_snmp(5)           Standards, Environments, and Macros          sma_snmp(5)



NAME
       sma_snmp, netsnmp - SNMP v1, v2c, v3 agent, tools, and modules

DESCRIPTION
       The  Systems  Management  Agent  (SMA) agent and tools are based on the
       open source NetSNMP project, published at http://www.net-snmp.org.  The
       SNMP  agent  supports  the v1, v2c and v3 protocols. Secure SNMP opera-
       tions are provided through the use of USM and VACM. A set of tools that
       enable  users  to perform simple SNMP operations, monitor various vari-
       ables, and perform configuration  on  the  agent  are  available.  Some
       value-added  modules  that  provide  monitoring information specific to
       Solaris platforms are also available.

   SNMP Agent
       The agent (see snmpd(1M)) is capable of SNMP v3, v2c  and  v1  protocol
       operations.   Details   of   the   related   RFCs   can   be  found  at
       http://www.ietf.org/html.charters/snmpv3-charter.html. The  agent  sup-
       ports  these  protocols  over  a variety of transports. Among these are
       TCP/UDP over IPv4/IPv6 and Unix domain sockets.

       The agent and its modules, including USM and VACM, can be configured by
       making changes to /etc/sma/snmp/snmpd.conf. See snmpd.conf(4).

   USM
       The  User-based  Security  Model  enables strong authentication of SNMP
       users as well as communication privacy, message integrity,  and  replay
       protection.  SNMP users can be managed remotely through the use of SNMP
       operations. Details of USM can be found in RFC 3414. USM supports  pri-
       vacy  of  messages.  Currently, DES encryption is supported on Solaris.
       In the future, more secure AES encryption might  be  added.  The  agent
       also provides the ability to manipulate user entries through local con-
       figuration files.

   VACM
       The View-based Access Control Model enables access control  to  various
       parts  of  an SNMP MIB. Remote management of access control is possible
       through SNMP operations. Details of VACM can be found in RFC 3415.  The
       agent provides the ability to manipulate access control entries through
       local configuration files.

   Subagent
       The agent supports subagents through the AgentX protocol and  MIBs,  as
       defined  in  RFCs 2741 and 2742. This enables the master agent to dele-
       gate population of different portions of the  MIB  tree  to  subagents.
       AgentX  messages  can  be  interchanged  over  a  variety of transports
       including Unix Domain Sockets, TCP and UDP. 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.

   Tools
       The following tools are available:

       encode_keychange

           Collects information to build a KeyChange encoding, per the textual
           convention  given  in  RFC  2274, Section 5. Computes the value and
           prints it to stdout as a hex string.



       fixproc

           Fixes a process named "proc" by performing  the  specified  action.
           The  actions can be check, kill, restart, exist, or fix. The action
           is specified on the command line or is read from  a  default  data-
           base, which describes the default action to take for each process.



       mib2c

           A  script that takes a MIB and converts it into C code. That C code
           can then be used as a template to implement your MIB.



       net-snmp-config

           Net-SNMP configuration options.



       snmpbulkget

           An SNMP application that uses the SNMP  GETBULK  request  to  effi-
           ciently query information on a network entity.



       snmpbulkwalk

           An  SNMP  application  that  uses the SNMP GETBULK request to effi-
           ciently query a network entity for a tree of information.



       snmpconf

           A configuration file setup command for agent.



       snmpdelta

           Monitors the specified integer valued OIDs, and report changes over
           time.



       snmpdf

           A networked version of the df(1M) command.



       snmpget

           Invokes  an  SNMP GET request to query for information on a network
           entity.



       snmpgetnext

           An SNMP application that uses the SNMP  GETNEXT  request  to  query
           information on a network entity.



       snmpinform

           An  SNMP  application  that  uses the SNMP INFORM operation to send
           information to a network manager.



       snmpnetstat

           Symbolically displays the values of various network-related  infor-
           mation retrieved from a remote system using the SNMP protocol.



       snmpset

           The SNMP SET request to set information on a network entity.



       snmpstatus

           An  SNMP  application  that  retrieves several important statistics
           from a network entity.



       snmptable

           An SNMP application that repeatedly uses the SNMP GETNEXT  or  GET-
           BULK requests to query for information on a network entity.



       snmptest

           An  SNMP  application  that can monitor and manage information on a
           network entity.



       snmptranslate

           An SNMP application that translates one or more SNMP object identi-
           fier  values from their symbolic (textual) forms into their numeri-
           cal forms (or vice-versa).



       snmptrap

           An SNMP application that uses  the  SNMP  TRAP  operation  to  send
           information to a network manager.



       snmpusm

           An SNMP application that can be used to do simple maintenance on an
           SNMP agent's User-based Security Module (USM) table.



       snmpvacm

           An SNMP application that can be used to do  simple  maintenance  on
           View-based Access Control (VACM) table.



       snmpwalk

           An SNMP application that uses SNMP GETNEXT requests to query a net-
           work entity for a tree of information.



       Some of these tools have common command line options which can be  seen
       in  the  snmpcmd  man page. Individual tools are described in their own
       man pages.

   Modules
       The modules listed below are available. These enable detailed  monitor-
       ing operations to be performed through SNMP.

       Host Resources MIB

           Defines  a uniform set of objects useful for the management of host
           computers. Host computers are independent of the operating  system,
           network services, or any software application.

           The Host Resources MIB defines objects which are common across many
           computer system architectures.  For  reference,  see  RFC  2790  at
           http://www.faqs.org/.



       MIB II

           efines  the  second  version of the Management Information Base for
           use with network management protocols in TCP/IP-based internets. It
           provides  a simple, system for managing these internets. For refer-
           ence, see RFC 1213 at http://www.ietf.org/.



       Sun MIB

           An extension of the MIB  II,  this  MIB  contains  Solaris-specific
           attributes.  Adds a table that lists all the currently running pro-
           cesses on the monitored host and  certain  performance  details  on
           that host.



       By default, the MIB files are located in /etc/sma/snmp/mibs.

   Module API Documentation
       The module API documentation describes some of the Net-SNMP helper APIs
       as well as other APIs needed to develop SNMP modules. The default loca-
       tion is /usr/sfw/doc/sma_snmp/html/modules.html.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE Interface StabilityExter-
       nal


SEE ALSO
       snmpstatus(1),   snmpconf(1M),   snmpd(1M),   snmpdf(1M),  snmpget(1M),
       snmpgetnext(1M),  snmpnetstat(1M),  snmpset(1M),   snmptrap(1M),   snm-
       pusm(1M),   snmpvacm(1M),  snmpwalk(1M),  snmp.conf(4),  snmpd.conf(4),
       snmp_variables(4), attributes(5)

       See the section 1M man pages for each  of  the  tools  described  under
       TOOLS, above.



SunOS 5.10                        16 Jan 2004                      sma_snmp(5)