1RPMCONF(8)                                                          RPMCONF(8)
2
3
4

NAME

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

SYNOPSIS

11       rpmconf [ options ... ]
12
13
14
15        [ -a, --all ]
16
17
18
19        [ -o<package>, --owner=<package> ]
20
21
22
23        [ -f<type> --frontend=<type> ]
24
25
26
27        [ -c, --clean ]
28
29
30
31        [ -d, --debug ]
32
33
34
35        [ -D, --diff ]
36
37
38
39        [ -t, --test ]
40
41
42
43        [ -Z ]
44
45
46

DESCRIPTION

48       Rpmconf  will  search  for  all  config  file  of given package (or all
49       installed packages) and will check if coresponding .rpmsave, .rpmnew or
50       .rpmorig  files exist. If so, you will be asked if you want to keep the
51       current version, revert to the previous version, or diff the two files.
52       The unwanted file is then deleted.
53
54       Additionally, rpmconf can also handle application configuration, if the
55       application supports rpmconf. The application must have  an  executable
56       file  present  in /usr/share/rpmconf/. The file must have the same name
57       as package itself and the package must own that  file.  The  executable
58       must  be  idempotent, i.e. subsequent executions should have no effect.
59       Ideally it should be a Puppet/Chef/Ansible/CFengine manifest.
60

OPTIONS

62       -a, --all
63              Check configuration files of all packages.
64
65       -o<package>, --owner=<package>
66              Check only configuration files of given package.
67
68       -f<type>, --frontend=<type>
69              Define which frontend should be used for merging. Valid  options
70              are:  vimdiff,  gvimdiff,  diffuse, kdiff3, meld, sdiff and env.
71              When set to env, the command to use is taken from  the  environ‐
72              ment variable $MERGE. The default is env.
73
74       -c, --clean
75              Find  all  .rpmnew  and .rpmsave files in /etc and /var directo‐
76              ries. List all files belonging to installed packages, then write
77              all  files  which  are  orphaned and ask if it is safe to delete
78              them.
79
80       -d, --debug
81              Dry run. Instead of executing an action (move or delete a  file)
82              the  filename  will  be  echoed to standard output. However, the
83              executable for merging of configuration files will still be exe‐
84              cuted.  Beware  that  this  option  is  position-sensitive: only
85              actions specified after --debug are dry-run, e.g. --all  --debug
86              --clean will run --clean in dry run mode but not --all.
87
88       -D, --diff
89              Non-interactive  diff  mode.  This option works with --owner and
90              --all.  Useful to audit config files after package upgrades.
91
92       -t, --test
93              Just test existence of files to merge. If there is some file  to
94              merge then rpmconf will print it and exit with status code 5. If
95              there are none to merge, then exit with status code 0.
96
97       -V, --version
98              Display rpmconf version. This option expects that this script is
99              installed as rpm package.
100
101       -Z     Display  the SELinux contexts of the old and new files. Note: if
102              you choose to install .rpmsave version.  It  is  copied  to  the
103              original filename, therefore its SELinux context is reset to the
104              default value specified by SELinux policy.
105

SEE ALSO

107       rpm(8)
108

AUTHORS

110       Miroslav Suchý <msuchy@redhat.com>
111
112
113
114Version 0.2                     30 January 2020                     RPMCONF(8)