Debian Codegraph @

upstream/debian-unstable/man5/dnf5.conf-vendorpolicy.5

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