getone(1M)                                                getone(1M)


       NAME
             getone - retrieve objects from an SNMP entity

       SYNOPSIS
             getone [-T timeout] entity_addr community_string
             object_name...

       DESCRIPTION
             The getone command is an SNMP application that retrieves a set
             of individual objects from an SNMP entity using a GET request.

             The arguments are the entity's address, the community string
             for access to the SNMP entity, and the fully qualified 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.

             Variable names must refer to a valid SNMP object or class of
             objects.  Variable names can be in the form of an identifier
             or the equivalent SNMP dot-notation.  Identifiers for UnixWare
             SNMP objects are listed in the section ``SNMP Objects'' in the
             chapter ``Network Management Using SNMP'' of part ``TCP/IP
             Administration'' of the book Network Administration.
             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.

             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.

       NOTES
             Since the function is a GET, as opposed to a GET-NEXT, the
             object must be fully qualified for the request to be
             successful.

             For instance:
                   getone suzzy public sysDescr.0 ifNumber.0




                           Copyright 1994 Novell, Inc.               Page 1

      getone(1M)                                                getone(1M)


            would return the objects sysDescr.0 and ifNumber.0, but the
            call
                  getone suzzy public system

            would return an error from the entity, since system is not a
            fully qualified SNMP object.

      REFERENCES
            getid(1M), getmany(1M), getnext(1M), getroute(1M), setany(1M),
            snmp(1M), RFC 1155, RFC 1157, RFC 1213.






































                          Copyright 1994 Novell, Inc.               Page 2