Debian Codegraph @

upstream/mageia-cauldron/man5/dnf5.conf-vendorpolicy.5

raw
1 .\" Man page generated from reStructuredText.
2 .
3 .
4 .nr rst2man-indent-level 0
5 .
6 .de1 rstReportMargin
7 \\$1 \\n[an-margin]
8 level \\n[rst2man-indent-level]
9 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
10 -
11 \\n[rst2man-indent0]
12 \\n[rst2man-indent1]
13 \\n[rst2man-indent2]
14 ..
15 .de1 INDENT
16 .\" .rstReportMargin pre:
17 . RS \\$1
18 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
19 . nr rst2man-indent-level +1
20 .\" .rstReportMargin post:
21 ..
22 .de UNINDENT
23 . RE
24 .\" indent \\n[an-margin]
25 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
26 .nr rst2man-indent-level -1
27 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
28 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
29 ..
30 .TH "DNF5.CONF-VENDORPOLICY" "5" "May 10, 2026" "" "dnf5"
31 .SH NAME
32 dnf5.conf-vendorpolicy \- DNF5 Vendor Change Policy File Reference
33 .SH DESCRIPTION
34 .sp
35 The vendor change policy configuration files define rules for allowed package vendor changes.
36 They specify which vendors (outgoing) are allowed to change to which other vendors (incoming).
37 Vendor matching is performed during package replacement (upgrade/downgrade/reinstall) operations
38 when the \fI\%allow_vendor_change\fP option is disabled.
39 .sp
40 The configuration files use \fBTOML format\fP\&.
41 .SH SUPPORTED VERSIONS
42 .sp
43 The vendor change policy configuration format supports two versions:
44 .INDENT 0.0
45 .IP \(bu 2
46 \fBVersion 1.1\fP \- Enhanced version with flexible vendor mapping and package filtering. See \fI\%DNF5 Vendor Change Policy File Reference \- v1.1\fP
47 .IP \(bu 2
48 \fBVersion 1.0\fP \- Basic vendor mapping with strict rules. See \fI\%DNF5 Vendor Change Policy File Reference \- v1.0\fP
49 .UNINDENT
50 .sp
51 Each configuration file must specify its version using the \fBversion\fP field.
52 .sp
53 \fBNOTE:\fP
54 .INDENT 0.0
55 .INDENT 3.5
56 Version 1.1 is the recommended format and is fully backward compatible with version 1.0.
57 All valid 1.0 configurations work with 1.1 by simply changing the version field.
58 Version 1.0 is maintained only for compatibility with existing configurations.
59 .UNINDENT
60 .UNINDENT
61 .sp
62 For detailed information about each version\(aqs syntax and features, please refer to the
63 version\-specific documentation:
64 .INDENT 0.0
65 .IP \(bu 2
66 \fI\%DNF5 Vendor Change Policy File Reference \- v1.1\fP
67 .IP \(bu 2
68 \fI\%DNF5 Vendor Change Policy File Reference \- v1.0\fP
69 .UNINDENT
70 .SH CONFIGURATION FILE LOCATIONS
71 .sp
72 Vendor change policy files are read from the following directories:
73 .INDENT 0.0
74 .TP
75 .B \fB/etc/dnf/vendors.d/\fP
76 System configuration directory
77 .TP
78 .B \fB/usr/share/dnf5/vendors.d/\fP
79 Distribution configuration directory
80 .UNINDENT
81 .sp
82 Only files with the \fB\&.conf\fP extension are considered. Configuration files are sorted
83 alphanumerically by their filename and then read in this sorted order.
84 .sp
85 If a file with the same name exists in both directories, the file from \fB/etc/dnf/vendors.d/\fP
86 is used. This implies that the distribution configuration file can be simply overridden
87 by creating a file with the same name in the \fB/etc/dnf/vendors.d/\fP directory.
88 .SH SEE ALSO
89 .INDENT 0.0
90 .IP \(bu 2
91 \fI\%DNF5 Vendor Change Policy File Reference \- v1.1\fP
92 .IP \(bu 2
93 \fI\%DNF5 Vendor Change Policy File Reference \- v1.0\fP
94 .IP \(bu 2
95 \fBdnf5.conf(5)\fP, \fI\%DNF5 Configuration Reference\fP
96 .UNINDENT
97 .SH AUTHOR
98 See AUTHORS.md in dnf5 source distribution.
99 .SH COPYRIGHT
100 Contributors to the dnf5 project.
101 .\" Generated by docutils manpage writer.
102 .