DragonFly On-Line Manual Pages

artsnetagg(l)                                                    artsnetagg(l)

NAME
       artsnetagg - utility to aggregate net matrix objects in time domain

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

DESCRIPTION
       artsnetagg is a utility that reads net matrix objects from ARTS files
       (infile(s)) and aggregates them in the time domain, placing the
       resulting net matrix object(s) into an output file (outfile).

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

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

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

EXAMPLES
       artsnetagg -h 1.0 /tmp/netagg1hr.19980821 arts.19980821

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

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

                                     LOCAL                       artsnetagg(l)