table of contents
| md_doc_help_kdb-get(3elektra) | Elektra | md_doc_help_kdb-get(3elektra) |
NAME¶
md_doc_help_kdb-get - kdb-get(1) -- Get the value of a key stored in the key database kdb get <key name>
Where key name is the name of the key.
DESCRIPTION¶
This command is used to retrieve the value of a key.
If you enter a key name starting with a leading /, then a cascading lookup will be performed in order to attempt to locate the key. In this case, using the -v option allows the user to see the full key name of the key if it is found.
Note: There is a current limitation where only keys that are mounted will be considered during a cascading lookup. A workaround that will lookup all keys is to pass the -a option. Additionally, a user can use the command kdb ls <same key> to see if an override or a fallback will be considered by the lookup.
OPTIONS¶
- -H, --help: Show the man page.
- -V, --version: Print version info.
- -p, --profile <profile>: Use a different kdb profile.
- -C, --color <when>: Print never/auto(default)/always colored output.
- -a, --all: Consider all of the keys.
- -n, --no-newline: Suppress the newline at the end of the output.
- -v, --verbose: Explain what is happening. Gives a complete trace of all tried keys. Very useful to debug fallback and overrides.
EXAMPLES¶
To get the value of a key: kdb get user/example/key
To get the value of a key using a cascading lookup: kdb get /example/key
To get the value of a key without adding a newline to the end of it: kdb get -n /example/key
To explain why a specific key was used (for cascading keys): kdb get -v /example/key
To use bookmarks: kdb get +kdb/format
This command will actually get user/sw/elektra/kdb/#0/current/format if the bookmarks commands from kdb-set(1) man pages are executed before.
SEE ALSO¶
- kdb(1) for how to configure the kdb utility and use the bookmarks.
- For more about cascading keys see elektra-cascading(7)
- To get keys in shell scripts, you also can use kdb-sget(1)
- elektra-key-names(7) for an explanation of key names.
| Mon Jan 15 2018 | Version 0.8.20 |