artsnets

artsnets(l)                                                          artsnets(l)



NAME
       artsnets - utility to display net matrix objects from ARTS files

SYNOPSIS
       artsnets [-v] [-r] [-p] [-i ifIndexList] [-l maxEntries]
                [-s srcNet/masklen] [-d dstNet/masklen]
                [-b beginTime] [-e endTime] infile(s)

DESCRIPTION
       artsnets is a utility that reads net matrix objects from ARTS files
       (infile(s)) and displays a summary of their contents on stdout.

OPTIONS
       -v     The -v option causes artsnets to print version information and
              exit immediately.

       -r     The -r option will cause the traffic rates (pkts/sec and bits/sec)
              to be printed instead of packets and bytes.

       -p     The -p option will cause the entries to be sorted in descending
              order by packet count before being printed on stdout.  The default
              is to sort in descending order by byte count.

       -i ifIndexList
              The -i ifIndexList option may be used to select only data which
              contains an interface index attribute in ifIndexList.  In other
              words, the -i ifIndexList option lets you select data from
              particular interfaces or sets of interfaces.  ifIndexList may
              contain hyphens (indicating an inclusive range) and commas.  For
              example, -i 1,2,5-8 would select data with an interface index
              attribute of 1, 2, 5, 6, 7 or 8.

       -l maxEntries
              The -l maxEntries option will cause only the first maxEntries net
              matrix entries to be shown for each net matrix object.

       -s srcNet/masklen
              The -s srcNet/masklen option will cause only entries with a source
              network address equal to srcNet and a source netmask length of
              masklen (or greater) to be shown.

       -d dstNet/masklen
              The -s dstNet/masklen option will cause only entries with a
              destination network address equal to dstNet and a destination
              netmask length of masklen (or greater) to be shown.

       -b beginTime
              The -b beginTime option may be used to select only the data which
              is from a time period at or later than beginTime.  beginTime must
              be of the form 'MM/DD/CCYY hh:mm:ss' and must be enclosed in
              quotes.  Example:

                '8/31/1999 09:00:00'

       -e endTime
              The -e endTime option may be used to select only the data which is
              from a time period at or before endTime.  endTime must be of the
              form 'MM/DD/CCYY hh:mm:ss' and must be enclosed in quotes.
              Example:

                '8/31/1999 09:00:00'

EXAMPLES
       artsnets arts.19980821

       artsnets -s 166.48.0.0/16 arts.19980821

SEE ALSO
       artsagg(l), artsnetagg(l), artsdump(l), artsases(l), artsasagg(l),
       artsportmagg(l), artsportms(l), artsports(l), artsprotoagg(l),
       artsprotos(l), artstoc(l), artsintfmagg(l), artsintfms(l),
       artsnexthops(l), artsnexthopagg(l), artstos(l)

ACKNOWLEDGEMENTS
       artsnets and documentation written by Daniel W. McRobb
       CAIDA, August 1998




                                      LOCAL                          artsnets(l)