# phpman > man > SNMPGET(1)

> **TLDR:** Query using the SNMP protocol.
>
- Request a single value from the SNMP agent:
  `snmpget -v {{version}} -c {{community}} {{ip_address}} {{oid}}`
- Display the full Object Identifier (OID) path:
  `snmpget -v {{version}} -c {{community}} -O f {{ip_address}} {{oid}}`
- Display help:
  `snmpget {{-h|--help}}`

*Source: tldr-pages*

---

[SNMPGET(1)](https://www.chedong.com/phpMan.php/man/SNMPGET/1/markdown)                                    Net-SNMP                                    [SNMPGET(1)](https://www.chedong.com/phpMan.php/man/SNMPGET/1/markdown)



## 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  com‐
       mand line.  Each variable name is given in the format specified in [_variables(5)](https://www.chedong.com/phpMan.php/man/variables/5/markdown)_.

## OPTIONS
### -Cf -Cf
               **status**) will try to fix errors returned by the agent that you were talking to and re‐
               send 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)](https://www.chedong.com/phpMan.php/man/snmpcmd/1/markdown)_ man‐
       ual 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 re‐
       turned  and  a  message  will  be shown, helping to pinpoint in what way the request was mal‐
       formed.  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)](https://www.chedong.com/phpMan.php/man/snmpcmd/1/markdown)_ 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.

## SEE ALSO
       [snmpcmd(1)](https://www.chedong.com/phpMan.php/man/snmpcmd/1/markdown), [snmpwalk(1)](https://www.chedong.com/phpMan.php/man/snmpwalk/1/markdown), [variables(5)](https://www.chedong.com/phpMan.php/man/variables/5/markdown).



V5.9.1                                       18 Jun 2007                                  [SNMPGET(1)](https://www.chedong.com/phpMan.php/man/SNMPGET/1/markdown)