artsportms(l)

NAME
artsportms - utility to display port matrix objects from ARTS files

SYNOPSIS
artsportms [-v] [-p] [-i ifIndex] [-l maxEntries] [-s srcPort]
           [-d dstPort] [-b beginTime] [-e endTime] infile(s)

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

OPTIONS

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

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

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

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

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

-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

artsportms arts.19980821

SEE ALSO
artsportmagg(l), artsports(l), artsportagg(), artsdump(l), artsases(l), artsasagg(l), artsnets(l), artsnetagg(l), artsprotoagg(l), artsprotos(l), artstoc(l), jcdstasbar(l), jcsrcasbar(l)

ACKNOWLEDGEMENTS
artsportms and documentation written by Daniel W. McRobb
CAIDA, September 1998