@(#) $Name: arts++-1-1-a13 $ $Id: artsases.man,v 1.1.1.1 2002/11/16 00:46:38 rkoga Exp $
artsases l LOCAL
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