unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

snmpstatus(1)                    User Commands                   snmpstatus(1)



NAME
       snmpstatus - retrieve important information from a network entity

SYNOPSIS
       /usr/sfw/bin/snmpstatus [common options] [-Cf] agent

DESCRIPTION
       The  snmpstatus  command  is an SNMP application that retrieves several
       important statistics from a network entity.

       The agent operand identifies a target SNMP agent, which is instrumented
       to  monitor specified objects. At its simplest, the agent specification
       consists of a host name or an IPv4 address. In this situation, the com-
       mand  attempts  communication with the agent using UDP/IPv4 to port 161
       of the target host.

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

       snmpstatus returns the following information:

         o  the IP address of the entity

         o  a textual description of the entity (sysDescr.0)

         o  the uptime of the entity's SNMP agent (sysUpTime.0)

         o  the  sum  of received packets on all interfaces (ifInUCastPkts.* +
            ifInNUCastPkts.*)

         o  the sum of transmitted packets on all interfaces (ifOutUCastPkts.*
            + ifOutNUCastPkts.*)

         o  the number of IP input packets (ipInReceives.0)

         o  the number of IP output packets (ipOutRequests.0)


       For example, the command:

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

       produces 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 (ifOp-
       erStatus.*). If it finds any that are not running, it reports themin  a
       manner similar to this:

       2 interfaces are down!

       If  the  network  entity has an error processing the request packet, an
       error packet is returned and a message is displayed,  helping  to  pin-
       point  the  way  in  which  the  request was malformed. 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
       The following options are supported:

       common options

           See snmpcmd(1M) 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. With this option, the command will display the
           data  that  it  can.  snmpstatus  will not try to fix errors and an
           error will cause the command to terminate.



EXIT STATUS
       0

           Successful completion.



       1

           A usage syntax error. A usage message is displayed. Also  used  for
           timeout errors.



       2

           An  error occurred while executing the command. An error message is
           displayed.



ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).   ATTRIBUTE  TYPEATTRIBUTE  VALUE  AvailabilitySUNWsmcmd
       Interface StabilityExternal


SEE ALSO
       snmpcmd(1M), snmpget(1M), attributes(5)



SunOS 5.10                        20 Jan 2004                    snmpstatus(1)