artsnexthops(l)

NAME
artsnexthops - utility to display IP nexthop table objects from ARTS files

SYNOPSIS
artsnexthops [-v] [-p] [-i ifIndexList] [-l maxEntries]
             [-b beginTime] [-e endTime] infile(s)

DESCRIPTION
artsnexthops is a utility that reads nexthop table objects from ARTS files (infile(s)) and displays a summary of their contents on stdout.

OPTIONS

-v  The -v option causes artsnexthops 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.

-i ifIndexList
    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 that is stored as an attribute in the nexthop object.

-l maxEntries
    The -l maxEntries option will cause only the first maxEntries nexthop entries to be shown from each nexthop table 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

artsnexthops -i 1,2,5-8 -l 10 -b '08/21/1998 09:00:00' arts.19980821

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

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