crudini (1) Linux Manual Page

NAME

crudini – manipulate ini files

SYNOPSIS

crudini ,–set /[,OPTION/]… ,config_file section /[,param/] [,value/]
crudini ,–get /[,OPTION/]… ,config_file /[,section/] [,param/]
crudini ,–del /[,OPTION/]… ,config_file section /[,param/] [,list value/]
crudini ,–merge /[,OPTION/]… ,config_file /[,section/]

DESCRIPTION

crudini – A utility for manipulating ini files

OPTIONS

–existing[=,WHAT/]

For –set, –del and –merge, fail if item is missing, where WHAT is ‘file’, ‘section’, or ‘param’, or if not specified; all specifed items.

–format=,FMT/

For –get, select the output FMT. Formats are sh,ini,lines

–inplace

Lock and write files in place. This is not atomic but has less restrictions than the default replacement method.

–list

For –set and –del, update a list (set) of values

–list-sep=,STR/

Delimit list values with "STR" instead of " ,"

–output=,FILE/

Write output to FILE instead. ‘-‘ means stdout

–verbose

Indicate on stderr if changes were made

EXAMPLES

# Add/Update a var

crudini –set config_file section parameter value

# Update an existing var

crudini –set –existing config_file section parameter value

# Delete a var

crudini –del config_file section parameter

# Delete a section

crudini –del config_file section

# output a value

crudini –get config_file section parameter

# output a global value not in a section

crudini –get config_file ” parameter

# output a section

crudini –get config_file section

# output a section, parseable by shell

eval $(crudini –get –format=sh config_file section)

# update an ini file from shell variable(s)

echo name="$name" | crudini –merge config_file section

# merge an ini file from another ini

crudini –merge config_file < another.ini

# compare two ini files using standard UNIX text processing

diff <(crudini –get –format=lines file1.ini|sort) \

<(crudini –get –format=lines file2.ini|sort)

Index