getnext(1Msnmp)

getnext -- retrieve objects from SNMP entity

Synopsis

getnext [-f defn_file] [-T timeout] entity_addr community_string object_name . . .

Description

The getnext command is an SNMP application that retrieves one or more individual objects from an SNMP entity. The getnext command returns the object and value pair(s) that appear in the MIB database immediately after the object(s) specified on the commmand line.

The arguments are the entity's address, the community string for access to the SNMP entity, and the object name(s).

The entity address can be either an IP address or entity name (if name-to-address resolution is enabled).

The community string used must be valid on the given entity. On UnixWare, community strings are kept in /etc/netmgt/snmpd.comm.

Object names must refer to a valid SNMP object or class of objects. Object names can be in the form of an identifier or the equivalent SNMP dot-notation. Identifiers for UnixWare SNMP objects are listed in ``UnixWare group and object descriptions'' in Configuring and administering SNMP. Equivalent SNMP dot-notation for these objects is defined in the files /etc/netmgt/nwumpsd.defs, /etc/netmgt/snmpd.defs, and /etc/netmgt/unixwared.defs. For a general explanation of SNMP dot-notation, see RFC 1213.

If an object on the command line is a group name, then the object and value returned is the first object-value pair in the group.

Options

The -f option is used to specify a file containing the mosy(1Msnmp) and post_mosy(1Msnmp) compiled list of object names and their numeric Object Identifiers, in addition to the objects in the standard MIB. This allows the user to dynamically augment the number of objects that can be recognized by the management utility.

The -T option can be used to specify the number of seconds the command will wait for a response from the entity specified by entity_addr. If not specified, this defaults to 20 seconds.

Examples

The following example uses two object group names, and returns the first member of each group specified.

getnext suzzy public system interfaces

getnext returns the variables sysDescr.0 and ifNumber.0, which are the first members of the system and interfaces groups, respectively.

Name: sysDescr.0 Value: SCO UnixWare 2.0

Name: ifNumber.0 Value: 2

References

getid(1Msnmp), getmany(1Msnmp), getone(1Msnmp), getroute(1Msnmp), mosy(1Msnmp), post_mosy(1Msnmp), setany(1Msnmp), snmp(1Msnmp)

RFC 1155, RFC 1157, RFC 1213