{
    "mode": "man",
    "parameter": "snmpget",
    "section": "",
    "url": "https://www.chedong.com/phpMan.php/man/snmpget/json",
    "generated": "2026-06-15T19:54:48Z",
    "synopsis": "snmpget [COMMON OPTIONS] [-Cf] AGENT OID [OID]...",
    "sections": {
        "NAME": {
            "content": "snmpget - communicates with a network entity using SNMP GET requests\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "snmpget [COMMON OPTIONS] [-Cf] AGENT OID [OID]...\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "snmpget  is  an SNMP application that uses the SNMP GET request to query for information on a\nnetwork entity.  One or more object identifiers (OIDs) may be given as arguments on the  com‐\nmand line.  Each variable name is given in the format specified in variables(5).\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "-Cf -Cf",
                    "content": "status) will try to fix errors returned by the agent that you were talking to and re‐\nsend the request.  The only time this is really useful is if you specified a OID that\ndidn't exist in your request and you're using SNMPv1 which requires \"all or  nothing\"\nkinds of requests.\n\nIn addition to this option, snmpget takes the common options described in the snmpcmd(1) man‐\nual page.  Note that snmpget REQUIRES an argument specifying the agent to query and at  least\none OID argument, as described there.\n"
                }
            ]
        },
        "EXAMPLES": {
            "content": "The command:\n\nsnmpget -c public zeus system.sysDescr.0\n\nwill  retrieve  the  variable system.sysDescr.0 from the host zeus using the community string\npublic :\n\nsystem.sysDescr.0 = \"SunOS zeus.net.cmu.edu 4.1.3U1 1 sun4m\"\n\nIf the network entity has an error processing the request packet, an error packet will be re‐\nturned  and  a  message  will  be shown, helping to pinpoint in what way the request was mal‐\nformed.  If there were other variables in the request, the request will be resent without the\nbad variable.\n\nHere  is  another  example.  The -c and -v options are defined in the snmpcmd(1) manual page.\n(Note that system.sysUpTime is an incomplete OID, as it needs the .0 index appended to it):\n\nsnmpget -v1 -Cf -c public localhost system.sysUpTime system.sysContact.0\n\nThis example will return the following:\n\nError in packet\nReason: (noSuchName) There is no such variable name in this MIB.\nThis name doesn't exist: system.sysUpTime\n\nSimilarly, the command:\nsnmpget -v1 -c public localhost system.sysUpTime system.sysContact.0\n\nWill return:\n\nError in packet\nReason: (noSuchName) There is no such variable name in this MIB.\nThis name doesn't exist: system.sysUpTime\n\nsystem.sysContact.0 = STRING: root@localhost\n\nWith the -Cf flag specified the application will not try to fix the PDU for you.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "snmpcmd(1), snmpwalk(1), variables(5).\n\n\n\nV5.9.1                                       18 Jun 2007                                  SNMPGET(1)",
            "subsections": []
        }
    },
    "summary": "snmpget - communicates with a network entity using SNMP GET requests",
    "flags": [
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "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) 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.3U1 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) 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": [
        {
            "name": "snmpcmd",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/snmpcmd/1/json"
        },
        {
            "name": "snmpwalk",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/snmpwalk/1/json"
        },
        {
            "name": "variables",
            "section": "5",
            "url": "https://www.chedong.com/phpMan.php/man/variables/5/json"
        }
    ],
    "tldr": {
        "source": "official",
        "description": "Query using the SNMP protocol.",
        "examples": [
            {
                "description": "Request a single value from the SNMP agent",
                "command": "snmpget -v {{version}} -c {{community}} {{ip_address}} {{oid}}"
            },
            {
                "description": "Display the full Object Identifier (OID) path",
                "command": "snmpget -v {{version}} -c {{community}} -O f {{ip_address}} {{oid}}"
            },
            {
                "description": "Display help",
                "command": "snmpget {{-h|--help}}"
            }
        ]
    }
}