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