artsportms

artsportms(l)                                                    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




                                     LOCAL                       artsportms(l)