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

ACKNOWLEDGEMENTS