DragonFly On-Line Manual Pages

artsintfmagg(l)                                                artsintfmagg(l)

NAME
       artsintfmagg - utility to aggregate interface matrix objects in time
       domain

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

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

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

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

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

EXAMPLES
       artsintfmagg -h 1.0 /tmp/intfmagg1hr.19980821 arts.19980821

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

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

                                     LOCAL                     artsintfmagg(l)