.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.4.
.TH CRUDINI "1" "August 2019" "crudini 0.9.3" "User Commands"
.SH NAME
crudini \- manipulate ini files
.SH SYNOPSIS
.B crudini
\fI\,--set \/\fR[\fI\,OPTION\/\fR]...   \fI\,config_file section   \/\fR[\fI\,param\/\fR] [\fI\,value\/\fR]
.br
.B crudini
\fI\,--get \/\fR[\fI\,OPTION\/\fR]...   \fI\,config_file \/\fR[\fI\,section\/\fR] [\fI\,param\/\fR]
.br
.B crudini
\fI\,--del \/\fR[\fI\,OPTION\/\fR]...   \fI\,config_file section   \/\fR[\fI\,param\/\fR] [\fI\,list value\/\fR]
.br
.B crudini
\fI\,--merge \/\fR[\fI\,OPTION\/\fR]... \fI\,config_file \/\fR[\fI\,section\/\fR]
.SH DESCRIPTION
crudini \- A utility for manipulating ini files
.SH OPTIONS
.TP
\fB\-\-existing\fR[=\fI\,WHAT\/\fR]
For \fB\-\-set\fR, \fB\-\-del\fR and \fB\-\-merge\fR, fail if item is missing,
where WHAT is 'file', 'section', or 'param', or if
not specified; all specified items.
.TP
\fB\-\-format\fR=\fI\,FMT\/\fR
For \fB\-\-get\fR, select the output FMT.
Formats are sh,ini,lines
.TP
\fB\-\-inplace\fR
Lock and write files in place.
This is not atomic but has less restrictions
than the default replacement method.
.TP
\fB\-\-list\fR
For \fB\-\-set\fR and \fB\-\-del\fR, update a list (set) of values
.TP
\fB\-\-list\-sep\fR=\fI\,STR\/\fR
Delimit list values with "STR" instead of " ,"
.TP
\fB\-\-output\fR=\fI\,FILE\/\fR
Write output to FILE instead. '\-' means stdout
.TP
\fB\-\-verbose\fR
Indicate on stderr if changes were made
.TP
\fB\-\-help\fR
Write this help to stdout
.TP
\fB\-\-version\fR
Write version to stdout
.SH EXAMPLES
# Add/Update a var
.IP
crudini \-\-set config_file section parameter value
.PP
# Update an existing var
.IP
crudini \-\-set \-\-existing config_file section parameter value
.PP
# Delete a var
.IP
crudini \-\-del config_file section parameter
.PP
# Delete a section
.IP
crudini \-\-del config_file section
.PP
# output a value
.IP
crudini \-\-get config_file section parameter
.PP
# output a global value not in a section
.IP
crudini \-\-get config_file '' parameter
.PP
# output a section
.IP
crudini \-\-get config_file section
.PP
# output a section, parseable by shell
.IP
eval $(crudini \-\-get \-\-format=sh config_file section)
.PP
# update an ini file from shell variable(s)
.IP
echo name="$name" | crudini \-\-merge config_file section
.PP
# merge an ini file from another ini
.IP
crudini \-\-merge config_file < another.ini
.PP
# compare two ini files using standard UNIX text processing
.IP
diff <(crudini \-\-get \-\-format=lines file1.ini|sort) \e
.IP
<(crudini \-\-get \-\-format=lines file2.ini|sort)