NAME

gated2yaml - convert gated OSPF LSDB to YAML file

SYNOPSIS

gated2yaml [-D dump] [-h] [-H user@host] [-S skip] [ospf.yaml]

DESCRIPTION

gated2yaml takes the OSPF link state database of the gated routing daemon and converts it into a YAML file.

The gated_dump file containing the LSDB can be passed via command line. If no file is given, the gdc command line tool is invoked to gather the information dynamically. For that the user must be root to access the gdc programm. If necessary sudo is used for calling gdc to gain privileges.

Optionally one output file can be given on command line, otherwise stdout is used.

The options are as follows:

-D dump

File describing the internal state of the gated process including the OSPF link state database. It can be obtained via gdc dump manually. If the file path is not given, gdc dump is called automatically and it is assumed that gated writes its dump file to /var/tmp/gated_dump.

-h

Show help message and exit.

-H user@host

The specified user and host are used for ssh login and run gdc dump there.

-S skip

The gated_dump file may contain several state snapshots separated each starting with a form feed. With this parameter greater than 0 not the first one is used.

EXAMPLES

gated2yaml | ospf2dot | dot

DIAGNOSTICS

The program dies if an error occurs. Typical errors are gdc failure or parsing errors of the gated_dump file.

SEE ALSO

OSPF::LSDB::gated, OSPF::LSDB::YAML, OSPF::LSDB

ospf2dot

gdc(8)

AUTHOR

Alexander Bluhm