Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

aggregate-ios(1) [centos man page]

AGGREGATE-IOS(1)					      General Commands Manual						  AGGREGATE-IOS(1)

aggregate-ios - optimise a concatenated set of cisco/IOS prefix filters to help make them nice and short. SYNOPSIS
aggregate-ios <source_config >optimised_config DESCRIPTION
Takes cisco IOS configuration on stdin, and optimises any prefix filters found using aggregate(1). Optimised filters are produced on std- out. OPTIONS
Any diagnostics produced by aggregate(1) are passed through on stderr. EXAMPLES
The following configuration fragment: ip prefix-list AS65530 description Foo, Inc ip prefix-list AS65530 permit ip prefix-list AS65530 permit ip prefix-list AS65530 permit ip prefix-list AS65530 permit ip prefix-list AS65531 description Bar.Com ip prefix-list AS65531 seq 5 permit ip prefix-list AS65531 seq 10 permit ip prefix-list AS65531 seq 15 permit is optimised as follows: ip prefix-list AS65530 permit le 24 ip prefix-list AS65530 permit le 24 ip prefix-list AS65531 permit le 24 SEE ALSO
aggregate(1) HISTORY
Aggregate-ios was written by Joe Abley <>. BUGS
All those in aggregate(1) and then some :) Joe Abley 2000 November 27 AGGREGATE-IOS(1)

Check Out this Related Man Page

AGGREGATE(1)						      General Commands Manual						      AGGREGATE(1)

aggregate - optimise a list of route prefixes to help make nice short filters SYNOPSIS
aggregate [-m max-length] [-o max-opt-length] [-p default-length] [-q] [-t] [-v] DESCRIPTION
Takes a list of prefixes in conventional format on stdin, and performs two optimisations to attempt to reduce the length of the prefix list. The first optimisation is to remove any supplied prefixes which are superfluous because they are already included in another supplied pre- fix. For example, would be removed if was also supplied. The second optimisation identifies adjacent prefixes that can be combined under a single, shorter-length prefix. For example, and can be combined into the single prefix OPTIONS
-m max-length Sets the maximum prefix length for entries read from stdin max_length bits. The default is 32. Prefixes with longer lengths will be discarded prior to processing. -o max-opt-length Sets the maximum prefix length for optimisation to max-opt-length bits. The default is 32. Prefixes with longer lengths will not be subject to optimisation. -p default-length Sets the default prefix length. There is no default; without this option a prefix without a mask length is treated as invalid. Use -p 32 -m 32 -o 32 to aggregate a list of host routes specified as bare addresses, for example. -q Sets quiet mode -- instructs aggregate never to generate warning messages or other output on stderr. -t Silently truncate prefixes that seem to have an inconsistent prefix: e.g. an input prefix would be truncated to Without this option an input prefix would not be accepted, and a warning about the inconsistent mask would be generated. -v Sets verbose mode. This changes the output format to display the source line number that the prefix was obtained from, together with a preceding "-" to indicate a route that can be suppressed, or a "+" to indicate a shorter-prefix aggregate that was added by aggre- gate as an adjacency optimisation. Note that verbose output continues even if -q is selected. DIAGNOSTICS
Aggregate exits 0 on success, and >0 if an error occurs. EXAMPLES
The following list of prefixes: is optimised as followed by aggregate (output shown using the -v flag): aggregate: maximum prefix length permitted will be 24 [ 0] + [ 1] - [ 2] - [ 3] [ 4] [ 5] [ 0] + [ 6] - [ 7] - [ 8] - [ 9] [ 10] [ 0] + [ 11] - [ 12] - Note that and were combined under the single prefix, and was suppressed because it was included in The number in square brackets at the beginning of each line indicates the original line num- ber, or zero for new prefixes that were introduced by aggregate. The output without the -v flag is as follows: SEE ALSO
aggregate-ios(1) HISTORY
Aggregate was written by Joe Abley <>, and has been reasonably well tested. It is suitable for reducing customer prefix fil- ters for production use without extensive hand-proving of results. Autoconf bits were donated by Michael Shields <>. The -t option was suggested by Robin Johnson <rob->, and the treatment of leading zeros on octet parsing was changed following comments from Arnold Nipper <>. An early version of aggregate would attempt to combine adjacent prefixes regardless of whether the first prefix lay on an appropriate bit boundary or not (pointed out with great restraint by Robert Noland <>). BUGS
Common unix parsing of IPv4 addresses understands the representation of individual octets in octal or hexadecimal, following a "0" or "0x" prefix, respectively. That convention has been deliberately disabled here, since resources such as the IRR do not follow the convention, and confusion can result. For extremely sensitive applications, judicious use of the -v option together with a pencil and paper is probably advisable. Joe Abley 2001 November 2 AGGREGATE(1)
Man Page