artsnexthopagg - utility to aggregate nexthop table objects in
time domain
artsnexthopagg [-v] [-i ifIndexList] [-I ifIndexList]
[-h hours] [-o] [-q] outfile infile(s)
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).
- -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.
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)
artsprotoagg and documentation written by Daniel W. McRobb
CAIDA, August 1998