1DNF.PLUGIN.VERSIONLOCK(8)      dnf-plugins-core      DNF.PLUGIN.VERSIONLOCK(8)
2
3
4

NAME

6       dnf.plugin.versionlock - DNF versionlock Plugin
7

DESCRIPTION

9       versionlock  is  a  plugin  that  takes a set of names and versions for
10       packages and excludes all other versions of those packages. This allows
11       you  to  protect  packages from being updated by newer versions. Alter‐
12       nately, it accepts a specific package version to exclude from  updates,
13       e.g.  for  when  it's necessary to skip a specific release of a package
14       that has known issues.
15
16       The plugin provides a command versionlock which allows you to view  and
17       edit the list of locked packages easily.
18
19       The  plugin  will walk each line of the versionlock file, and parse out
20       the name and version of the package. It will then exclude  any  package
21       by  that  name that doesn't match one of the versions listed within the
22       file. This is basically the same as using dnf --exclude for the package
23       name  itself  (as  you cannot exclude installed packages), but dnf will
24       still see the versions you have installed/versionlocked as available so
25       that dnf reinstall will still work, etc.
26
27       It can also work in the opposite way, like a fast exclude, by prefixing
28       a '!' character to the version recorded in the  lock  list  file.  This
29       specifically excludes a package that matches the version exactly.
30
31       Note the versionlock plugin does not apply any excludes in non-transac‐
32       tional operations like repoquery, list, info, etc.
33

SYNOPSIS

35       dnf versionlock [add|exclude|list|delete|clear] [<package-spec>]
36

ARGUMENTS

38       <package-spec>
39              Package spec to lock or exclude.
40

SUBCOMMANDS

42       dnf versionlock add <package-spec>
43              Add a versionlock for all available packages matching the  spec.
44              It  means  that  only versions of packages represented by <pack‐
45              age-spec> will be available for transaction operations.
46
47       dnf versionlock exclude <package-spec>
48              Add an exclude (within  versionlock) for the available  packages
49              matching  the spec. It means that packages represented by <pack‐
50              age-spec> will be excluded from transaction operations.
51
52       dnf versionlock list or dnf versionlock
53              List the current versionlock entries.
54
55       dnf versionlock delete <package-spec>
56              Remove any matching versionlock entries.
57
58       dnf versionlock clear
59              Remove all versionlock entries.
60

CONFIGURATION

62       /etc/dnf/plugins/versionlock.conf
63
64       The minimal content of conf file  should  contain  main  sections  with
65       enabled and locklist parameters.
66
67       locklist
68              This  option  is  a string that points to the file which has the
69              versionlock information in it. Note that the file has  to  exist
70              (or  the versionlock plugin will make dnf exit). However, it can
71              be empty.
72
73              The file takes entries in the format of package-spec (optionally
74              prefixed with '!' for excludes).  See specifying_packages-label.
75

NOTES

77       A  specified  package does not have to exist within the available cache
78       of repository data to be considered valid  for  locking  or  exclusion.
79       This  is  by  design, to accommodate use cases such as a presently dis‐
80       abled repository. However, a package must exist in the repository cache
81       when the add or exclude subcommands are invoked for it.
82

AUTHOR

84       See AUTHORS in your Core DNF Plugins distribution
85

87       2014, Red Hat, Licensed under GPLv2+
88
89
90
91
924.0.2.2                          May 14, 2019        DNF.PLUGIN.VERSIONLOCK(8)
Impressum