Elektra  0.8.21
kdb-mount(1) - Mount a file to the key database

kdb mount [<path> <mountpoint>] [<plugin> [<config>] [..]]

DESCRIPTION

This command allows a user to mount a new backend. The idea of mounting is explained in elektra-mounting(7).

Mounting in Elektra allows the user to mount a file into the current key database like a user may mount a partition into the current file system. This functionality is key to Elektra as it allows users to build a global key database comprised of many different configuration files. 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. Additionally, the user can use this command to list the currently mounted backends by running the command with no arguments.

IMPORTANT

This command writes into the /etc directory and as such it requires root permissions. Use kdb file system/elektra/mountpoints to find out where exactly it will write to.

Absolute paths are still relative to their namespace (see kdb info resolver). Only system+spec mountpoints are actually absolute. Read elektra-namespaces(7) for further information.

For cascading mountpoints (starting with /) a mountpoint for the namespace dir, user and system is created. Each of this mountpoint uses a different configuration file, either below current directory, below home directory or anywhere in the system. Use kdb file <path> to determine where the file(s) are.

OPTIONS

KDB

EXAMPLES

To list the currently mounted backends:
kdb mount

To mount a system configuration file using the ini format:
kdb mount /etc/configuration.ini system/example ini

Print a null-terminated output of paths and backend names:
kdb mount -02 | xargs -0n 2 echo

To mount the /etc/file system file with two plugins with a respective configuration option each:
kdb mount /etc/file system/file plugin1 plugin1config=config1 plugin2 plugin2config=config2

To mount the /etc/file system file with two plugins and setting both to be verbose:
kdb mount -c verbose=1 /etc/file system/file plugin1 plugin2

To recode and rename a configuration file using Elektra:
kdb mount recode.txt dir/recode ni rename cut=path iconv to=utf8,from=latin1

SEE ALSO