NAME

shtk_config_load —

Loads a configuration file

LIBRARY

shtk_import config

SYNOPSIS

shtk_config_load config_file

DESCRIPTION

The shtk_config_load function parses and loads the configuration file given by config_file.

Only the configuration variables previously registered as valid with a call to shtk_config_init(3) will be recognized as valid variables during load. Any variables defined by the configuration file but not registered in the shtk_config_load module will be ignored during load.

EXAMPLES

Consider the following configuration file:

prefix=/usr
OBJDIR="${prefix}/obj"
SRCDIR="${prefix}/src"

The following piece of code illustrates how to load and display the settings of the file above:

shtk_config_init OBJDIR SRCDIR
shtk_config_load ".../path/to/the/file/above.conf"

echo "prefix was defined but is not available:" \
    "$(shtk_config_get_default prefix default-value)"
echo "OBJDIR is $(shtk_config_get OBJDIR)"
echo "SRCDIR is $(shtk_config_get SRCDIR)"

ERRORS

Errors during the processing of config_file result in the termination of the caller script.

HISTORY

shtk_config_load first appeared in shtk 1.0.