.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "KDB\-MOUNT" "1" "2015-11-19" "" ""
.
.SH "NAME"
\fBkdb\-mount\fR \- Mount a file to the key database
.
.SH "SYNOPSIS"
\fBkdb mount [<path> <mountpoint>] [<plugin> [<config>] [\.\.]]\fR
.
.IP "\(bu" 4
Where \fBpath\fR is the path to the file the user wants to mount\. See \fBkdb info resolver\fR for details what an absolute and relative path means\.
.
.IP "\(bu" 4
\fBmountpoint\fR is where in the key database the new backend should be mounted\. (For a cascading mount pount, \fBmountpoint\fR should start with \fB/\fR)
.
.IP "\(bu" 4
\fBplugin\fR should be an Elektra plugin\. A list of such plugins with configuration can be given\.
.
.IP "\(bu" 4
Plugins may be followed by a \fB,\fR separated list of keys and their corresponding values which will be written below the backend configuration\.
.
.IP "" 0
.
.SH "DESCRIPTION"
This command allows a user to mount a new \fIbackend\fR\.
.
.P
The idea of mounting is explained in elektra\-mounting(7) \fIelektra\-mounting\.md\fR\.
.
.P
Mounting in Elektra allows the user to mount a file into the current key database like a user may mount a parition into the current filesystem by creating a \fIbackend\fR\.
.
.br
This functionality is key to Elektra as it allows users to build a global key database comprised of many different conifguration files\.
.
.br
A backend acts as a worker to allow Elektra to interpret configuration files as keys in the central key database such that any edits to the keys are reflected in the file and vice versa\.
.
.br
Additionally, the user can use this command to list the currently mounted backends by running the command with no arguments\.
.
.SH "IMPORTANT"
This command writes into the \fB/etc\fR directory and as such it requires root permissions\. Use \fBkdb file system/elektra/mountpoints\fR to find out where exactly it will write to\.
.
.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\-d\fR, \fB\-\-debug\fR
Give debug information or ask debug questions (in interactive mode)\.
.
.TP
\fB\-i\fR, \fB\-\-interactive\fR
Instead of passing all mounting information by parameters ask the user interactively\.
.
.TP
\fB\-R\fR, \fB\-\-resolver <name>\fR
Specify the resolver plugin to use if no resolver is given, the default resolver is used\. See also \fB/sw/kdb/current/resolver\fR \fIbelow\fR\.
.
.TP
\fB\-0\fR, \fB\-\-null\fR
Use binary 0 termination\.
.
.TP
\fB\-1\fR, \fB\-\-first\fR
Suppress the first column\.
.
.TP
\fB\-2\fR, \fB\-\-second\fR
Suppress the second column\.
.
.TP
\fB\-3\fR, \fB\-\-third\fR
Suppress the third column\.
.
.TP
\fB\-c\fR, \fB\-\-plugins\-config\fR
Add a plugin configuration for all plugins\.
.
.SH "KDB"
.
.TP
\fB/sw/kdb/current/resolver\fR
The resolver that will be added automatically, if \fB\-R\fR is not given\.
.
.TP
\fB/sw/kdb/current/plugins\fR
It contains a space\-separated list of plugins which are added automatically (by default sync)\.
.
.SH "EXAMPLES"
To list the currently mounted backends:
.
.br
\fBkdb mount\fR
.
.P
To mount a system configuration file using the ini format:
.
.br
\fBkdb mount /etc/configuration\.ini system/example ini\fR
.
.P
Print a null\-terminated output of paths and backend names:
.
.br
\fBkdb mount \-02 | xargs \-0n 2 echo\fR
.
.P
To mount the /etc/file system file with two plugins with a respective configuration option each:
.
.br
\fBkdb mount /etc/file system/file plugin1 plugin1config=config1 plugin2 plugin2config=config2\fR
.
.P
To mount the /etc/file system file with two plugins and setting both to be verbose:
.
.br
\fBkdb mount \-c verbose=1 /etc/file system/file plugin1 plugin2\fR
.
.P
To recode and rename a configuration file using Elektra:
.
.br
\fBkdb mount s\.ini recode\.txt ni rename cut=path iconv recode=utf8\.\.latin1\fR
.
.SH "SEE ALSO"
.
.IP "\(bu" 4
kdb\-umount(7) \fIkdb\-umount\.md\fR\.
.
.IP "\(bu" 4
elektra\-mounting(7) \fIelektra\-mounting\.md\fR\.
.
.IP "\(bu" 4
elektra\-plugins(7) \fIelektra\-plugins\.md\fR\.
.
.IP "" 0