EnglishFrenchSpanish

Ad


OnWorks favicon

kdb-check - Online in the Cloud

Run kdb-check in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command kdb-check that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

PROGRAM:

NAME


kdb-check - Perform internal checks

SYNOPSIS


kdb check [<plugin>]

DESCRIPTION


This command is used to perform checks on the key database or an Elektra plugin.

Where the option argument, plugin is the plugin that a user wants to check.
Use -c to pass options to that plugin.
If no plugin argument is provided a check will be performed on the key database itself.
Special values are returned upon exit to represent the outcome of a check.

OPTIONS


-H, --help
Show the man page.

-V, --version
Print version info.

-f, --force
The user can also use this tool to perform write tests. Please note that this can
result in configuration files being changed!

-v, --verbose
Explain what is happening.

-c, --plugins-config
Add a plugin configuration.

RETURN VALUES


Their are two different types of checks, a check on a plugin (by specifying the name of a
plugin as an argument) or a check on the key database itself.

The outcome of a check on the key database is returned as an exit status.
This integer represents an 8-bit pattern.
Each bit represents a specific outcome as described below:

0 No errors (no output)

Bit 1 Warning on opening the key database.

Bit 2 Error on opening the key database.

Bit 3 Warning on getting the value of a key.

Bit 4 Error on getting the value of a key.

Bit 5 Warning on setting the value of a key. (only checked when -f is used)

Bit 6 Error on setting the value of a key (only checked when -f is used)

Bit 7 Warning on closing the key database.

Bit 8 Error on closing the key database.

So if the following number was returned 9 the user could figure out more detail by
considering the bits: 00001001
The user would know that their was a warning on open and an error on get.

If a plugin name is given, checks will only be done on the given plugin.
The returned values for a check on a plugin are returned as much simpler numbers.

Return values on plugin checking:

0 Everything ok. (no output)

1 No such plugin found or plugin could not be opened.

2 Plugin did not pass checks.

3 Plugin has warnings.

Please report any output caused by official plugins to http://git.libelektra.org/issues.

Since the error code is a return value, it is not automatically displayed to the shell.
If the user wants to have the value printed, they must do so manually (by running a
command such as echo $?.

EXAMPLES


To check the Key Database:
kdb check

To check the Key Database and then print the result:
kdb check
followed by:
echo $?

To check the Key Database including write checks:
kdb check -f
Note that this type of check may change configuration files.

To check the line plugin:
kdb check line

Use kdb-check online using onworks.net services


Ad