1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
.. image:: https://translate.fedoraproject.org/widgets/dnf/-/dnf-master/svg-badge.svg
:alt: Translation status
:target: https://translate.fedoraproject.org/engage/dnf/?utm_source=widget
==================================================================================================================================================================================================
⚠️ **Notice:** This repository is for **DNF4** only. The current DNF version (DNF5) has its `own repo <https://github.com/rpm-software-management/dnf5>`_.
==================================================================================================================================================================================================
#################
Dandified YUM 4
#################
.. image:: https://raw.githubusercontent.com/rpm-software-management/dnf/gh-pages/logos/DNF_logo.png
Dandified YUM 4 (DNF) is the 4th iteration of next upcoming major version of `YUM <http://yum.baseurl.org/>`_. It does package management using `RPM <http://rpm.org/>`_, `libsolv <https://github.com/openSUSE/libsolv>`_ and `hawkey <https://github.com/rpm-software-management/hawkey>`_ libraries. For metadata handling and package downloads it utilizes `librepo <https://github.com/tojaj/librepo>`_. To process and effectively handle the comps data it uses `libcomps <https://github.com/midnightercz/libcomps>`_.
Join us on IRC at ``#dnf`` on `Libera.Chat <https://libera.chat>`_. Questions should be asked there, issues discussed. Remember: ``#dnf`` is not a support channel, and prior research is expected from the questioner.
============
Installing
============
DNF4 and all its dependencies are available in Fedora 18 and later, including the
rawhide Fedora.
Optionally you can use repositories with DNF nightly builds for last 2 stable Fedora versions available at copr://rpmsoftwaremanagement/dnf-nightly. You can enable the repository e.g. using::
dnf copr enable rpmsoftwaremanagement/dnf-nightly
Then install DNF typing::
sudo yum install dnf4
In other RPM-based distributions you need to build all the components from their
sources.
======================
Building from source
======================
All commands should be run from the DNF git checkout directory.
To install the build dependencies::
sudo dnf builddep dnf.spec
To build DNF::
mkdir build;
pushd build;
cmake ..; # add '-DPYTHON_DESIRED="3"' option for Python 3 build
make;
popd;
To run DNF when compiled for Python2::
PYTHONPATH=`readlink -f .` bin/dnf-2 <arguments>
To run DNF when compiled for Python3::
PYTHONPATH=`readlink -f .` bin/dnf-3 <arguments>
If you want to build the manpages, use the option ``-DWITH_MAN=0`` with cmake.
Man pages will be located in ``build/doc`` and can be read with ``man -l``, e.g::
man -l build/doc/dnf4.8
=============================
Building and installing rpm
=============================
From the DNF git checkout directory::
$ tito build --test --rpm
# dnf install /tmp/tito/noarch/*
===============
Running tests
===============
From the DNF git checkout directory::
mkdir build;
pushd build;
cmake .. && make ARGS="-V" test;
popd;
==============
Contribution
==============
Here's the most direct way to get your work merged into the project.
1. Fork the project
#. Clone down your fork
#. Implement your feature or bug fix and commit changes
#. If the change fixes a bug at `Red Hat bugzilla <https://bugzilla.redhat.com/>`_, or if it is important to the end user, add the following block to the commit message::
= changelog =
msg: message to be included in the changelog
type: one of: bugfix/enhancement/security (this field is required when message is present)
resolves: URLs to bugs or issues resolved by this commit (can be specified multiple times)
related: URLs to any related bugs or issues (can be specified multiple times)
* For example::
= changelog =
msg: Verify GPG signatures when running dnf-automatic
type: bugfix
resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1793298
* For your convenience, you can also use git commit template by running the following command in the top-level directory of this project::
git config commit.template ./.git-commit-template
#. In special commit add your name and email under ``DNF CONTRIBUTORS`` section in `authors file <https://github.com/rpm-software-management/dnf/blob/master/AUTHORS>`_ as a reward for your generosity
#. Push the branch up to your fork
#. Send a pull request for your branch
Please, do not create the pull requests with translation (.po) files improvements. Fix the translation on `Fedora Weblate <https://translate.fedoraproject.org/projects/dnf/>`_ instead.
===============
Documentation
===============
The DNF package distribution contains man pages, dnf(8) and dnf.conf(8). It is also possible to `read the DNF documentation <http://dnf.readthedocs.org>`_ online, the page includes API documentation. There's also a `wiki <https://github.com/rpm-software-management/dnf/wiki>`_ meant for contributors to DNF and related projects.
===============
Bug reporting
===============
Please report discovered bugs to `GitHub Issues <https://github.com/rpm-software-management/dnf/issues>`_ or to the `Red Hat bugzilla <https://bugzilla.redhat.com/>`_. If you plan to propose the patch in the report, consider `Contribution`_ instead.
|
