artsports

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




                                      LOCAL                         artsports(l)