xref: /aosp_15_r20/external/libconfig/contrib/ls-config/debian/ls-config.1 (revision 2e9d491483b805f09ea864149eadd5680efcc72a)
Created with GNOME Manpages Editor
https://github.com/lucas-net-pl/ls-config
Replace <program> with the program name, x with the Section Number
ls-config x "1" "" "Linux User's Manual"
NAME
ls-config - program to use libconfig9 configuration files in bash scripts ..SH SYNOPSIS ls-config [-f FILE] [ options ]

DESCRIPTION
You can use libcongig9 files directly invoking ls-config. 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)
OPTIONS

-f ", " --file =FILE Configuration file to handle.

-s ", " --set =PATH Set configuration variable of given path.

-d ", " --data =DATA Configuration variable value (only with -s)

-p ", " --type =TYPE Configuration value type

-g ", " --get =PATH Get configuration variable of given path.

-n ", " --names Printout variables names.

-t ", " --types Printout variables types.

-v ", " --values Printout variables values.

-i ", " --indexes Printout variables indexes.

-c ", " --count Printout elements count (only: array, list, group).

-b ", " --bool-string Printout boolean variables as text.

-q ", " --quiet Quiet output to use in scripts.

-h ", " --help Print this help message.

Variable TYPEs: group - variables group, array - array of variables, list - list of variables, int - integer number, int64 - 64bit integer number, float - float point number, bool - boolean value, string - character string.

NOTES
Exiting eerror codes: 0 - exit with no error 1 - Cen't access witch right mode (read or write) configuration file. 2 - (not used), 3 - Variable of given path not found (path not found). 4 - Variable path not given. 5 - Can't remove root element (cused if someone try to unset it) 6 - Can't find parent element 7 - Variable unset failed. 8 - Configuration file write failed. 9 - Variable value not given. 10 - Inconsistent value type (caused if set exisitng variablen and give type another then saved). 11 - Variable set failed. 12 - Incorrect data format. 13 - Variable type not given (in som cases tu set variable, giving his type are necesery). 14 - Inlegal data type (caused if user give type thet not known for libconfig9). 15 - Bad name of variable (curently chcecking only if enpty stringa are given). 16 - Inavlid configuration variable path. 17 - New named configuration variable can be added only to group element. 18 - Prohibited data type (caused when use type then connot be use in given case).