.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "KDB\-CONVERT" "1" "2015-11-19" "" ""
.
.SH "NAME"
\fBkdb\-convert\fR \- Convert configuration files using elektra
.
.SH "SYNOPSIS"
\fBkdb convert [<import\-format>] [<export\-format>] [<import\-file>] [export\-file]\fR
.
.SH "DESCRIPTION"
This command allows a user to convert a file from any format supported by Elektra to any other supported format\.
.
.P
This command relies on the functionality of Elektra but does not actually modify the key database in any way\.
.
.P
This command uses plugins to specify and convert between formats, it is only limited by the plugins available for Elektra\.
.
.SH "USAGE"
Where \fBimport\-format\fR is the format that the current configuration file is using, \fBexport\-format\fR is the format the user wishes to convert it to, \fBimport\-file\fR is the full path to the current configration file, and \fBexport\-file\fR is where the converted configuration file should be saved\.
.
.P
If either \fBimport\-format\fR or \fBexport\-format\fR is not specified, the \fBdump\fR format will be used instead\.
.
.br
If either \fBimport\-file\fR or \fBexport\-file\fR are not specified, \fBstdin\fR and \fBstdout\fR are used respectively\.
.
.SH "OPTIONS"
.
.TP
\fB\-H\fR, \fB\-\-help\fR
Show the man page\.
.
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version info\.
.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Explain what is happening\.
.
.SH "EXAMPLES"
To convert an Elektra dump file to xml:
.
.br
\fBcat sw\.ecf | kdb convert dump xmltool > sw\.xml\fR
.
.P
Another way to convert an Elektra dump file to xml:
.
.br
\fBkdb convert dump xmltool /home/user/dump_file\.ecf /home/user/xml_file\.xml\fR
.
.P
To print an xml file using the \fBline\fR format:
.
.br
\fBcat \.\./tests/xml_file\.xml | kdb convert xmltool line\fR
.
.br
Note that this command won\'t save the output, it will just diplay it to \fBstdout\fR\.