CentOS 7.0 - man page for snmpstatus (centos section 1)

Linux & Unix Commands - Search Man Pages

Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


SNMPSTATUS(1)				     Net-SNMP				    SNMPSTATUS(1)

NAME
       snmpstatus - retrieves a fixed set of management information from a network entity

SYNOPSIS
       snmpstatus [COMMON OPTIONS] [-Cf] AGENT

DESCRIPTION
       snmpstatus  is an SNMP application that retrieves several important statistics from a net-
       work entity.

       AGENT identifies a target SNMP agent, which is instrumented to monitor the given  objects.
       At its simplest, the AGENT specification will consist of a hostname or an IPv4 address.	n
       this situation, the command will attempt communication with the agent, using  UDP/IPv4  to
       port 161 of the given target host.

       See the snmpcmd(1) manual page for a full list of the possible formats for AGENT.

       The information returned is:

	      The IP address of the entity.
	      A textual description of the entity (sysDescr.0)
	      The uptime of the entity's SNMP agent (sysUpTime.0)
	      The sum of received packets on all interfaces (ifInUCastPkts.* + ifInNUCastPkts.*)
	      The  sum of transmitted packets on all interfaces (ifOutUCastPkts.* + ifOutNUCastP-
	      kts.*)
	      The number of IP input packets (ipInReceives.0)
	      The number of IP output packets (ipOutRequests.0)

       For example:

       snmpstatus -c public -v 1 netdev-kbox.cc.cmu.edu

       will produce output similar to the following:

       [128.2.56.220]=>[Kinetics FastPath2] Up: 1 day, 4:43:31
       Interfaces: 1,  Recv/Trans packets: 262874/39867 | IP: 31603/15805

       snmpstatus also checks the operational status of all interfaces (ifOperStatus.*),  and  if
       it finds any that are not running, it will report in a manner similar to this:

       2 interfaces are down!

       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 mal-
       formed.	snmpstatus will attempt to reform its request to eliminate the malformed variable
       (unless the -Cf option is given, see below), but this variable will then be  missing  from
       the displayed data.

OPTIONS
       COMMON OPTIONS
	      Please  see  snmpcmd(1) for a list of possible values for COMMON OPTIONS as well as
	      their descriptions.

       -Cf    By default, snmpstatus will try to fix errors returned by the  agent  and  retry	a
	      request.	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.

SEE ALSO
       snmpcmd(1), snmpget(1)

V5.7.2					   25 Jul 2003				    SNMPSTATUS(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 02:55 AM.

Unix & Linux Forums Content Copyright©1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password





Not a Forum Member?
Forgot Password?