|--prefix p, -p p||Aggregates to prefix level p. That is, replaces each label with its p-aggregates label and outputs the result. The counts from any labels in the same aggregate are combined.|
|--posterize, -P||Replaces each labels (nonzero) count with 1.|
|--sample n||Sample packets with uniform random probability 1/n. The output will have roughly n times fewer packets compared with the input.|
|--cull n||Reduce the input to at most n packets by randomly sampling packets. Input aggregates with no more than n packets are output unchanged.|
|--cull-labels n||Reduce the input to at most n labels by randomly sampling labels. Input aggregates with n or fewer labels are output unchanged. If a label is included in the output, then its count is the same as in the input.|
|--cull-labels-by-packets n||Reduce the input to at most n labels by randomly sampling packets. That is, throw away packets one at a time until the aggregate has at most n labels. Input aggregates with n or fewer labels are output unchanged. Labels included in the output may have lower counts than in the input because of the packet sampling.|
|--cut-smaller n||Drop labels with count less than n. Other labels are left unchanged.|
|--cut-larger n||Drop labels with count greater than or equal to n.|
Drop all labels whose containing p-aggregates contain less than n
packets. For instance, given this input:
the --cut-smaller-aggregates 31,3 option would produce:
Labels 2 and 3 have been dropped because their shared 31-aggregate contains only 2 packets.
|--cut-larger-aggregates p,n||Drop all labels whose containing p-aggregates contain greater than or equal to n packets.|
Drop all labels whose containing p-aggregates contain greater than or
equal to n labels. For instance, given this input:
the --cut-smaller-label-aggregates 30,3 option would produce:
Labels 4 and 5 have been dropped because their shared 30-aggregate contains only 2 labels.
|--cut-larger-label-aggregates p,n||Drop all labels whose containing p-aggregates contain greater than or equal to n labels.|
Action options calculate a statistic from an aggregate file and output that statistic. Each ipaggmanip run can contain at most one action. Unless otherwise noted, statistics containing multiple numbers are output on one line, separated by spaces.
--num-labels, -n Output the number of labels. --num-in-prefixes Output the number of active p-aggregates for each p, 0<=p<=32. The result is 33 space-separated numbers; the first is the number of active 0-aggregates, the last the number of active 32-aggregates (that is, the number of labels). The pth number is at most 2^p. --num-in-left-prefixes Output the number of active left-hand p-aggregates for each p, 0<=p<=32. A left-hand p-aggregate has its lowest-order bit equal to 0. Consider label 6, which identifies a 32-aggregate and a 31-aggregate. (It does not identify a 30-aggregate or above.) Label 6 is a left-hand 32-aggregate, since bit 31 is 0, but it is right-hand 31-aggregate, since bit 30 is 1. As a special case, the single 0-aggregate is considered left-hand. The result is 33 space-separated numbers, as in --num-in-prefixes. --discriminating-prefix-counts Output the number of labels that have discriminating prefix p for each p, 0<=p<=32. The discriminating prefix for a label L is the smallest p so that the p-aggregate containing L contains no other label. The result is 33 space-separated numbers whose sum will equal --num-labels. --all-discriminating-prefix-counts The output is 33 lines, numbered 0 through 32. Line number p equals the result of --prefix p --discriminating-prefix-counts for the input data: that is, the discriminating prefixes for the datas p-aggregates. The discriminating prefix for a p-aggregate must be less than or equal to p, so line p contains p+1 space-separated numbers. --counts Output the count for each active label, sorted in label order. The result is --num-labels space-separated numbers. --sorted-counts Output the count for each active label, sorted in descending order by count. The result is --num-labels space-separated numbers. --count-counts For each count c, calculate n, the number of labels that have count c. Output a series of lines containing "c n", sorted in ascending order by c. --container-counts p Calculate the number of packets in each labels containing p-aggregate. Output each active labels value, sorted in label order. The result is --num-labels space-separated numbers. --balance p --average-and-variance --average-and-variance-by-prefix --haar-wavelet-energy --balance n --balance-histogram n,nbuckets --branching-counts p,step --all-branching-counts step --conditional-split-counts p --correlation-size-container-addresses p
--each, -e --or, -| --and, -& --minus --xor, -^ --and-list --assign-counts
--read file, -r file --output file, -o file --binary, -b --text --ip --help, -h Print a help message to the standard output, then exit. --version, -v Print version number and license information to the standard output, then exit.
ipaggcreate(1), tcpdump(1), tcpdpriv(1), click(1), ipsumdump(1)
See http://www.pdos.csail.mit.edu/click/ for more on Click.
Eddie Kohler <email@example.com>, based on the Click modular router.
|Version 1.83||IPAGGMANIP (1)||2013-09-29|