Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, March 14, 2019
 
 

snmpget (1)

Name

snmpget - communicates with a network entity using SNMP GET requests

Synopsis

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

Description

SNMPGET(1)                         Net-SNMP                         SNMPGET(1)



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

SYNOPSIS
       snmpget [COMMON OPTIONS] [-Cf] AGENT 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 (snmpdelta, snmpget,
               snmpgetnext  and snmpstatus) 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 takes the common options described
       in the snmpcmd(1) manual page.  Note that snmpget REQUIRES an  argument
       specifying  the  agent  to  query  and  at  least  one OID argument, as
       described there.

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 snm-
       pcmd(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:

           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(7) 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://github.com/oracle/solaris-userland.    The  original  community
       source  was  downloaded  from   http://ftp.ntua.gr/mirror/net-snmp/net-
       snmp/5.7.3/net-snmp-5.7.3.tar.gz

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



V5.7.3                            18 Jun 2007                       SNMPGET(1)