snmpgetone(1M)                 DG/UX R4.11MU05                snmpgetone(1M)


NAME
       snmpgetone - get MIB-object from SNMP agent

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

   where:
       host is a hostname or Internet address
       community is a community string
       object is a fully qualified object name

DESCRIPTION
       Use the snmpgetone command to retrieve the values for MIB objects
       from an SNMP agent.  The snmpgetone 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
       snmpgetone will fail due to a timeout.  If community does have read
       access, the agent returns the value for object.  If any of the
       objects in the request do not exist, the entire request will fail
       with a "No such variable name" message.

       Specify host as either a hostname or as 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 specified must be fully qualified, which means that it
       should represent an object instance instead of an object type.  For
       example, sysDescr represents an object type while sysDescr.0
       represents an object instance.  You may specify the object in either
       dot-notation representing the object identifier or as a text string
       representing the 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.

EXAMPLE
       $ snmpgetone myhost public sysDescr.0 sysUpTime.0 1.3.6.1.2.1.2.1.1
       sysDescr.0 =  DG/UX TCP/IP SNMP AGENT
       sysUpTime.0 = 964922
       ifNumber.0 = 2


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
       snmpgetmany(1M), snmpgetnext(1M), snmpsetany(1M), snmptraprecv(1M),
       snmptrapsend(1M), snmpgettab(1M), snmpd(1M), snmpd.conf(4M),
       snmpdfiles(4M).


Licensed material--property of copyright holder(s)