GATED2YAML(1)

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