Your company here — click to reach over 10,000 unique daily visitors

rust2rpm.conf - Man Page

package-specific configuration file for *rust2rpm* (deprecated)


Some aspects of rust2rpm(1) can be configured by setting package-specific preferences in a rust2rpm.conf file. If a file with this name is present in the current working directory when running rust2rpm, it is loaded automatically.

This configuration file format is deprecated and has been superseded by rust2rpm.toml(5), which supports a superset of the settings that are available in rust2rpm.conf.

The file format for rust2rpm.conf is based on the INI format as implemented in the configparser module from the Python standard library. Notably, settings in the [DEFAULT] section can be overridden by target-specific settings (i.e. with settings under a [fedora], [mageia], or [plain] section). This rarely used support for layered settings has not been implemented in rust2rpm.toml(5).



This setting is used to override the value of the RPM "Summary" tag and can be used if the summary generated from crate metadata based on heuristics is not good enough.


This setting can be used to specify that the crate only has support for limited architectures (i.e. not all CPU architectures that are supported by the distribution). This setting accepts a line-separated / indented list of target architectures. If this setting is present, the "cargo build" and "cargo test" steps in the generated spec file are wrapped with "%ifarch" conditionals.


When enabled, this setting causes the "-a" / "--all-features" flag to be passed to all cargo calls. This can be used for crates where running tests requires optional features to be enabled, or for applications where enabling all features is desirable. This setting accepts a "bool-like" value. Setting all-features to true-ish requires the enabled-features setting to be unspecified or to be empty.


This setting provides more fine-grained control for passing feature flags to cargo calls. It accepts a line-separated / indented list of names of enabled features. Setting enabled-features to a non-empty list requires the all-features setting to be unspecified or to be false-ish.


This setting can be used to prevent subpackages for crate features and implicit features for optional dependencies from being generated in the spec file. For example, this can be useful for crates that have unused non-default features which pull in additional dependencies. It accepts a line-separated / indented list of names of "unwanted" crate features.
NOTE: Care needs to be taken to only "hide" features / optional dependencies that are not dependencies of other "non-hidden" features, otherwise the subpackages for the dependent features will have unsatisfiable dependencies. All features that are marked as "unwanted" by this setting must be "unreachable" via feature dependencies from any feature subpackages that are still present in the generated spec file. In some circumstances, the only way to cleanly handle removal of unused non-default features is to patch Cargo.toml instead.


Additional BuildRequires for the package can be specified with this setting. It accepts a line-separated / indented list of BuildRequires in the syntax supported by RPM. The BuildRequires included in this setting are either added in the %generare_buildrequires scriptlet for targets where this is enabled, or as plain BuildRequires for targets without dynamically generated BuildRequires.


This setting allows specifying additional BuildRequires that are only needed when running a project’s test suite (i.e. "cargo test"). It works the same as the setting for additional BuildRequires, except that all entries are wrapped in an "%if %{with check}" conditional.


With this setting, additional dependencies (Requires) for the main "-devel" subpackage of a "library crate" can be specified. For example, many "-sys" bindings require the development headers for the wrapped C library to be present during both build time of the package for the crate itself and when building a package that depends on this crate. In these cases, the same dependency often needs to be added as both buildrequires and lib.requires. This setting accepts a list of line-separated / indented RPM dependencies.


This setting works just like lib.requires, except for adding additional dependencies to subpackages for crate features. It can be specified multiple times, and dependencies listed for "foo" are added to the "-devel" subpackage for feature "foo" instead. Only valid feature names are accepted, specifying a non-existent feature will cause a validation failure.


For crates that include application binaries / executables, this setting can be used to add additional dependencies for the subpackage that contains these executables. The accepted values are line-separated / indented strings that are valid RPM dependencies.

Migrating to rust2rpm.toml

The rust2rpm.toml(5) configuration file format supports a superset of the settings available in rust2rpm.conf, except that "layered" configuration is not supported.


Bindings for system libraries

One typical use case for a rust2rpm.conf file are in packages for crates that contain bindings for system libraries, especially if crate features are used to control which APIs of the library are made available.

Example file from the package for "gtk4-sys" version 0.7.3 on Fedora 38, where version 4.10 of gtk4 is available:

unwanted-features =
buildrequires =
  pkgconfig(gtk4) >= 4.0.0
lib.requires =
  pkgconfig(gtk4) >= 4.0.0
lib+v4_2.requires =
  pkgconfig(gtk4) >= 4.2
lib+v4_4.requires =
  pkgconfig(gtk4) >= 4.4
lib+v4_6.requires =
  pkgconfig(gtk4) >= 4.6
lib+v4_8.requires =
  pkgconfig(gtk4) >= 4.7
lib+v4_10.requires =
  pkgconfig(gtk4) >= 4.10

External dependencies of the Rust standard library

The Rust standard library depends on some crates that are also published separately, and a "hack" is used when building these crates as part of "std". The crate features and optional dependencies that are used for this purpose are useless in other situations.

Example file from the package for "libc" version 0.2.148:

unwanted-features =
buildrequires =
lib.requires =



See Also

rust2rpm(1), rust2rpm.toml(5)

Referenced By

rust2rpm(1), rust2rpm.toml(5).

2024-06-08 rust2rpm