IPMAP(1) BSD General Commands Manual IPMAP(1) NAME ipmap -- generate visualizations of IP address space SYNOPSIS ipmap [-h] [-n] [-q] [-o file] [-t num] [-p num] [-f prefix] files... DESCRIPTION ipmap is a tool that takes IP prefixes as input and produces visualiza- tions of IP address space as output. This version supports 2D quad-chart output in png format. ipmap also supports coloring based on AS number or order of input files. The options are as follows: -h Displays help. -n Negate color. Background set to white. -q Quiet mode. Don't print status information. -o file Output image will be written to file. Image will be written to 'ipmap.png' if no file is specified. -t num Result image covers num bits of IPv4 space. Thus, if num is set to '/0' then the output image will visualize all IPv4 space. To restrict the result image to a subset of IP-space set num to CIDR prefix required. For example, to visualize 12.0.0.0/8 set num to '/8' and set the filter prefix to '12.0.0.0/8'. num must be set at least 3 bits bigger than pixel size and be a multiple of 2. The default value of num is '/0'. -p num Each pixel in the result image represents num bits of an IPv4 address. Thus, a num value of '/24' means a single pixel in the result image corresponds to a /24 in IPv4 space. If the total size of the image is /0 and the pixel size is set to /32 then result image would be 65,536 by 65,536 pixels. The default value of num is '/24' which cor- responds to result image that is 4096 by 4096 pixels. num must be set at least 3 bits smaller than total size and be a multiple of 2. -f prefix Filters all input prefixes by prefix so that only those that match the filter are plotted. When plotting subsets of IP space the filter parameters allows the input to be restricted to only those prefixes that fall within the spec- ified subset. For example, to visualize 12.0.0.0/8 when the input file(s) contain prefixes from other /8 networks, a filter prefix of '12.0.0.0/8' can be used to restrict the input prefixes. FILES Input files to ipmap should be text files with each input prefix on a separate line. Prefixes should formated in in CIDR notation. For exam- ple, an input file to ipmap might look like: 192.168.0.0/16 10.0.0.1/32 172.16.4.12/24 A color may be specified by adding white space and then a number after each prefix on each input line. The color value should range from 0 - 65535 and maps to a hue value in HSB color space. For example, an input file with explicit colors might look like: 192.168.0.0/16 10 10.0.0.1/32 10000 172.16.4.12/24 20000 Examples uses of the color parameter might be to denote different autonomous systems or source/destination ports in network traces. If colors are not specified within the input files then the prefixes can be split into multiple files and order of the input files will determine coloring. Currently, the first prefix input file to ipmap will color prefixes white, the second file red, the third file green, and the forth file blue. The color sequence repeats for any subsequent files. NOTES If the pixel size parameter is set larger than a single IP (i.e. /31 or larger), a pixel will be 'switched on' by any sub-prefix that falls within the pixel. For example if the pixel size is set to /24 then a /32 address that falls within that space will switch on the /24 pixel. EXAMPLES ipmap -t /8 -p /32 -f "68.0.0.0/8" bgp1.prefixes bgp2.prefixes Reads all prefixes in the text files bgp1.prefixes and bgp2.prefixes and colors in all prefixes inside 68.0.0.0/8 from bgp1.prefixes white, and all prefixes inside 68.0.0.0/8 from bgp2.prefixes red. The result image is written to ipmap.png. AUTHORS ipmap was developed by Evan Cooke BSD December 22, 2005 BSD