Debian Codegraph @

upstream/debian-unstable/man1/rpmsign.1

raw
1 .\" Generated by scdoc 1.11.4
2 .\" Complete documentation for this program is not available as a GNU info page
3 .ie \n(.g .ds Aq \(aq
4 .el .ds Aq '
5 .nh
6 .ad l
7 .\" Begin generated content:
8 .TH "RPMSIGN" "1" "2026-04-10" "RPM 6.0.1"
9 .PP
10 .SH NAME
11 rpmsign - RPM Package Signing
12 .PP
13 .SH SYNOPSIS
14 \fBrpmsign\fR {\fB--addsign\fR|\fB--resign\fR} [options] [sign-options] \fIPACKAGE_FILE\fR .\&.\&.\&
15 .PP
16 \fBrpmsign\fR \fB--delsign\fR [options] \fIPACKAGE_FILE\fR .\&.\&.\&
17 .PP
18 \fBrpmsign\fR \fB--delfilesign\fR [options] \fIPACKAGE_FILE\fR .\&.\&.\&
19 .PP
20 .SH DESCRIPTION
21 \fBrpmsign\fR is used to manipulate digital OpenPGP signatures on \fBrpm\fR package
22 files.\&
23 .PP
24 To create a signature rpmsign needs to verify the package'\&s checksum.\& As a
25 result V4 packages with MD5/SHA1 checksums cannot be signed in FIPS mode.\&
26 .PP
27 .SH OPERATIONS
28 \fB--addsign\fR
29 .RS 4
30 Generate and insert a new OpenPGP signature
31 for each \fIPACKAGE_FILE\fR given unless a signature with identical
32 parameters already exists, in which case no action is taken.\&
33 Arbitrary number of V6 signatures can be added.\&
34 .PP
35 .RE
36 \fB--resign\fR
37 .RS 4
38 Generates and inserts a new OpenPGP signature
39 for each \fIPACKAGE_FILE\fR, replacing any and all previous signatures.\&
40 .PP
41 .RE
42 \fB--delsign\fR
43 .RS 4
44 Delete all OpenPGP signatures from each package \fIPACKAGE_FILE\fR given.\&
45 .PP
46 .RE
47 \fB--delfilesign\fR
48 .RS 4
49 Delete all IMA and fsverity file signatures from each package
50 \fIPACKAGE_FILE\fR given.\&
51 .PP
52 .RE
53 .SH ARGUMENTS
54 \fIPACKAGE_FILE\fR
55 .RS 4
56 An \fBrpm\fR package file.\&
57 .PP
58 .RE
59 .SH OPTIONS
60 See \fBrpm-common\fR(8) for the options common to all \fBrpm\fR executables.\&
61 .PP
62 .SH SIGN OPTIONS
63 \fB--certpath\fR \fICERT\fR
64 .RS 4
65 Used with \fB--signverity\fR, use file signing certificate \fICERT\fR.\&
66 .PP
67 .RE
68 \fB--fskpath\fR \fIKEY\fR
69 .RS 4
70 Used with \fB--signfiles\fR, use file signing key \fIKEY\fR.\&
71 .PP
72 .RE
73 \fB--key-id\fR \fIKEYID\fR
74 .RS 4
75 Use key \fIKEYID\fR for signing.\& Overrides \fB%_openpgp_sign_id\fR
76 configuration.\&
77 .PP
78 .RE
79 \fB--rpmv3\fR
80 .RS 4
81 Request RPM V3 header+payload signature addition on V4 packages.\&
82 These signatures are expensive
83 and redundant baggage on packages where a separate payload digest
84 exists (packages built with rpm >= 4.\&14).\& Rpmsign will automatically
85 detect the need for V3 signatures, but this option can be used to
86 request their creation if the packages must be fully signature
87 verifiable with rpm < 4.\&14 or other interoperability reasons.\&
88 .PP
89 Has no effect when signing V6 packages.\&
90 .PP
91 .RE
92 \fB--rpmv4\fR
93 .RS 4
94 Request RPM V4 header signature addition on V6 packages.\&
95 Useful for making V6 packages signature verifiable
96 with rpm 4.\&x versions.\&
97 .PP
98 V4 compatibility signatures are only ever added if the signing
99 algorithm is one of those known to V4: RSA, EcDSA, EdDSA
100 (and original DSA).\&
101 Only one V4 signature can be present in a package, so this is
102 added only on the first \fB--addsign\fR with a V4 compatible
103 algorithm, and ignored otherwise.\&
104 .PP
105 Has no effect when signing V4 packages.\&
106 .PP
107 .RE
108 \fB--rpmv6\fR
109 .RS 4
110 Request RPM V6 header signature addition on V4 packages.\&
111 .PP
112 This generally always succeeds as there can be arbitrary number of
113 V6 signatures on a package.\& A V3/V4 compatibility signatures are
114 added using the same logic as \fB--rpmv4\fR on a V6 package.\&
115 .PP
116 Has no effect when signing V6 packages.\&
117 .PP
118 .RE
119 \fB--signfiles\fR
120 .RS 4
121 Sign package files.\& The file signing key (RSA private key) must
122 be set before signing the package, it can be configured on the
123 command line with \fB--fskpath\fR or the macro %_file_signing_key.\&
124 .PP
125 .RE
126 \fB--signverity\fR
127 .RS 4
128 Sign package files with fsverity signatures.\& The file signing key
129 (RSA private key) and the signing certificate must be set before
130 signing the package.\& The key can be configured on the command line
131 with \fB--fskpath\fR or the macro %_file_signing_key, and the cert
132 can be configured on the command line with \fB--certpath\fR or the
133 macro %_file_signing_cert.\&
134 .PP
135 .RE
136 \fB--verityalgo\fR \fIALG\fR
137 .RS 4
138 Used with \fB--signverity\fR, to specify the signing algorithm.\&
139 sha256 and sha512 are supported, with sha256 being the default if
140 this argument is not specified.\& This can also be specified with the
141 macro \fB%_verity_algorithm\fR.\&
142 .PP
143 .RE
144 .SH CONFIGURATION
145 In order to sign packages, you need to create your own OpenPGP key pair
146 (aka certificate) and configure \fBrpm\fR(8) to use it.\& The following macros are
147 available:
148 .PP
149 \fB%_openpgp_sign_id\fR
150 .RS 4
151 The fingerprint or keyid of the signing key to use.\& Typically
152 this is the only configuration needed.\& If omitted,
153 \fB--key-id\fR must be explicitly specified when signing.\&
154 .PP
155 .RE
156 \fB%_openpgp_sign\fR
157 .RS 4
158 The OpenPGP implementation to use for signing.\& Supported values are
159 "gpg" for GnuPG (default and traditional) and "sq" for Sequoia PGP.\&
160 .PP
161 .RE
162 Implementation specific macros:
163 .PP
164 \fB%_gpg_path\fR
165 .RS 4
166 The location of your GnuPG keyring if not the default \fB$GNUPGHOME\fR.\&
167 .PP
168 .RE
169 \fB%_gpg_name\fR
170 .RS 4
171 Legacy macro for configuring user id with GnuPG.\& Use the implementation
172 independent and non-ambiguous \fB%_openpgp_sign_id\fR instead.\&
173 .PP
174 .RE
175 \fB%_sq_path\fR
176 .RS 4
177 The location of your Sequoia configuration if not the default.\&
178 .PP
179 .RE
180 .SH EXAMPLES
181 .SS Example 1. Basic setup
182 Configure RPM to sign packages with Sequoia PGP and a specific key by adding the
183 following contents to the user'\&s \fBrpm-config\fR(5) file (typically
184 \fI\(ti/.\&config/rpm/macros\fR):
185 .PP
186 .nf
187 .RS 4
188 %_openpgp_sign sq
189 %_openpgp_sign_id 7B36C3EE0CCE86EDBC3EFF2685B274E29F798E08
190 .fi
191 .RE
192 .PP
193 .SS Example 2. Basic operations
194 \fBrpmsign --addsign hello-2.\&0-1.\&x64_rpm\fR
195 .RS 4
196 Add a signature to \fIhello-2.\&0-1.\&x64_rpm\fR package.\&
197 .PP
198 .RE
199 \fBrpmsign --resign --key-id 771b18d3d7baa28734333c424344591e1964c5fc hello-2.\&0-1.\&x64_rpm\fR
200 .RS 4
201 Replace all signatures in \fIhello-2.\&0-1.\&x64_rpm\fR package by
202 a signature using key \fB771b18d3d7baa28734333c424344591e1964c5fc\fR.\&
203 .PP
204 .RE
205 \fBrpmsign --delsign --delfilesign hello-2.\&0-1.\&x64_rpm\fR
206 .RS 4
207 Delete all signatures from \fIhello-2.\&0-1.\&x64_rpm\fR package.\&
208 .PP
209 .RE
210 .SH EXIT STATUS
211 On success, 0 is returned, a nonzero failure code otherwise.\&
212 .PP
213 .SH SEE ALSO
214 \fBpopt\fR(3), \fBrpm\fR(8), \fBrpm-common\fR(8), \fBrpmkeys\fR(8), \fBrpmbuild\fR(1)
215 .PP
216 \fBrpmsign --help\fR - as rpm supports customizing the options via popt
217 aliases it'\&s impossible to guarantee that what'\&s described in the
218 manual matches what'\&s available.\&
219 .PP
220 \fBhttp://www.\&rpm.\&org/\fR