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        [ -u, --unattended [<MODE>] ]
48
49
50
51        [ -x, --exclude <DIRECTORY> ]
52
53
54
55        [ -Z ]
56
57
58

DESCRIPTION

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
66       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

OPTIONS

74       -a, --all
75              Check configuration files of all packages.
76
77       -o<package>, --owner=<package>
78              Check only configuration files of given package.
79
80       -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
86       -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
92       -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
100       -D, --diff
101              Non-interactive  diff  mode.  This option works with --owner and
102              --all.  Useful to audit config files after package upgrades.
103
104       --root ROOT
105              Specifies an alternative  installroot,  relative  to  where  all
106              packages are installed.
107
108       -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
113       -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
124       -V, --version
125              Display rpmconf version. This option expects that this script is
126              installed as rpm package.
127
128       -x, --exclude [DIRECTORY [DIRECTORY ...]]
129              Exclude DIRECTORY from checking. Applies only for -c.
130
131       -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

SEE ALSO

137       rpm(8)
138

AUTHORS

140       Miroslav Suchý <msuchy@redhat.com>
141
142
143
144Version 0.2                      23 July 2021                       RPMCONF(8)
Impressum