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 domainname1 ... zonefileN domainnameN
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       --node-size=(none|small)
44           If the map size is too large, it is possible to either greatly
45           reduce the node size (and the text) using --node-size=small or
46           eliminate the circles entirely, leaving only the arrows using
47           --node-size=none.  This can make for better visual diagrams of very
48           complex node sets, although all labeling is lost.
49
50       -a  Allows overlapping of nodes.  This makes much tighter maps with the
51           downside being that they are somewhat cluttered.  Maps of extremely
52           large zones will be difficult to decipher if this option is not
53           used.
54
55       -e WEIGHT
56           Assigns an edge weight to edges.  In theory, >1 means shorter and
57           <1 means longer, although, it may not have any effect as
58           implemented.  This should work better in the future.
59
60       -f INTEGER
61           Uses the INTEGER value for the font size to print node names with.
62           The default value is 10.
63
64       -w WARNTIME
65           Specifies how far in advance expiration warnings are enabled for
66           signed resource records.  The default is 7 days.  The warning time
67           is measured in seconds.
68
69       -i REGEX
70           Ignores record types matching a REGEX regular expression.
71
72       -s TYPE,TYPE...
73           Specifies a list of record types that will not be analyzed or
74           displayed in the map.  By default, this is set to NSEC and CNAME in
75           order to reduce clutter.  Setting it to "" will display these
76           results again.
77
78       -T TYPE,TYPE...
79           Restrict record types that will be processed to those of type TYPE.
80           This is the converse of the -s option.  It is not meaningful to use
81           both -s and -t in the same invocation.  They will both work at
82           once, however, so if -T specifies a type which -s excludes, it will
83           not be shown.
84
85       -g  Attempts to cluster nodes around the domain name.  For "dot"
86           layouts, this actually means drawing a box around the cluster.  For
87           the other types, it makes very little difference, if any.
88
89       -q  Prevents output of warnings or errors about records that have
90           DNSSEC signatures that are near or beyond their signature
91           lifetimes.
92
93       --dump-styles
94           Dumps the current style settings for both nodes and edges.
95
96       --node-style=FORMATS
97       --edge-style=FORMATS
98           Allows specific style settings to be used when drawing nodes and
99           edges.  Major format specifications are delimited by '/'s and pairs
100           within that are delimited by ':'s.  The first token in a ':' list
101           is expected to be the record name.
102
103           For example, to make all A address records appear as a red box and
104           all MX records to appear as a triangle use this specification:
105
106             --node-style=A:shape=box:fillcolor=red/MX:shape=triangle
107
108           Run mapper with --dump-styles to show its default settings and/or
109           how you've modified it the options have been used.
110

EXAMPLE INVOCATIONS

112       mapper -s cname,nsec -i dhcp -L zonefile zone.com
113           Writes to the default file (map.png) of a zone.com zone stored in
114           zonefile.  It excludes any hosts with a name containing dhcp and
115           ignores any record of type CNAME or NSEC.  A legend is included in
116           the output.
117
118       mapper -s txt,hinfo,cname,nsec,a,aaaa,mx,rrsig -L zonefile zone.com
119       zonefile2 sub.zone.com ...
120           Removes a lot of records from the display in order to primarily
121           display a map of a zone hierarchy.
122
123       mapper -l dot -s txt,hinfo,cname,nsec,a,aaaa,mx,rrsig -L zonefile
124       zone.com zonefile2 sub.zone.com ...
125           As the previous example, but this command draws a more vertical
126           tree-style graph of the zone.  This works well for fairly deep but
127           narrow hierarchies.  Tree-style diagrams rarely look as nice for
128           full zones.
129

COPYRIGHT

131       Copyright 2004-2013 SPARTA, Inc.  All rights reserved.  See the COPYING
132       file included with the DNSSEC-Tools package for details.
133

AUTHOR

135       Wes Hardaker <hardaker@users.sourceforge.net>
136