getone(1M)                      TCP/IP 5.4.2                      getone(1M)


NAME
       getone - get MIB-object from SNMP agent

SYNOPSIS
       getone 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 getone command to retrieve object instances from an SNMP
       agent.  The getone command sends an SNMP message containing the
       community string and a GetRequest-PDU requesting the specified object
       from the agent running on host.

       Specify the 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 accept
       requests from the specified 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.

EXAMPLE
       $ getone myhost public sysDescr.0 sysUpTime.0 1.3.6.1.2.1.2.1.1

       Name: sysDescr.0
       Value: DG/UX TCP/IP SNMP AGENT

       Name: sysUpTime.0
       Value: 964922

       Name: ifNumber.0
       Value: 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
       getmany(1M), getnext(1M), setany(1M), snmpd(1M), traprecv(1M),



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

getone(1M)                      TCP/IP 5.4.2                      getone(1M)


       trapsend(1M), snmpd.communities(4M), snmpd.config(4M),
       snmpd.trapcommunities(4M).























































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