Configuring the Simple Network Management Protocol (SNMP)

Referring to object instances in commands

Many SNMP commands require an SNMP object name or identifier as one of the command arguments.

The section ``SNMP objects'' lists the object identifiers defined on UnixWare. When using the object identifiers in a command, you need to append an instance identifier that uniquely identifies the value you want to display or set.

For single-instance objects (such as sysDescr, you append a ``0'' to the identifier. So, for example, you would type

getone remotesystem public sysDescr.0

to get the value of the sysDescr object on remotesystem.

For multiple-instance objects, such as a table of distinct instances of the same object type, you would append an appropriate instance identifier that essentially specifies the row of the table in which you are interested. So, for example, to display the instance of the object ifType that corresponds to ifEntry.2 (the second interface listed in the interface table), you would type:

getone remotesystem public ifType.2

Note that the instance identifier is highly dependent on the type of data represented. For example, to get a particular object value associated with a particular network address (for example,, you might have to append the network address to the object identifier, as in

getone remotesystem public ipRouteInfo.

While the conventions for instance identifiers can be quite complex, they are easier to understand if you print out an entire group of objects from the MIB (or the entire MIB) and look at the object identifiers/instance identifiers for specific values. Then refer to the object descriptions in ``SNMP objects'', and the object definitions in /etc/netmgt/*.defs and in RFC 1213 for additional clarification.

© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 22 April 2004