|
HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | AUTHORS | COLOPHON |
|
|
|
RPMSIGN(8) RPMSIGN(8)
rpmsign - RPM Package Signing
SIGNING PACKAGES:
rpmsign --addsign|--resign [rpmsign-options] PACKAGE_FILE ...
rpmsign --delsign PACKAGE_FILE ...
rpmsign --delfilesign PACKAGE_FILE ...
rpmsign-options
[--rpmv3] [--fskpath KEY] [--signfiles]
Both of the --addsign and --resign options generate and insert
new signatures for each package PACKAGE_FILE given, replacing any
existing signatures. There are two options for historical rea‐
sons, there is no difference in behavior currently.
To create a signature rpmsign needs to verify the package's
checksum. As a result packages with a MD5/SHA1 checksums cannot
be signed in FIPS mode.
rpmsign --delsign PACKAGE_FILE ...
Delete all signatures from each package PACKAGE_FILE given.
rpmsign --delfilesign PACKAGE_FILE ...
Delete all IMA and fsverity file signatures from each package
PACKAGE_FILE given.
SIGN OPTIONS
--rpmv3
Force RPM V3 header+payload signature addition. These are
expensive and redundant baggage on packages where a sepa‐
rate payload digest exists (packages built with rpm >=
4.14). Rpmsign will automatically detect the need for V3
signatures, but this option can be used to force their
creation if the packages must be fully signature verifi‐
able with rpm < 4.14 or other interoperability reasons.
--fskpath KEY
Used with --signfiles, use file signing key Key.
--certpath CERT
Used with --signverity, use file signing certificate Cert.
--verityalgo ALG
Used with --signverity, to specify the signing algorithm.
sha256 and sha512 are supported, with sha256 being the de‐
fault if this argument is not specified. This can also be
specified with the macro %_verity_algorithm
--signfiles
Sign package files. The macro %_binary_filedigest_algo‐
rithm must be set to a supported algorithm before building
the package. The supported algorithms are SHA1, SHA256,
SHA384, and SHA512, which are represented as 2, 8, 9, and
10 respectively. The file signing key (RSA private key)
must be set before signing the package, it can be config‐
ured on the command line with --fskpath or the macro
%_file_signing_key.
--signverity
Sign package files with fsverity signatures. The file
signing key (RSA private key) and the signing certificate
must be set before signing the package. The key can be
configured on the command line with --fskpath or the macro
%_file_signing_key, and the cert can be configured on the
command line with --certpath or the macro %_file_sign‐
ing_cert.
CONFIGURING SIGNING KEYS
In order to sign packages, you need to create your own public and
secret key pair (see the GnuPG manual). In addition, rpm must be
configured to find GnuPG and the appropriate keys with the fol‐
lowing macros:
%_gpg_name
The name of the "user" whose key you wish to use to sign
your packages. Typically this is the only configuration
needed.
%_gpg_path
The location of your GnuPG keyring if not the default
$GNUPGHOME.
%__gpg The path of the GnuPG executable. Normally pre-config‐
ured.
For example, to be able to use GnuPG to sign packages as the user
"John Doe <jdoe@foo.com>" from the key rings located in
/etc/rpm/.gpg using the executable /opt/bin/gpg you would include
%_gpg_path /etc/rpm/.gpg
%_gpg_name John Doe <jdoe@foo.com>
%__gpg /opt/bin/gpg
in a macro configuration file, typically ~/.config/rpm/macros.
See Macro Configuration in rpm(8) for more details.
popt(3), rpm(8), rpmdb(8), rpmkeys(8), rpm2cpio(8), rpmbuild(8),
rpmspec(8)
rpmsign --help - as rpm supports customizing the options via popt
aliases it's impossible to guarantee that what's described in the
manual matches what's available.
http://www.rpm.org/ <URL:http://www.rpm.org/>
Marc Ewing <marc@redhat.com>
Jeff Johnson <jbj@redhat.com>
Erik Troan <ewt@redhat.com>
Panu Matilainen <pmatilai@redhat.com>
Fionnuala Gunter <fin@linux.vnet.ibm.com>
Jes Sorensen <jsorensen@fb.com>
This page is part of the rpm (RPM Package Manager) project. In‐
formation about the project can be found at
⟨https://github.com/rpm-software-management/rpm⟩. It is not known
how to report bugs for this man page; if you know, please send a
mail to man-pages@man7.org. This page was obtained from the
project's upstream Git repository
⟨https://github.com/rpm-software-management/rpm.git⟩ on
2024-06-14. (At that time, the date of the most recent commit
that was found in the repository was 2024-06-14.) If you
discover any rendering problems in this HTML version of the page,
or you believe there is a better or more up-to-date source for
the page, or you have corrections or improvements to the
information in this COLOPHON (which is not part of the original
manual page), send a mail to man-pages@man7.org
Red Hat, Inc RPMSIGN(8)
Pages that refer to this page: rpm(8), rpmbuild(8), rpmdb(8), rpmkeys(8), rpm-plugin-ima(8), rpmspec(8)
|
HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|