Debian Codegraph @

upstream/debian-unstable/man8/rpmkeys.8

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 "RPMKEYS" "8" "2026-04-10" "RPM 6.0.1"
9 .PP
10 .SH NAME
11 .PP
12 rpmkeys - RPM Keyring
13 .PP
14 .SH SYNOPSIS
15 .PP
16 \fBrpmkeys\fR {\fB-K\fR|\fB--checksig\fR} [options] \fIPACKAGE_FILE\fR .\&.\&.\&
17 .PP
18 \fBrpmkeys\fR {\fB-d\fR|\fB--delete\fR|\fB-e\fR|\fB--erase\fR} [options] \fIFINGERPRINT\fR .\&.\&.\&
19 .PP
20 \fBrpmkeys\fR {\fB-x\fR|\fB--export\fR} [options] [\fIFINGERPRINT\fR .\&.\&.\&]
21 .PP
22 \fBrpmkeys\fR {\fB-i\fR|\fB--import\fR} [options] \fIPUBKEY\fR .\&.\&.\&
23 .PP
24 \fBrpmkeys\fR {\fB-l\fR|\fB--list\fR} [options] [\fIFINGERPRINT\fR .\&.\&.\&]
25 .PP
26 \fBrpmkeys\fR \fB--rebuild\fR [options] [rebuild-options]
27 .PP
28 .SH DESCRIPTION
29 .PP
30 \fBrpmkeys\fR is used for manipulating the \fBrpm\fR keyring and verifying
31 package digital signatures with the contained keys.\&
32 .PP
33 For all available operations, see \fBOPERATIONS\fR.\&
34 .PP
35 .SH OPERATIONS
36 .PP
37 \fB-K\fR,
38 \fB--checksig\fR
39 .RS 4
40 Verify the digests and signatures contained in \fIPACKAGE_FILE\fR to
41 ensure the integrity and origin of the package.\&
42 .PP
43 .RE
44 \fB-d\fR,
45 \fB--delete\fR,
46 \fB-e\fR,
47 \fB--erase\fR
48 .RS 4
49 Erase the key(s) designated by \fIFINGERPRINT\fR.\&
50 The \fB--delete\fR and \fB-d\fR options are deprecated.\&
51 .PP
52 .RE
53 \fB-x\fR,
54 \fB--export\fR
55 .RS 4
56 Output the key(s) designated by \fIFINGERPRINT\fR using an ASCII-armor
57 encoding.\& If \fIFINGERPRINT\fR is not specified, output all keys.\&
58 .PP
59 .RE
60 \fB--import\fR
61 .RS 4
62 Import ASCII-armored public keys.\&
63 Digital signatures cannot be verified without the corresponding
64 public key (aka certificate).\&
65 .PP
66 .RE
67 \fB-l\fR,
68 \fB--list\fR
69 .RS 4
70 List currently imported public key(s) (aka certificates) by their
71 fingerprint and user ID.\& If no fingerprints are specified, list all
72 keys.\&
73 .PP
74 .RE
75 \fB--rebuild\fR
76 .RS 4
77 Recreate the public key storage.\& Update to the latest format and drop
78 unreadable keys.\&
79 .PP
80 .RE
81 .SH ARGUMENTS
82 .PP
83 \fIFINGERPRINT\fR
84 .RS 4
85 The handle used for all operations on the keys.\&
86 .RE
87 \fIPACKAGE_FILE\fR
88 .RS 4
89 An \fBrpm\fR package file or a manifest.\&
90 .RE
91 \fIPUBKEY\fR
92 .RS 4
93 An ASCII-armored OpenPGP public key (aka certificate).\&
94 .PP
95 .RE
96 .SH OPTIONS
97 .PP
98 See \fBrpm-common\fR(8) for the options common to all \fBrpm\fR executables.\&
99 .PP
100 .SH REBUILD OPTIONS
101 .PP
102 \fB--from\fR <\fBfs\fR|\fBopenpgp\fR|\fBrpmdb\fR>
103 .RS 4
104 Use the keys from the specified backend to rebuild the currently
105 configured keystore backend.\&
106 This can be used to convert from one key storage to another.\&
107 .PP
108 .RE
109 .SH OUTPUT
110 \fB--checksig\fR
111 .nf
112 .RS 4
113 <_PACKAGE_FILE_>: <element> <element> <OK|NOT OK>
114 .fi
115 .RE
116 .PP
117 .RS 4
118 With \fB--verbose\fR:
119 .RE
120 .nf
121 .RS 4
122 <_PACKAGE_FILE_>:
123 <element>: <OK|NOTFOUND|BAD>
124 \&.\&.\&.
125 .fi
126 .RE
127 .PP
128 \fB--list\fR
129 .nf
130 .RS 4
131 <fingerprint> <name> <userid> public key
132 .fi
133 .RE
134 .PP
135 .SH CONFIGURATION
136 .PP
137 There are several configurables affecting the behavior of this
138 verification, see \fBrpm-config\fR(5) for details:
139 .PD 0
140 .IP \(bu 4
141 \fB%_keyring\fR
142 .IP \(bu 4
143 \fB%_keyringpath\fR
144 .IP \(bu 4
145 \fB%_pkgverify_flags\fR
146 .IP \(bu 4
147 \fB%_pkgverify_level\fR
148 .PD
149 .PP
150 .SH EXIT STATUS
151 On success, 0 is returned, a nonzero failure code otherwise.\&
152 .PP
153 .SH EXAMPLES
154 .PP
155 \fBrpmkeys --export 771b18d3d7baa28734333c424344591e1964c5fc | sq inspect\fR
156 .RS 4
157 Export key 771b18d3d7baa28734333c424344591e1964c5fc for inspecting
158 with sequoia-sq.\&
159 .PP
160 .RE
161 \fBrpmkeys --erase 771b18d3d7baa28734333c424344591e1964c5fc\fR
162 .RS 4
163 Erase key 771b18d3d7baa28734333c424344591e1964c5fc from the keyring.\&
164 .PP
165 .RE
166 \fBrpmkeys -K hello-2.\&0-1.\&x86_64.\&rpm\fR
167 .RS 4
168 Verify hello-2.\&0-1.\&x86_64.\&rpm package file.\&
169 .PP
170 .RE
171 .SH SEE ALSO
172 \fBpopt\fR(3), \fBrpm\fR(8), \fBrpm-common\fR(8), \fBrpm-config\fR(5), \fBrpmsign\fR(1)
173 .PP
174 \fBrpmkeys --help\fR - as \fBrpm\fR(8) supports customizing the options via popt
175 aliases it'\&s impossible to guarantee that what'\&s described in the
176 manual matches what'\&s available.\&
177 .PP
178 \fBhttp://www.\&rpm.\&org/\fR