rpm-config - Man Page

NAME VALUE

/usr/lib/rpm/macros
/usr/lib/rpm/macros.​d/macros.​*
/usr/lib/rpm/platform/%{_target}/macros
/usr/lib/rpm/fileattrs/*.​attr
/usr/lib/rpm/<vendor>/macros
/etc/rpm/macros.​*
/etc/rpm/macros
/etc/rpm/%{_target}/macros
~/.​config/rpm/macros

The primary configuration mechanism in rpm is rpm-macros(7).​ On startup, rpm reads a set of rpm-macrofile(5) files determined by the macro path.​

Each file or glob(7) pattern in the colon-separated macro path is read sequentially by rpm for macro definitions.​ %{_target} is expanded to the detected <arch>-<os> platform.​ Tildes are expanded to the value of the environment variable HOME.​

If a macro is defined multiple times, the last entry wins.​ The default macro path uses this to achieve the following hierarchy of settings:

1. Generic rpm factory defaults
2. Platform-specific rpm factory defaults
3. Vendor (distribution) specific settings
4. Host specific settings
5. User specific settings
6. Command-line override settings

The default macro path can be inspected with rpm --showrc|grep ^Macro.​

In older versions of rpm, the path of per-user macros was ~/.​rpmmacros.​ This is still processed if it exists and the new configuration directory does not exist.​

The following configurables are supported for the rpm runtime (as opposed to just package building) parts:

%_color_output MODE

Output coloring mode.​ Valid values are never and auto.​

%_db_backend BACKEND

The database backend to use.​ Possible values for BACKEND are:

• dummy: Dummy backend (no actual functionality)
• bdb_ro: Berkeley DB (read-only)
• ndb: Native database (no external dependencies)
• sqlite: Sqlite database

%_dbpath DIRECTORY

The location of the rpm database file(s).​

%_excludedocs VALUE

Boolean (i.​e.​ 1 == "yes", 0 == "no") that controls whether files marked as %doc should be installed.​

%_flush_io VALUE

Flush file IO during transactions (at a severe cost in performance for rotational disks).​ Possible values are 1 to enable, 0 to disable.​

%_group_path PATHS

A colon separated list of group(5) file paths for group name and GID lookups in package operations.​ Files are consulted in the given order until a match is found.​

If unset or empty, rpm uses NSS (Name Service Switch) when operating on the system root, or /etc/group inside the target root when using --root (see rpm-common(8) for details).​

%_httpport PORT

The port of HTTP proxy (used for FTP/HTTP).​

%_httpproxy HOSTNAME

The hostname of HTTP proxy (used for FTP/HTTP).​

%_install_langs LOCALES

A colon separated list of desired locales to be installed; all means install all locale specific files.​

%_install_script_path PATH

The PATH used in rpm-scriptlet(7) execution environment.​

%_keyring BACKEND

The keyring type to use.​ Possible values for BACKEND are:

• fs: Plain ASCII files in a directory
• openpgp: Shared OpenPGP certificate directory
• rpmdb: Pseudo-packages in the rpmdb

%_keyringpath DIRECTORY

The location of the keyring path for non-rpmdb variants.​

%_minimize_writes VALUE

Minimize writes during transactions (at the cost of more reads) to conserve eg SSD disks (EXPERIMENTAL).​ Possible values are:

• 0: disable
• 1: enable
• -1: (or undefined) autodetect on platforms where supported, otherwise default to disabled

%_netsharedpath PATH

A colon separated list of paths where files should not be installed.​ Usually, these are network filesystem mount points.​

%_passwd_path PATHS

A colon separated list of passwd(5) file paths for username and UID lookups in package operations.​ Files are consulted in the given order until a match is found.​

If unset or empty, rpm uses NSS (Name Service Switch) when operating on the system root, or /etc/passwd inside the target root when using --root (see rpm-common(8) for details).​

%_pkgverify_digests HASHALGOS

A colon separated list of hash algorithms to calculate digests on the entire package files during verification.​ The calculated digests are stored in the Packagedigests tag of packages in the rpmdb, and the corresponding algorithms in the Packagedigestalgos tag.​ No package digests are calculated or stored if --noverify is used during package installation.​

%_pkgverify_flags VSFLAGS

Transaction package verification flags, used for fine-grained control of %_pkgverify_level operation.​ Set to 0x0 for full compatibility with v4 packages.​

%_pkgverify_level MODE

Enforced package verification mode in transactions, where MODE is one of:

• all: require valid digest(s) and signature(s)
• signature: require valid signature(s)
• digest: require valid digest(s)
• none: legacy rpm behavior, nothing required

%_prefer_color VALUE

Package conflict resolution in bi-arch transactions.​ See also %_transaction_color.​ Possible values are:

• 0: disabled
• 1: prefer 32-bit packages
• 2: prefer 64-bit packages

%__plugindir DIRECTORY

Transaction plugin directory.​

%_query_all_fmt FORMAT

Default output format for rpm(8) query operations, as described by rpm-queryformat(7).​ Percent signs need to be escaped, for example %%{nevra}.​

%_rpmlock_path FILE

The path of the file used for transaction fcntl lock.​

%_tmppath PATH

The directory where temporary files are created.​

%__urlhelpercmd EXECUTABLE

The executable to use for retrieving remote files.​

%__urlhelperopts OPTIONS

Generic options to pass to the %__urlhelpercmd command.​

%__urlhelper_localopts OPTIONS

User/host specific options to pass to the %__urlhelpercmd command.​

%__urlhelper_proxyopts OPTIONS

Proxy options to pass to the %__urlhelpercmd command.​

%_urlhelper COMMAND

Full command (with options) to use when retrieving remote files.​ Normally pieced together from the double-underscore %__urlhelper* macros.​

%_transaction_color VALUE

Package and file conflict behavior in bi-arch transactions.​ See also %_prefer_color.​ Possible values are:

• 0: do not consider "colors", only use arch compatibility map
• 1: only allow 32-bit packages
• 2: only allow 64-bit packages
• 3: allow 32- and 64-bit packages to share files

%_vsflags_erase VSFLAGS

Transaction verification flags used when erasing or updating packages.​

%_vsflags_install VSFLAGS

Transaction verification flags used when installing packages.​

%_vsflags_query VSFLAGS

Transaction verification flags used when querying packages.​

%_vsflags_rebuilddb VSFLAGS

Transaction verification flags used when rebuilding the database.​

%_vsflags_verify VSFLAGS

Transaction verification flags used when verifying packages.​

  >>> import rpm
  >>> hex(rpm​.RPMVSF_NOSHA1HEADER)
  ​'0x100​'
  >>> hex(rpm​.RPMVSF_NOSHA1HEADER|rpm​.RPMVSF_NOMD5)
  ​'0x20100​'
  >>>

If XDG_CONFIG_HOME environment variable is set, it replaces ~/.​config in the macro path.​

rpm(8), rpm-common(8), rpm-macrofile(5), rpm-rpmrc(5), rpm-macros(7)