artsports(l)

NAME
artsports - utility to display port table objects from ARTS files

SYNOPSIS
artsports [-v] [-n] [-p] [-t] [-i ifIndex] [-l maxEntries]
          [[-b beginTime] [-e endTime] infile(s)

DESCRIPTION
artsports is a utility that reads port table objects and selected port table objects from ARTS files (infile(s)) and displays a summary of their contents on stdout. When encountering a selected port table object, it will print the selected ports that were used to generate the selected port table object.

OPTIONS

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

-n  The -n option causes artsports to skip service name lookups for port numbers, and just print the port numbers.

-p  The -p option will cause the entries to be sorted in descending order by packet count (sum of both input and output packets) before being printed on stdout. The default is to sort in descending order by byte count (sum of both input and output bytes).

-t  The -t option will cause the total packets and bytes per port (the sume of input and output) to be shown, instead of separate input and output counters. When using this option, the total rates (packets/sec and bits/sec) will also be shown per port.

-i ifIndex
    The -i ifIndexList option permits selecting only data for a specific input interface or set of input interfaces. Selection is by the interface's ifIndex stored in the attribute section of the input Arts objects.

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

-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

artsports -t -i 1,3-5 -l 20 -b '08/21/1998 09:00:00' arts.19980821

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

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