/ 
OSPF-LSDB-1.04
River stage zero No dependents
/ ospfview.cgi

NAME

ospfview.cgi - publish the OSPF LSDB graph on a web server

SYNOPSIS

http://127.0.0.1/cgi-bin/ospfview.cgi?ipv6=0&external=2

DESCRIPTION

The cgi script ospfview.cgi allows to publish the link-state database of an OSPF router on a web server running there.

The router must run the OpenBSD ospfd or ospf6d routing daemon. To make this cgi script work, the web server must have access to the /var/run/ospfd.sock and /var/run/ospf6d.sock UNIX domain sockets. This can be achieved by file permissions or sudo permissions for ospfctl and ospf6ctl. The web server must not run chrooted.

The following parameters control the format and content of the generated graph. The content parameters have numerical values, 0 disables the feature and is the default.

format

Specify the file format of the generated image. The value is passed to the dot -T option. Available choices are dot, fig, gif, pdf, png, ps, ps2, svg, svgz. Default is svg.

ipv6

The value 1 turns on IPv6, 0 uses IPv4.

legend

The value 1 displays the legend instead of the current OSPF LSDB.

summary

The value 1 adds the network summary-LSAs to the graph. With 2 these LSAs get aggregated. Inter-area-prefix-LSAs have not been implemented for IPv6.

boundary

The value 1 adds the boundary router summary-LSAs to the graph. With 2 these LSAs get aggregated. Inter-area-router-LSAs have not been implemented for IPv6.

external

The value 1 adds the AS-external-LSAs to the graph. With 2 these LSAs get aggregated.

The value 1 adds the link-LSAs to the graph. These LSAs exist only for IPv6.

intra

The value 1 adds the network and router intra-area-prefix-LSAs to the graph. These LSAs exist only for IPv6.

cluster

The value 1 clusters LSAs containing the same network into a common rectangle. This feature has not been implemented for IPv6.

warnings

The value 1 prints the area and all warnings corresponding to the color of the nodes and edges. With 2 only the area or the most severe warning is printed. Note that with the svg format, the messages are always available as tool tip.

DIAGNOSTICS

The program dies if an error occurs. Check you web server's error log for messages.

SEE ALSO

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

dot(1)

AUTHOR

Alexander Bluhm

SECURITY CONSIDERATIONS

It is problably not the best idea to publish one's routing topology on a public web server. This cgi script is intended to debug OSPF in a controlled environment.

The perl taint mode is used to make this cgi script secure.