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