snmpgetnext(1M)                 TCP/IP R4.11                 snmpgetnext(1M)


NAME
       snmpgetnext - get MIB-objects from SNMP agent

SYNOPSIS
       snmpgetnext [-n][-t] host community object ...

   where:
       host is a hostname or Internet address
       community is a community string
       object is a object type or object instance

DESCRIPTION
       Use the snmpgetnext command to retrieve values for MIB objects from
       an SNMP agent.  The snmpgetnext command sends a request for object to
       the agent running on host.  The agent authenticates the request by
       checking that community has read access to object.  If community does
       not have read access the request is discarded, and the snmpgetnext
       command will fail with a timeout.  If community has read access, the
       agent will return the value for the MIB object that lexicographically
       follows object.  Lexicographical ordering is determined by the MIB
       definition (object ID), not the spelling of the object's name.

       Specify host as either a hostname or an Internet address in dot-
       notation.

       The community string is a text string used by the agent to
       authenticate the request.  You must configure the agent to allow read
       access for community for the operation to be successful.

       Specify object as either an object type or object instance.  You may
       specify object in either dot-notation representing an object
       identifier or as a text string representing an object descriptor.

       Options are:

       -n     Display Object IDs in a numeric format instead of translating
              them into a symbolic name.

       -t     Display the data type of the object in addition to its name
              and value.

EXAMPLES
       This example shows how to use snmpgetnext and demonstrates the
       differences between object types, object instances, object
       descriptors (names) and object IDs (numbers).
       $ snmpgetnext myhost public sysDescr sysDescr.0  1.3.6.1.2.1.2
       sysDescr.0 = DG/UX TCP/IP SNMP AGENT
       sysObjectID.0 = DataGeneral
       ifNumber.0 = 2

       In this example the object type sysDescr was specified, and the agent
       returned the first (and only) instance for sysDescr, sysDescr.0.  The
       2nd object is specified as an object instance, sysDescr.0, the agent
       returned the next instance from the system group, sysObjectID.0.
       Lastly, object identifier for ifTable, 1.3.6.1.2.1.2 is specified,
       and the agent returned the first instance from the ifTable,
       ifNumber.0.

DIAGNOSTICS
       Exit status is 0 upon success.

       Exit status is -1 if there are errors parsing the command line.

       Exit status is 1 if the agent returns an error.

SEE ALSO
       snmpgetone(1M), snmpgetmany(1M), snmpsetany(1M), snmptraprecv(1M),
       snmptrapsend(1M), snmpgettab(1M), snmpd(1M), snmpd.conf(4M),
       snmpd_files(4M).


Licensed material--property of copyright holder(s)