This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

SNMPDELTA(1)                                      Net-SNMP                                      SNMPDELTA(1)



NAME
       snmpdelta - Monitor delta differences in SNMP Counter values

SYNOPSIS
       snmpdelta  [  common options ] [-Cf] [ -Ct ] [ -Cs ] [ -CS ] [ -Cm ] [ -CF configfile ] [ -Cl ] [ -Cp
       period ] [ -CP Peaks ] [ -Ck ] [ -CT ] AGENT OID [ OID ... ]

DESCRIPTION
       snmpdelta will monitor the specified integer valued OIDs, and report changes over time.

       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.  In this situation,
       the command will attempt communication with the agent, using UDP/IPv4 to port 161 of the given target
       host. See snmpcmd(1) for a full list of the possible formats for AGENT.

       OID is an object identifier which uniquely identifies the object type within a MIB. Multiple OIDs can
       be specified on a single snmpdelta command.


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

       -Cf     Don't  fix  errors  and  retry  the request.  Without this option, if multiple oids have been
               specified for a single request and if the request for one or more of  the  oids  fails,  snm-pdelta snmpdelta
               pdelta  will  retry  the  request  so that data for oids apart from the ones that failed will
               still be returned.  Specifying -Cf tells snmpdelta not to retry a request, even if there  are
               multiple oids specified.

       -Ct     Flag will determine time interval from the monitored entity.

       -Cs     Flag will display a timestamp.

       -CS     Generates  a  "sum  count" in addition to the individual instance counts.  The "sum count" is
               the total of all the individual deltas for each time period.

       -Cm     Prints the max value ever attained.

       -CF configfile
               Tells snmpdelta to read it's configuration from the specified file.  This options allows  the
               input to be set up in advance rather than having to be specified on the command line.

       -Cl     Tells  snmpdelta  to  write  it's  configuration  to  files whose names correspond to the MIB
               instances monitored.  For example, snmpdelta -Cl localhost ifInOctets.1 will  create  a  file
               "localhost-ifInOctets.1".

       -Cp     Specifies  the  number  of  seconds  between  polling periods.  Polling constitutes sending a
               request to the agent. The default polling period is one second.

       -CP peaks
               Specifies the reporting period in number of polling periods.  If this  option  is  specified,
               snmpdelta  polls  the  agent  peaks number of times before reporting the results.  The result
               reported includes the average value over the  reporting  period.  In  addition,  the  highest
               polled value within the reporting period is shown.

       -Ck     When the polling period (-Cp) is an increment of 60 seconds and the timestamp is displayed in
               the output (-Cs), then the default display shows the timestamp in  the  format  hh:mm  mm/dd.
               This option causes the timestamp format to be hh:mm:ss mm/dd.

       -CT     Makes snmpdelta print its output in tabular form.

       -Cv vars/pkt
               Specifies  the  maximum  number of oids allowed to be packaged in a single PDU. Multiple PDUs
               can be created in a single request. The default value of variables per packet  is  60.   This
               option is useful if a request response results in an error becaues the packet is too big.

EXAMPLES
       $ snmpdelta -c public -v 1 -Cs localhost IF-MIB::ifInUcastPkts.3 IF-MIB::ifOutUcastPkts.3
       [20:15:43 6/14] ifInUcastPkts.3 /1 sec: 158
       [20:15:43 6/14] ifOutUcastPkts.3 /1 sec: 158
       [20:15:44 6/14] ifInUcastPkts.3 /1 sec: 184
       [20:15:44 6/14] ifOutUcastPkts.3 /1 sec: 184
       [20:15:45 6/14] ifInUcastPkts.3 /1 sec: 184
       [20:15:45 6/14] ifOutUcastPkts.3 /1 sec: 184
       [20:15:46 6/14] ifInUcastPkts.3 /1 sec: 158
       [20:15:46 6/14] ifOutUcastPkts.3 /1 sec: 158
       [20:15:47 6/14] ifInUcastPkts.3 /1 sec: 184
       [20:15:47 6/14] ifOutUcastPkts.3 /1 sec: 184
       [20:15:48 6/14] ifInUcastPkts.3 /1 sec: 184
       [20:15:48 6/14] ifOutUcastPkts.3 /1 sec: 184
       [20:15:49 6/14] ifInUcastPkts.3 /1 sec: 158
       [20:15:49 6/14] ifOutUcastPkts.3 /1 sec: 158
       ^C
       $ snmpdelta -c public -v 1 -Cs -CT localhost IF-MIB:ifInUcastPkts.3 IF-MIB:ifOutcastPkts.3
       localhost ifInUcastPkts.3     ifOutUcastPkts.3
       [20:15:59 6/14]     184.00    184.00
       [20:16:00 6/14]     158.00    158.00
       [20:16:01 6/14]     184.00    184.00
       [20:16:02 6/14]     184.00    184.00
       [20:16:03 6/14]     158.00    158.00
       [20:16:04 6/14]     184.00    184.00
       [20:16:05 6/14]     184.00    184.00
       [20:16:06 6/14]     158.00    158.00
       ^C

       The  following example uses a number of options. Since the Cl option is specified, the output is sent
       to a file and not to the screen.

       $ snmpdelta -c public -v 1 -Ct -Cs -CS -Cm -Cl -Cp 60 -CP 60
         interlink.sw.net.cmu.edu .1.3.6.1.2.1.2.2.1.16.3 .1.3.6.1.2.1.2.2.1.16.4
       fi

SEE ALSO
       snmpcmd(1), variables(5).



4th Berkeley Distribution                        25 Jul 2003                                    SNMPDELTA(1)