artsasagg

artsasagg(l)                                                        artsasagg(l)



NAME
       artsasagg - utility to aggregate AS matrix objects in time domain

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

DESCRIPTION
       artsasagg is a utility that reads AS matrix objects from ARTS files
       (infile(s)) and aggregates them in the time domain, placing the resulting
       AS matrix object(s) into an output file (outfile).  For example, you may
       use artsasagg to aggregate 5-minute AS matrix data to 1-hour AS matrix
       data.

OPTIONS
       -v     The -v option causes artsasagg 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
              aggregate all data 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, artsasagg will write a single AS matrix
              object for the entire time interval seen in infile(s) to outfile.

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

       -q     By default, artsasagg prints a '.' for each AS matrix object it
              reads and prints a '+' for each object it writes.  You may
              suppress this behavior using the -q (quiet) option.

EXAMPLES
       artsasagg -h 1.0 /tmp/asagg1hr.19980821 arts.19980821

NOTES
SEE ALSO
       artsagg(l), artsases(l), artsnets(l), artsnetagg(l), artsportmagg(l),
       artsportms(l), artsports(l), artsprotoagg(l), artsprotos(l),
       artsintfms(l), artsintfmagg(l), artsnexthops(l), artsnexthopagg(l),
       artstos(l), artsdump(l), artstoc(l)

ACKNOWLEDGEMENTS
       artsasagg and documentation written by Daniel W. McRobb
       CAIDA, August 1998




                                      LOCAL                         artsasagg(l)