vgetconfig(1)

Name

vgetconfig - Get values from the Vesta configuration file

Synopsis

vgetconfig [-l location] [-L] [-V] [-I] [-i] [-b] [-f] [-s [section]] [[-w|W] section name [section name ...]]

Description

See the Terminology section of the vesta-intro man page for definitions of terms. See the vesta.cfg man page for syntax of the Vesta configuration file.

If section and name are provided, vgetconfig prints the value of name in section section of the Vesta configuration file. If multiple section name pairs are provided, the values are printed one per line in order.

The -w -W flags are useful when trying to locate a configuration setting in the set of config files. The -s flag is useful when trying to locate a setting or section name. The -I flag gives a way to list all the files used to define the configuration, with their include hierarchy.

If the arguments given to vgetconfig leave it with nothing to do, it prints a usage message.

Flags

-l location

Use the configuration file named by location, overriding the default search path established by VestaConfig.H.

-L

Print the config file location.

-V

Print the version of vgetconfig.

-I

Print the tree of config files processed during parsing by following all include directives.

-i

Use VestaConfig::get_int to read the configuration file, thereby insisting that the configuration values be an integer. The default is to use VestaConfig::get_Text, which allows any value.

-b

Use VestaConfig::get_bool to read the configuration file, thereby insisting that the configuration values be a boolean.

-f

Use VestaConfig::get_float to read the configuration file, thereby insisting that the configuration values be a floating-point value.

-w

Prefix value with filename and line number that defined it. (Mnemonic: "Where was this setting assigned?") If the value is not defined, nothing will be printed.

-W

Like -w, but print values of all settings of [section]name found and prefix each with filename and line number that defined it. If multiple settings are found, the last one printed is the value actually used.

-s [section]

Print out all the sections, one per line. If a section name is given, prints out the names of all variables in the section, one per line.

See Also

vesta-intro(1), repos-ui(1) vesta.cfg(5)

Author

Tim Mann