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        [ --root <ROOT> ]
28
29
30
31        [ -c, --clean ]
32
33
34
35        [ -d, --debug ]
36
37
38
39        [ -D, --diff ]
40
41
42
43        [ -t, --test ]
44
45
46
47        [ -x, --exclude <DIRECTORY> ]
48
49
50
51        [ -Z ]
52
53
54

DESCRIPTION

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

OPTIONS

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

SEE ALSO

122       rpm(8)
123

AUTHORS

125       Miroslav Suchý <msuchy@redhat.com>
126
127
128
129Version 0.2                      29 July 2020                       RPMCONF(8)