1CRUDINI(1)                       User Commands                      CRUDINI(1)
2
3
4

NAME

6       crudini - manipulate ini files
7

SYNOPSIS

9       crudini --set [OPTION]...   config_file section   [param] [value]
10       crudini --get [OPTION]...   config_file [section] [param]
11       crudini --del [OPTION]...   config_file section   [param] [list value]
12       crudini --merge [OPTION]... config_file [section]
13

DESCRIPTION

15       crudini - A utility for manipulating ini files
16

OPTIONS

18       --existing[=WHAT]
19              For  --set,  --del  and  --merge, fail if item is missing, where
20              WHAT is 'file', 'section', or 'param', or if not specified;  all
21              specified items.
22
23       --format=FMT
24              For --get, select the output FMT.  Formats are sh,ini,lines
25
26       --inplace
27              Lock  and write files in place.  This is not atomic but has less
28              restrictions than the default replacement method.
29
30       --list For --set and --del, update a list (set) of values
31
32       --list-sep=STR
33              Delimit list values with "STR" instead of " ,"
34
35       --output=FILE
36              Write output to FILE instead. '-' means stdout
37
38       --verbose
39              Indicate on stderr if changes were made
40
41       --help Write this help to stdout
42
43       --version
44              Write version to stdout
45

EXAMPLES

47       # Add/Update a var
48
49              crudini --set config_file section parameter value
50
51       # Update an existing var
52
53              crudini --set --existing config_file section parameter value
54
55       # Delete a var
56
57              crudini --del config_file section parameter
58
59       # Delete a section
60
61              crudini --del config_file section
62
63       # output a value
64
65              crudini --get config_file section parameter
66
67       # output a global value not in a section
68
69              crudini --get config_file '' parameter
70
71       # output a section
72
73              crudini --get config_file section
74
75       # output a section, parseable by shell
76
77              eval $(crudini --get --format=sh config_file section)
78
79       # update an ini file from shell variable(s)
80
81              echo name="$name" | crudini --merge config_file section
82
83       # merge an ini file from another ini
84
85              crudini --merge config_file < another.ini
86
87       # compare two ini files using standard UNIX text processing
88
89              diff <(crudini --get --format=lines file1.ini|sort) \
90
91              <(crudini --get --format=lines file2.ini|sort)
92
93
94
95crudini 0.9.3                     August 2019                       CRUDINI(1)
Impressum