Debian Codegraph @

upstream/mageia-cauldron/man8/rpmconf.8

raw
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]>