getmany(1M) — DG/UX 5.4R3.00



snmpgetmany(1M)                TCP/IP 5.4R3.00               snmpgetmany(1M)


NAME
       snmpgetmany, getmany - get MIB-subtrees from SNMP agent,

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

   where:
       host is a hostname or Internet address
       community is a community string
       object is a class name (subtree)

DESCRIPTION
       Use the snmpgetmany command to query portions of a MIB.  The
       snmpgetmany 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 snmpgetmany command will
       fail because of a timeout.  If community does have read access, the
       agent will return the value of object that lexicographically follows
       object.  Lexicographical ordering is determined by the MIB definition
       (object ID), not the spelling of the objects name.  The snmpgetmany
       command prints the response and builds a new request specifying the
       new object returned by the agent.  This process continues until the
       object returned by the agent is no longer is a member of the subtree
       containing object.

       If object  is specified as iso (the root of all MIBs), the entire MIB
       can be obtained from the SNMP Agent.

       The snmpgetmany command is new in DG/UX 5.4R3.00 and has a different
       output format than the original getmany command.  The getmany command
       is provided for backward compatibility, but it will be removed in a
       future release.

       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.

       The object is specified as either an object type, subtree, or group
       name.  You can specify object in either dot-notation representing an
       object identifier or as a text string representing an object
       descriptor.

       Options are:

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

       -t     Display the data type of the object in addition to it's name
              and value.




Licensed material--property of copyright holder(s)                         1



snmpgetmany(1M)                TCP/IP 5.4R3.00               snmpgetmany(1M)


EXAMPLES
       The first example shows snmpgetmany retrieving the system group.
       $ snmpgetmany myhost public system
       sysDescr.0 = DG/UX TCP/IP SNMP AGENT
       sysObjectID.0 = dguxOnAviion
       sysUpTime.0 = 1342175
       sysContact.0 = myname@myhost
       sysName.0 = myhost
       sysLocation.0 = Hall 106 Office 1
       sysServices.0 = 72

       The second example shows how snmpgetmany is used to retrieve the
       entire MIB.
       $ snmpgetmany myhost public iso
       sysDescr.0 = DG/UX TCP/IP SNMP AGENT
       sysObjectID.0 = DataGeneral
       .
       .
       .
       udpLocalPort.0.0.0.0.1212 = 1212
       udpLocalPort.0.0.0.0.2049 = 2049
       End of MIB.


DIAGNOSTICS
       Exit status is 0 upon success.

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

       Exit status is 1 if there is an error returned from the agent.

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






















Licensed material--property of copyright holder(s)                         2

Museum

Related Articles