artsnexthopagg

artsnexthopagg()                                                artsnexthopagg()



NAME
       artsnexthopagg - utility to aggregate nexthop table objects in time
       domain

SYNOPSIS
       artsnexthopagg [-v] [-i ifIndexList] [-I ifIndexList]
                      [-h hours] [-o] [-q] outfile infile(s)

DESCRIPTION
       artsnexthopagg is a utility that reads nexthop table objects from ARTS
       files (infile(s)) and aggregates them in the time domain, placing the
       resulting nexthop table object(s) into an output file (outfile).

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

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

       -I ifIndexList
              The -I ifIndexList option may be used to combine data which
              contains an interface index attribute in ifIndexList.  In other
              words, the -I ifIndexList option lets you aggregate data across a
              set of interfaces.  ifIndexList may contain hyphens (indicating an
              inclusive range) and commas.  For example, -I 1,2,5-8 would
              combine all data with an interface index attribute of 1, 2, 5, 6,
              7 or 8.  The resulting aggregate objects will contain an interface
              index attribute of 0.

       -h hours
              The -h hours option may be used to specify the period of
              aggregation, in hours.  The hours argument accepts a decimal value
              to permit aggregation by fractional hour values.  When the -h
              hours option is not used, artsnexthopagg will write a single
              nexthop table object for the entire time interval seen in
              infile(s) to outfile.

       -o     By default, artsnexthopagg appends to the output file, so you may
              accumlate aggregate nexthop table objects in a single file over
              multiple invocations of artsnexthopagg.  You may override this
              behavior with the -o option.  This will cause artsnexthopagg to
              overwrite the output file instead of appending to it.

       -q     By default, artsnexthopagg prints a '.' for each nexthop table
              object it reads and prints a '+' for each object it writes.  You
              may suppress this behavior with the -q (quiet) option.

EXAMPLES
       artsnexthopagg -h 1.0 /tmp/nexthop1hr.19980821 arts.19980821

SEE ALSO
       artsagg(l), artsnexthops(l), artsprotoagg(l), artsprotos(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
       artsprotoagg and documentation written by Daniel W. McRobb
       CAIDA, August 1998




                                                                artsnexthopagg()