artsnexthopagg()artsnexthopagg()NAMEartsnexthopagg - utility to aggregate nexthop table objects in time
domain
SYNOPSISartsnexthopagg [-v] [-i ifIndexList] [-I ifIndexList]
[-h hours] [-o] [-q] outfile infile(s)DESCRIPTIONartsnexthopagg 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 par‐
ticular interfaces or sets of interfaces. ifIndexList may con‐
tain 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 con‐
tains 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 (indicat‐
ing 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 aggre‐
gation, 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 artsnex‐
thopagg 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.
EXAMPLESartsnexthopagg-h 1.0 /tmp/nexthop1hr.19980821 arts.19980821
SEE ALSOartsagg(l), artsnexthops(l), artsprotoagg(l), artsprotos(l), arts‐
dump(l), artsases(l), artsasagg(l), artsnets(l), artsnetagg(l), art‐
sportmagg(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()