.\" Generated by scdoc 1.11.4
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "RPM-RPMRC" "5" "2026-03-06" "RPM 6.0.1"
.PP
.SH NAME
\fBrpm-rpmrc\fR - rpm platform compatibility configuration
.PP
.SH SYNOPSIS
\fIVARIABLE\fR: {\fIARCH\fR|\fIOS\fR}: \fIVALUE\fR .\&.\&.\&
.PP
\fIVARIABLE\fR: \fIARCH\fR \fIVALUE\fR
.PP
.SH FILES
\fI/usr/lib/rpm/rpmrc\fR
.br
\fI/usr/lib/rpm/<vendor>/rpmrc\fR
.br
\fI/etc/rpmrc\fR
.br
\fI\(ti/.\&config/rpm/rpmrc\fR
.PP
.SH DESCRIPTION
The low-level machine architecture and OS configuration in \fBrpm\fR is
managed via a set of rpmrc files as defined by the \fIrpmrc path\fR.\&
Most users never need to look at, much less touch these files.\&
.PP
Each file in the colon separated \fIrpmrc path\fR is read sequentially by
\fBrpm\fR for configuration information.\& Tildes will be expanded to the
value of the environment variable \fBHOME\fR.\&
The first file in the path must exist, others are considered optional.\&
.PP
If a value is defined multiple times, the last entry wins.\& The default
\fIrpmrc path\fR uses this to achieve the following hierarchy of platform
configuration:
.PD 0
.IP 1. 4
Generic \fBrpm\fR factory defaults
.IP 2. 4
Vendor (distribution) specific configuration
.IP 3. 4
Host specific configuration
.IP 4. 4
User specific configuration
.PD
.PP
In older rpm versions the path of per-user rpmrc was \fI\(ti/.\&rpmrc\fR.\&
This is still processed if it exists and the new configuration directory
does not exist.\&
.PP
.SH CONFIGURATION
\fIARCH\fR and \fIOS\fR relate to \fBuname\fR(2) machine and operating system
information, but are not 1:1 equivalent.\&
The following directives are supported in the rpmrc files:
.PP
\fBarch_canon\fR \fIARCH\fR: \fICANON_ARCH\fR \fIARCH_NUM\fR
.RS 4
Names and numbers of known architectures to
alias different spellings to a canonical one.\&
\fICANON_ARCH\fR is what the \fIARCH\fR entries in other rpmrc
directives refer to.\&
.PP
The number is not used for any calculations by \fBrpm\fR but
must be present for historical reasons.\&
.PP
.RE
\fBarch_compat\fR: \fIARCH\fR: \fICOMPAT_ARCH\fR .\&.\&.\&
.RS 4
Declare compatibility between machine architectures,
ie.\& \fIARCH\fR machines can install packages for \fICOMPAT_ARCH\fR
architecture.\&
.PP
.RE
\fBarchcolor\fR: \fIARCH\fR \fICOLOR\fR
.RS 4
Declare the "color" of \fIARCH\fR.\& The color relates to the word length
aka bitness of the architecture:
.PD 0
.IP \(bu 4
\fB0\fR means none (noarch packages and similar)
.IP \(bu 4
\fB1\fR means 32-bit
.IP \(bu 4
\fB2\fR means 64-bit
.PD
.PP
.RE
\fBbuildarch_compat\fR: \fIARCH\fR: \fICOMPAT_ARCH\fR .\&.\&.\&
.RS 4
Declare compatibility between build architectures targets,
ie.\& \fIARCH\fR machines can produce \fICOMPAT_ARCH\fR binaries.\&
.PP
.RE
\fBbuildarchtranslate\fR: \fIARCH\fR: \fITRANSLATE_ARCH\fR
.RS 4
Automatically translate detected host architecture \fIARCH\fR to
\fITRANSLATE_ARCH\fR when building packages.\& This is used to map
sub-architectures to a main one, for example when building on a
\fBx86_64_v2\fR host we typically want the generated package to be
of the main \fBx86_64\fR architecture.\&
.PP
.RE
\fBoptflags\fR: \fIARCH\fR \fIOPTFLAGS\fR
.RS 4
Compiler flags to use when building packages for \fIARCH\fR architecture.\&
The \fIOPTFLAGS\fR value is available as \fB%{optflags}\fR macro in
spec files.\&
.PP
.RE
\fBos_canon\fR: \fIOS\fR: \fICANON_OS\fR \fIOS_NUM\fR
.RS 4
Names and numbers of known operating systems to
alias different spellings to a canonical one.\&
\fICANON_OS\fR is what the \fIOS\fR entries in other rpmrc directives
refer to.\&
.PP
The number is not used for any calculations by \fBrpm\fR but
must be present for historical reasons.\&
.PP
.RE
\fBos_compat\fR: \fIOS\fR: \fICOMPAT_OS\fR .\&.\&.\&
.RS 4
Declare compatibility between operating systems, ie.\&
\fIOS\fR machine can install packages for \fICOMPAT_OS\fR operating
system.\&
.PP
.RE
.SH ENVIRONMENT
If \fBXDG_CONFIG_HOME\fR environment variable is set, it replaces \fI\(ti/.\&config\fR
in the \fIrpmrc path\fR.\&
.PP
.SH SEE ALSO
\fBrpm\fR(8), \fBrpm-common\fR(8), \fBrpm-config\fR(5), \fBrpm-macros\fR(7)