dnf: update `use_backend` documentation (#83429) (#83451)

* add note about backwards compatibility

(cherry picked from commit 1ed29416db)
pull/83504/head
flowerysong 1 year ago committed by GitHub
parent e8c6eb1f6f
commit 5302e2cea2
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

@ -19,9 +19,15 @@ description:
options: options:
use_backend: use_backend:
description: description:
- By default, this module will select the backend based on the C(ansible_pkg_mgr) fact. - Backend module to use.
default: "auto" default: "auto"
choices: [ auto, yum, yum4, dnf4, dnf5 ] choices:
auto: Automatically select the backend based on the C(ansible_facts.pkg_mgr) fact.
yum: Alias for V(auto) (see Notes)
dnf: M(ansible.builtin.dnf)
yum4: Alias for V(dnf)
dnf4: Alias for V(dnf)
dnf5: M(ansible.builtin.dnf5)
type: str type: str
version_added: 2.15 version_added: 2.15
name: name:
@ -287,6 +293,11 @@ notes:
upstream dnf's API doesn't properly mark groups as installed, therefore upon upstream dnf's API doesn't properly mark groups as installed, therefore upon
removal the module is unable to detect that the group is installed removal the module is unable to detect that the group is installed
(https://bugzilla.redhat.com/show_bug.cgi?id=1620324) (https://bugzilla.redhat.com/show_bug.cgi?id=1620324)
- While O(use_backend=yum) and the ability to call the action plugin as
M(ansible.builtin.yum) are provided for syntax compatibility, the YUM
backend was removed in ansible-core 2.17 because the required libraries are
not available for any supported version of Python. If you rely on this
functionality, use an older version of Ansible.
requirements: requirements:
- "python >= 2.6" - "python >= 2.6"
- python-dnf - python-dnf
@ -1336,7 +1347,7 @@ def main():
# list=repos # list=repos
# list=pkgspec # list=pkgspec
yumdnf_argument_spec['argument_spec']['use_backend'] = dict(default='auto', choices=['auto', 'yum', 'yum4', 'dnf4', 'dnf5']) yumdnf_argument_spec['argument_spec']['use_backend'] = dict(default='auto', choices=['auto', 'dnf', 'yum', 'yum4', 'dnf4', 'dnf5'])
module = AnsibleModule( module = AnsibleModule(
**yumdnf_argument_spec **yumdnf_argument_spec

Loading…
Cancel
Save