| 1 |
.\" auto-generated by docbook2man-spec from docbook-utils package |
| 2 |
.TH "RPMCONF" "8" "04 August 2025" "Version 0.2" "" |
| 3 |
.SH NAME |
| 4 |
rpmconf \- This tool searches for .rpmnew, .rpmsave and .rpmorig files and asks you what to do with them: keep the current version, replace with the previous version, or review the diff. |
| 5 |
.SH SYNOPSIS |
| 6 |
.sp |
| 7 |
.nf |
| 8 |
|
| 9 |
.sp |
| 10 |
\fBrpmconf\fR [ \fBoptions \fI\&...\fB\fR ] |
| 11 |
|
| 12 |
|
| 13 |
.sp |
| 14 |
[ \fB-a, --all\fR ] |
| 15 |
|
| 16 |
|
| 17 |
.sp |
| 18 |
[ \fB-o\fI<package>\fB, --owner=\fI<package>\fB\fR ] |
| 19 |
|
| 20 |
|
| 21 |
.sp |
| 22 |
[ \fB-f\fI<type>\fB --frontend=\fI<type>\fB\fR ] |
| 23 |
|
| 24 |
|
| 25 |
.sp |
| 26 |
[ \fB--root \fI<ROOT>\fB\fR ] |
| 27 |
|
| 28 |
|
| 29 |
.sp |
| 30 |
[ \fB-c, --clean\fR ] |
| 31 |
|
| 32 |
|
| 33 |
.sp |
| 34 |
[ \fB-d, --debug\fR ] |
| 35 |
|
| 36 |
|
| 37 |
.sp |
| 38 |
[ \fB-D, --diff\fR ] |
| 39 |
|
| 40 |
|
| 41 |
.sp |
| 42 |
[ \fB-t, --test\fR ] |
| 43 |
|
| 44 |
|
| 45 |
.sp |
| 46 |
[ \fB-u, --unattended \fI[<MODE>]\fB\fR ] |
| 47 |
|
| 48 |
|
| 49 |
.sp |
| 50 |
[ \fB-x, --exclude \fI<DIRECTORY>\fB\fR ] |
| 51 |
|
| 52 |
|
| 53 |
.sp |
| 54 |
[ \fB-Z\fR ] |
| 55 |
|
| 56 |
.sp |
| 57 |
.fi |
| 58 |
.SH "DESCRIPTION" |
| 59 |
.PP |
| 60 |
Rpmconf will search for all config file of given package (or all |
| 61 |
installed 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 |
.PP |
| 66 |
Additionally, rpmconf can also handle application configuration, if |
| 67 |
the application supports rpmconf. The application must have an |
| 68 |
executable file present in /usr/share/rpmconf/. The file must have the |
| 69 |
same name as package itself and the package must own that file. The |
| 70 |
executable must be idempotent, i.e. subsequent executions should have |
| 71 |
no effect. Ideally it should be a Puppet/Chef/Ansible/CFengine manifest. |
| 72 |
.SH "OPTIONS" |
| 73 |
.TP |
| 74 |
\fB-a, --all\fR |
| 75 |
Check configuration files of all packages. |
| 76 |
.TP |
| 77 |
\fB-o<package>, --owner=<package>\fR |
| 78 |
Check only configuration files of given package. |
| 79 |
.TP |
| 80 |
\fB-f<type>, --frontend=<type>\fR |
| 81 |
Define which frontend should be used for merging. Valid options are: vimdiff, gvimdiff, diffuse, kdiff3, meld, sdiff and env. When set to env, the command to use is taken from the environment variable $MERGE. The default is env. |
| 82 |
.TP |
| 83 |
\fB-c, --clean\fR |
| 84 |
Find all .rpmnew and .rpmsave files in /etc and /var directories. List all files belonging to installed packages, then write all files which are orphaned and ask if it is safe to delete them. |
| 85 |
.TP |
| 86 |
\fB-d, --debug\fR |
| 87 |
Dry run. Instead of executing an action (move or delete a file) the filename will |
| 88 |
be echoed to standard output. However, the executable for merging of configuration files |
| 89 |
will still be executed. Beware that this option is position-sensitive: only actions specified after --debug are dry-run, e.g. --all --debug --clean will run --clean in dry run mode but not --all. |
| 90 |
.TP |
| 91 |
\fB-D, --diff\fR |
| 92 |
Non-interactive diff mode. |
| 93 |
This option works with --owner and --all\&. |
| 94 |
Useful to audit config files after package upgrades. |
| 95 |
.TP |
| 96 |
\fB--root ROOT\fR |
| 97 |
Specifies an alternative installroot, relative to where all packages are installed. |
| 98 |
.TP |
| 99 |
\fB-t, --test\fR |
| 100 |
Just test existence of files to merge. If there is some file to merge then rpmconf |
| 101 |
will print it and exit with status code 5. If there are none to merge, then exit |
| 102 |
with status code 0. |
| 103 |
.TP |
| 104 |
\fB-u [<MODE>], --unattended [<MODE>]\fR |
| 105 |
Unattended mode. |
| 106 |
Do not prompt user, but perform actions based on MODE. Valid options are: use_maintainer, use_your, default. |
| 107 |
use_maintainer replaces existing configuration files with .rpmnew files and deletes leftover .rpmsave and |
| 108 |
\&.rpmorig files. use_your deletes .rpmnew files and replaces existing configuration files with .rpmsave files. |
| 109 |
default does use_your for .rpmnew files and use_maintainer for .rpmsave files, as are the default prompts |
| 110 |
in interactive mode. |
| 111 |
Specifying MODE is optional, default is used by default. |
| 112 |
.TP |
| 113 |
\fB-V, --version\fR |
| 114 |
Display rpmconf version. This option expects that this script |
| 115 |
is installed as rpm package. |
| 116 |
.TP |
| 117 |
\fB-x, --exclude [DIRECTORY [DIRECTORY ...]]\fR |
| 118 |
Exclude DIRECTORY from checking. Applies only for -c. |
| 119 |
.TP |
| 120 |
\fB-Z\fR |
| 121 |
Display the SELinux contexts of the old and new files. Note: if you choose to install .rpmsave version. It is copied to the original filename, therefore its SELinux context is reset to the default value specified by SELinux policy. |
| 122 |
.SH "SEE ALSO" |
| 123 |
|
| 124 |
rpm(8) |
| 125 |
.SH "AUTHORS" |
| 126 |
|
| 127 |
Miroslav Suchý <[email protected]> |