gated2yaml - convert gated OSPF LSDB to YAML file
gated2yaml [-D dump] [-h] [-H user@host] [-S skip] [ospf.yaml]
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.
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.
gated2yaml | ospf2dot | dot
The program dies if an error occurs. Typical errors are gdc failure or parsing errors of the gated_dump file.