The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

ospf2dot - convert OSPF LSDB YAML to Graphviz dot

SYNOPSIS

ospf2dot [-46bBceEhlpPsSwWv] [ospf.yaml] [ospf.dot]

DESCRIPTION

ospf2dot takes an OSPF link state database in YAML format and converts it into a Graphviz dot graph that shows the topology of the autonomous system. Per default only networks, router and links are displayed. Other LSA types have to be turned on explicitly.

The regular color of the graph is gray, each area gets its own brightness. The OSPF LSDB is checked for consistency. Erroneous vertexes or links get colored depending on the detected problem. The error messages can be displayed as tooltip in an SVG graph or printed to stderr.

Optionally one input and one output file can be given on command line, otherwise stdin and stdout are used.

The options are as follows:

-4

Disable IPv6. Default is the address family in YAML input file.

-6

Enable IPv6. Default is the address family in YAML input file.

-b

Display AS boundary router summary LSAs.

-B

Display AS boundary router summary LSAs aggregated. A single node contains all boundary routers advertised from the same router.

-c

Identical networks are clustered into a subgraph. This visualizes duplicate networks.

-e

Display AS extrnal LSAs.

-E

Display AS extrnal LSAs aggregated. A single node contains all external networks advertised from the same router.

-h

Show help message and exit.

-l

Generate legend as dot graph which contains all kinds of nodes and edges. The corresponding OSPF object is explained. Use -4 or -6 to choose the address family. Unimplemented features are displayed in red.

-p

Display IPv6 link and intra-area-prefix LSAs.

-P

Display IPv6 intra-area-prefix LSAs. They are constructed from the link LSAs by the designated router.

-s

Display IP network summary LSAs.

-S

Display IP network summary LSAs aggregated. A single node contains all networks advertised from the same router.

-w

Show the most serious warning in the dot graph. That warning also accounts for the color. If there is no warning, the area is displayed.

Note that this message is always shown as tool tip in SVG graphs.

-W

Show the all areas and warnings in the dot graph.

-v

Be verbose and print all warnings to stderr.

EXAMPLES

 ospf2dot -BSE ospf.yaml | dot -Tsvg -o ospf.svg

DIAGNOSTICS

The program dies if an error occurs. Typical errors are invalid YAML format, version of input file is newer than this program so it cannot be converted or the content of the YAML file is invalid.

SEE ALSO

OSPF::LSDB::View, OSPF::LSDB::View6, OSPF::LSDB::YAML, OSPF::LSDB

ospfview

dot(1)

AUTHOR

Alexander Bluhm