1RPMCONF(8) RPMCONF(8)
2
6 rpmconf - This tool searches for .rpmnew, .rpmsave and .rpmorig files
7 and asks you what to do with them: keep the current version, replace
8 with the previous version, or review the diff.
9
11 rpmconf [ options ... ]
12 [ -a, --all ]
16 [ -o<package>, --owner=<package> ]
20 [ -f<type> --frontend=<type> ]
24 [ --root <ROOT> ]
28 [ -c, --clean ]
32 [ -d, --debug ]
36 [ -D, --diff ]
40 [ -t, --test ]
44 [ -u, --unattended [<MODE>] ]
48 [ -x, --exclude <DIRECTORY> ]
52 [ -Z ]
56
60 Rpmconf will search for all config file of given package (or all in‐
61 stalled packages) and will check if coresponding .rpmsave, .rpmnew or
62 .rpmorig files exist. If so, you will be asked if you want to keep the
63 current version, revert to the previous version, or diff the two files.
64 The unwanted file is then deleted.
65 Additionally, rpmconf can also handle application configuration, if the
67 application supports rpmconf. The application must have an executable
68 file present in /usr/share/rpmconf/. The file must have the same name
69 as package itself and the package must own that file. The executable
70 must be idempotent, i.e. subsequent executions should have no effect.
71 Ideally it should be a Puppet/Chef/Ansible/CFengine manifest.
72
74 -a, --all
75 Check configuration files of all packages.
76 -o<package>, --owner=<package>
78 Check only configuration files of given package.
79 -f<type>, --frontend=<type>
81 Define which frontend should be used for merging. Valid options
82 are: vimdiff, gvimdiff, diffuse, kdiff3, meld, sdiff and env.
83 When set to env, the command to use is taken from the environ‐
84 ment variable $MERGE. The default is env.
85 -c, --clean
87 Find all .rpmnew and .rpmsave files in /etc and /var directo‐
88 ries. List all files belonging to installed packages, then write
89 all files which are orphaned and ask if it is safe to delete
90 them.
91 -d, --debug
93 Dry run. Instead of executing an action (move or delete a file)
94 the filename will be echoed to standard output. However, the ex‐
95 ecutable for merging of configuration files will still be exe‐
96 cuted. Beware that this option is position-sensitive: only ac‐
97 tions specified after --debug are dry-run, e.g. --all --debug
98 --clean will run --clean in dry run mode but not --all.
99 -D, --diff
101 Non-interactive diff mode. This option works with --owner and
102 --all. Useful to audit config files after package upgrades.
103 --root ROOT
105 Specifies an alternative installroot, relative to where all
106 packages are installed.
107 -t, --test
109 Just test existence of files to merge. If there is some file to
110 merge then rpmconf will print it and exit with status code 5. If
111 there are none to merge, then exit with status code 0.
112 -u [<MODE>], --unattended [<MODE>]
114 Unattended mode. Do not prompt user, but perform actions based
115 on MODE. Valid options are: use_maintainer, use_your, default.
116 use_maintainer replaces existing configuration files with .rpm‐
117 new files and deletes leftover .rpmsave and .rpmorig files.
118 use_your deletes .rpmnew files and replaces existing configura‐
119 tion files with .rpmsave files. default does use_your for .rpm‐
120 new files and use_maintainer for .rpmsave files, as are the de‐
121 fault prompts in interactive mode. Specifying MODE is optional,
122 default is used by default.
123 -V, --version
125 Display rpmconf version. This option expects that this script is
126 installed as rpm package.
127 -x, --exclude [DIRECTORY [DIRECTORY ...]]
129 Exclude DIRECTORY from checking. Applies only for -c.
130 -Z Display the SELinux contexts of the old and new files. Note: if
132 you choose to install .rpmsave version. It is copied to the
133 original filename, therefore its SELinux context is reset to the
134 default value specified by SELinux policy.
135
137 rpm(8)
138
140 Miroslav Suchý <msuchy@redhat.com>
141Version 0.2 23 July 2021 RPMCONF(8)