

---- Notes about scripts in the contrib directory ----

------------------------------------------------------------------
nrg-snmpwalk

usage: nrg-snmpwalk host community

nrg-snmpwalk does "snmpwalk" of the SNMP agent on "host" using
the SNMP read community string "community".  It only does 
"snmpwalk" on SNMP OIDs listed in etc/nrg-oid-names that start 
with dot.  FIXME Some of the SNMP OIDs listed in /etc/nrg-oid-names
are "fully qualified" so "nrg-snmpwalk" fails to return their
values.


------------------------------------------------------------------
rrdlastds 

usage: rrdlastds [-v] [-a] [-c num] [-l label] [-s stamp] some.rrd
  -v        print the start and end times (also --verbose)
  -a        autoscale DS values (also --autoscale)
  -c num    convert DS values by "num" (also --conversion)
  -l label  label DS values with "label" (also --label)
  -s time   report about DS values at the time "time" (also --start)

  The -s option supports the traditional "seconds since the Unix epoch"
  and the AT-STYLE time specification (see man rrdfetch)

rrdlastds prints details about the current DS values for a RRD.
It gets it's DS values from the RRA with the shortest time
resolution.  To simply print the current values, do
 
 rrdlastds some.rrd

To print the current values and describe the entire polling
interval to which they apply, do:

 rrdlastds some.rrd -v 

To print all the details about the data rrdlastds uses to report
the current values, do

 rrdlastds some.rrd -d

To report about DS values at some specific point in time, do

 rrdlastds some.rrd -s timestamp

To converty from bytes/sec to bits/sec and autoscale the values, do

 rrdlastds some.rrd -a -c 8 -l "bits/s"


------------------------------------------------------------------
rrdtrim

rrdtrim replaces DS values above a certain max value with a new
given value.

For example, given an RRD with data for traffic on a 56k
frame-relay circuit, you can "throw away" (set to NaN) any
values that exceed 56 kbits/sec (7000 bytes/sec) by executing:

 rrdtrim some.rrd 7000 NaN 


