mapper(1)

1MAPPER(1)             User Contributed Perl Documentation            MAPPER(1)
2
3
4

NAME

6           mapper - Create graphical maps of DNS zone data
7

SYNOPSIS

9           mapper [options] zonefile1 ... zonefileN
10

DESCRIPTION

12       This application creates a graphical map of one or more zone files.
13       The output gives a graphical representation of a DNS zone or zones.
14       The output is written in the PNG format.  The result can be useful for
15       getting a more intuitive view of a zone or set of zones.  It is
16       extremely useful for visualizing DNSSEC deployment within a given zone
17       as well as to help discover problem spots.
18

OPTIONS

20       -h  Prints a help summary.
21
22       -o OUTFILE.png
23           Saves the results to a given filename.  If this option is not
24           given, the map will be saved to map.png.
25
26       -r  Lists resource records assigned to each node within the map.
27
28       -t TYPE,TYPE...
29           Adds the data portion of a resource record to the displayed node
30           information.  Data types passed will be automatically converted to
31           upper-case for ease of use.
32
33           Example usage: -t A will add IPv4 addresses to all displayed nodes
34           that have A records.
35
36       -L  Adds a legend to the map.
37
38       -l (neato⎪dot⎪twopi⎪circo⎪fdp)
39           Selects a layout format.  The default is neato, which is circular
40           in pattern.  See the documentation on the GraphViz package and the
41           GraphViz Perl module for further details.
42
43       -a  Allows overlapping of nodes.  This makes much tighter maps with the
44           downside being that they are somewhat cluttered.  Maps of extremely
45           large zones will be difficult to decipher if this option is not
46           used.
47
48       -e WEIGHT
49           Assigns an edge weight to edges.  In theory, >1 means shorter and
50           <1 means longer, although, it may not have any effect as imple‐
51           mented.  This should work better in the future.
52
53       -f INTEGER
54           Uses the INTEGER value for the font size to print node names with.
55           The default value is 10.
56
57       -w WARNTIME
58           Specifies how far in advance expiration warnings are enabled for
59           signed resource records.  The default is 7 days.  The warning time
60           is measured in seconds.
61
62       -i REGEX
63           Ignores record types matching a REGEX regular expression.
64
65       -s TYPE,TYPE...
66           Specifies a list of record types that will not be analyzed or dis‐
67           played in the map.  By default, this is set to NSEC and CNAME in
68           order to reduce clutter.  Setting it to "" will display these
69           results again.
70
71       -T TYPE,TYPE...
72           Restrict record types that will be processed to those of type TYPE.
73           This is the converse of the -s option.  It is not meaningful to use
74           both -s and -t in the same invocation.  They will both work at
75           once, however, so if -T specifies a type which -s excludes, it will
76           not be shown.
77
78       -g  Attempts to cluster nodes around the domain name.  For "dot" lay‐
79           outs, this actually means drawing a box around the cluster.  For
80           the other types, it makes very little difference, if any.
81
82       -q  Prevents output of warnings or errors about records that have
83           DNSSEC signatures that are near or beyond their signature life‐
84           times.
85

EXAMPLE INVOCATIONS

87       mapper -s cname,nsec -i dhcp -L zonefile zone.com
88           Writes to the default file (map.png) of a zone.com zone stored in
89           zonefile.  It excludes any hosts with a name containing dhcp and
90           ignores any record of type CNAME or NSEC.  A legend is included in
91           the output.
92
93       mapper -s txt,hinfo,cname,nsec,a,aaaa,mx,rrsig -L zonefile zone.com
94       zonefile2 sub.zone.com ...
95           Removes a lot of records from the display in order to primarily
96           display a map of a zone hierarchy.
97
98       mapper -l dot -s txt,hinfo,cname,nsec,a,aaaa,mx,rrsig -L zonefile
99       zone.com zonefile2 sub.zone.com ...
100           As the previous example, but this command draws a more vertical
101           tree-style graph of the zone.  This works well for fairly deep but
102           narrow hierarchies.  Tree-style diagrams rarely look as nice for
103           full zones.
104

COPYRIGHT

106       Copyright 2004-2007 SPARTA, Inc.  All rights reserved.  See the COPYING
107       file included with the DNSSEC-Tools package for details.
108

AUTHOR

110       Wes Hardaker <hardaker@users.sourceforge.net>
111