artsases

artsases(l)                                                        artsases(l)



NAME
       artsases - utility to display AS matrix objects from ARTS files

SYNOPSIS
       artsases [-v] [-p] [-r] [-i ifIndexList] [-l maxEntries]
                [-t AS] [-s srcAS] [-d dstAS] [-b beginTime]
                [-e endTime] infile(s)

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

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

       -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.

       -r     When using the -t AS option, the default output shows the total
              byte and packet counters only.  If you also use the -r option,
              the output will contain packet and bit rates instead of packet
              and byte totals.

       -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 AS
              matrix entries to be shown for each AS matrix object.

       -t AS  The -t AS option will cause only the total traffic for AS to be
              shown.  This is convenient when you wish to see the total amount
              of traffic to and from a particular AS.

       -s srcAS
              The -s srcAS option causes only entries with a source AS equal
              to srcAS to be shown.  This permits selecting only traffic from
              a particular AS.

       -d dstAS
              The -d dstAS option causes only entries with a destination AS
              equal to dstAS to be shown.  This permits selecting only traffic
              to a particular AS.

       -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
       artsases arts.19980821

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

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




                                     LOCAL                         artsases(l)