DNF5 Vendor Change Policy File Reference

Description

The vendor change policy configuration files define rules for allowed package vendor changes. They specify which vendors (outgoing) are allowed to change to which other vendors (incoming). Vendor matching is performed during package replacement (upgrade/downgrade/reinstall) operations when the allow_vendor_change option is disabled.

The configuration files use TOML format.

Supported Versions

The vendor change policy configuration format supports three versions:

Each configuration file must specify its version using the version field.

Note

Each newer version is fully backward compatible with all previous versions. Version 1.2 only adds new comparators over 1.1, and version 1.1 adds flexible vendor mapping and package filtering over 1.0. All valid configurations work with a newer version by simply changing the version field. Version 1.2 is the recommended format.

For detailed information about each version’s syntax and features, please refer to the version-specific documentation:

Configuration File Locations

Vendor change policy files are read from the following directories:

/etc/dnf/vendors.d/

System configuration directory

/usr/share/dnf5/vendors.d/

Distribution configuration directory

Only files with the .conf extension are considered. Configuration files are sorted alphanumerically by their filename and then read in this sorted order.

If a file with the same name exists in both directories, the file from /etc/dnf/vendors.d/ is used. This implies that the distribution configuration file can be simply overridden by creating a file with the same name in the /etc/dnf/vendors.d/ directory.

See Also