xbot/include/libconfig-1.7.3/contrib/ls-config/doc/bin.api.txt
2024-02-13 01:22:10 -06:00

76 lines
2.4 KiB
Plaintext
Executable File

Instalation:
------------
First place somewhere ls-config binary, or make it from source
Then if You woud like use it with national translation, then You muas build
it form source and then copy *.mo files according to You system
Usage:
------
Remember to call ls-config always with -f parameter,
wich give ls-config inormation wich config file use.
Then this program operate in three based modes:
-g (get) for reading values (default)
-s (set) for store values
-h (help) for display help message
both parameter (-g and -s) nedd to give it variable path
(internal configuration variable path)
for exapmle read info value from config file:
ls-config -f config -g info
Then You can set this value to another
ls-config -f config -s info -d "Somethint to write"
But when You wand to addn new configutation variable you must
specify his type:
ls-config -f config -s someint -d 10 -p int
You can remove (unset) variable too. This is subfunstion of setting:
ls-config -f config -s someint -u
When reading You cent use following flag:
-v - read only variable valut
-t - read only variable type
-c - read only variable element count (sense only in types: array, list, group)
-i - read only variable index (sense only in type: array, list)
-n - read only variable name
and sometimes usable
-q - to wori in quiet mode usable in scripts.
For example to read variable somevar type, where variable in group foo:
ls-config -f config -g "foo.somevar" -t
For detailed list of parametera (long options available too) run ls-config
in help mode:
ls-config -h
Configuraiton files:
--------------------
Detailed configuration file shema are publicated on:
http://www.hyperrealm.com/libconfig/
And his gramar on:
http://www.hyperrealm.com/libconfig/libconfig_manual.html#Configuration-Files
there are only short describe:
configuration = setting-list | empty
setting-list = setting | setting-list setting
setting = name (":" | "=") value (";" | "," | empty)
value = scalar-value | array | list | group
value-list = value | value-list "," value
scalar-value = boolean | integer | integer64 | hex | hex64 | float | string
scalar-value-list = scalar-value | scalar-value-list "," scalar-value
array = "[" (scalar-value-list | empty) "]"
list = "(" (value-list | empty) ")"
group = "{" (setting-list | empty) "}"
empty =
smaple configuration file and script are available on sample/ directory
config - samble configuration file
script - sample script, then read info variable from config file