{
    "mode": "man",
    "parameter": "snmpstatus",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/snmpstatus/1/json",
    "generated": "2026-06-03T04:27:42Z",
    "synopsis": "snmpstatus [COMMON OPTIONS] [-Cf] AGENT",
    "sections": {
        "NAME": {
            "content": "snmpstatus - retrieves a fixed set of management information from a network entity\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "snmpstatus [COMMON OPTIONS] [-Cf] AGENT\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "snmpstatus  is an SNMP application that retrieves several important statistics from a network\nentity.\n\nAGENT identifies a target SNMP agent, which is instrumented to monitor the given objects.  At\nits simplest, the AGENT specification will consist of a hostname or an IPv4 address.  In this\nsituation, the command will attempt communication with the agent, using UDP/IPv4 to port  161\nof the given target host.\n\nSee the snmpcmd(1) manual page for a full list of the possible formats for AGENT.\n\nThe information returned is:\n\nThe IP address of the entity.\nA textual description of the entity (sysDescr.0)\nThe uptime of the entity's SNMP agent (sysUpTime.0)\nThe sum of received packets on all interfaces (ifInUCastPkts.* + ifInNUCastPkts.*)\nThe  sum  of  transmitted  packets on all interfaces (ifOutUCastPkts.* + ifOutNUCastP‐\nkts.*)\nThe number of IP input packets (ipInReceives.0)\nThe number of IP output packets (ipOutRequests.0)\n\nFor example:\n\nsnmpstatus -c public -v 1 netdev-kbox.cc.cmu.edu\n\nwill produce output similar to the following:\n\n[128.2.56.220]=>[Kinetics FastPath2] Up: 1 day, 4:43:31\nInterfaces: 1,  Recv/Trans packets: 262874/39867 | IP: 31603/15805\n\nsnmpstatus also checks the operational status of all interfaces (ifOperStatus.*), and  if  it\nfinds any that are not running, it will report in a manner similar to this:\n\n2 interfaces are down!\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.   snmpstatus  will  attempt to reform its request to eliminate the malformed variable\n(unless the -Cf option is given, see below), but this variable will then be missing from  the\ndisplayed data.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "COMMON OPTIONS\nPlease  see  snmpcmd(1)  for  a  list of possible values for COMMON OPTIONS as well as\ntheir descriptions.\n",
            "subsections": [
                {
                    "name": "-Cf",
                    "content": "quest.  In  this  situation, the command will display the data that it can. If the -Cf\noption is specified, then snmpstatus will not try to fix errors, and  the  error  will\ncause the command to terminate.\n"
                }
            ]
        },
        "SEE ALSO": {
            "content": "snmpcmd(1), snmpget(1)\n\n\n\nV5.9.1                                       25 Jul 2003                               SNMPSTATUS(1)",
            "subsections": []
        }
    },
    "summary": "snmpstatus - retrieves a fixed set of management information from a network entity",
    "flags": [
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "quest. In this situation, the command will display the data that it can. If the -Cf option is specified, then snmpstatus will not try to fix errors, and the error will cause the command to terminate."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "snmpcmd",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/snmpcmd/1/json"
        },
        {
            "name": "snmpget",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/snmpget/1/json"
        }
    ],
    "tldr": {
        "source": "official",
        "description": "Fetch fixed MIB status values.",
        "examples": [
            {
                "description": "Fetch the values",
                "command": "snmpstatus -v {{version}} -c {{community}} {{ip_address}}"
            },
            {
                "description": "Display help",
                "command": "snmpstatus {{-h|--help}}"
            }
        ]
    }
}