snmpget (1)

Name

snmpget - communicates with a network entity using SNMP GET requests

Synopsis

snmpget [COMMON OPTIONS] [-Cf] OID [OID]...

Description

Net-SNMP                                               SNMPGET(1)



NAME
     snmpget  - communicates with a network entity using SNMP GET
     requests

SYNOPSIS
     snmpget [COMMON OPTIONS] [-Cf] OID [OID]...

DESCRIPTION
     snmpget is an  SNMP  application  that  uses  the  SNMP  GET
     request  to  query for information on a network entity.  One
     or more object identifiers (OIDs) may be given as  arguments
     on  the  command  line.   Each variable name is given in the
     format specified in variables(5).

OPTIONS
     -Cf     If -Cf is not  specified,  some  applications  (snm-
             pdelta,  snmpget, snmpgetnext will try to fix errors
             returned by the agent that you were talking  to  and
             resend  the  request.   The only time this is really
             useful is if you specified a OID that  didn't  exist
             in  your  request  and  you're  using  SNMPv1  which
             requires "all or nothing" kinds of requests.

     In addition to this option,  snmpget  REQUIRES  options  and
     agent arguments, as described in the snmpcmd(1) manual page.

EXAMPLES
     The command:

         snmpget -c public zeus system.sysDescr.0

     will retrieve the variable system.sysDescr.0 from  the  host
     zeus using the community string public :

         system.sysDescr.0  =  "SunOS zeus.net.cmu.edu 4.1.3_U1 1
     sun4m"

     If the network entity has an error  processing  the  request
     packet,  an error packet will be returned and a message will
     be shown, helping to pinpoint in what way  the  request  was
     malformed.   If  there  were other variables in the request,
     the request will be resent without the bad variable.

     Here is another example. The -c and -v options  are  defined
     in  the  snmpcmd(1) manual page. (Note that system.sysUpTime
     is an incomplete OID, as it needs the .0 index  appended  to
     it):

         snmpget -v1 -Cf -c public localhost system.sysUpTime system.sysContact.0

     This example will return the following:




V5.4.1               Last change: 08 Feb 2002                   1






Net-SNMP                                               SNMPGET(1)



         Error in packet
         Reason: (noSuchName) There is no such variable name in this MIB.
         This name doesn't exist: system.sysUpTime

     Similarly, the command:
         snmpget -v1 -c public localhost system.sysUpTime system.sysContact.0

     Will return:

         Error in packet
         Reason: (noSuchName) There is no such variable name in this MIB.
         This name doesn't exist: system.sysUpTime

         system.sysContact.0 = STRING: root@localhost

     With  the -Cf flag specified the application will not try to
     fix the PDU for you.


ATTRIBUTES
     See  attributes(5)  for  descriptions   of   the   following
     attributes:

     +---------------+-----------------------------------------------+
     |ATTRIBUTE TYPE |               ATTRIBUTE VALUE                 |
     +---------------+-----------------------------------------------+
     |Availability   | system/management/snmp/net-snmp/documentation |
     +---------------+-----------------------------------------------+
     |Stability      | Volatile                                      |
     +---------------+-----------------------------------------------+
SEE ALSO
     snmpcmd(1), snmpwalk(1), variables(5).



NOTES
     This   software   was   built   from   source  available  at
     https://java.net/projects/solaris-userland.   The   original
     community       source       was       downloaded       from
     http://ftp.ntua.gr/mirror/net-snmp/OldFiles/net-
     snmp-5.4.x/5.4.1/net-snmp-5.4.1.tar.gz

     Further  information about this software can be found on the
     open source community website at http://www.net-snmp.org/.











V5.4.1               Last change: 08 Feb 2002                   2