Debian Codegraph @

upstream/debian-unstable/man7/rpm-payloadflags.7

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 "RPM-PAYLOADFLAGS" "7" "2026-04-10" "RPM 6.0.1"
9 .PP
10 .SH NAME
11 \fBrpm-payloadflags\fR - RPM payload flags
12 .PP
13 .SH SYNOPSIS
14 \fBw\fR[\fIFLAGS\fR].\&\fITYPE\fR
15 .PP
16 .SH DESCRIPTION
17 The payload flags determine how the payload of an RPM package is compressed
18 when the package is built.\& The flags are stored in the \fBPayloadcompressor\fR
19 and \fBPayloadflags\fR tags of the package header, which are used to determine
20 how to uncompress the payload contents during installation.\&
21 .PP
22 The peculiar syntax is directly inherited from librpm'\&s \fBFopen()\fR IO API,
23 where \fBw\fR means opening a file for writing.\&
24 .PP
25 The following compression types are supported, but availability may
26 vary depending on how RPM was compiled.\&
27 .PP
28 .TS
29 allbox;c lx
30 c lx
31 c lx
32 c lx
33 c lx
34 c lx
35 c lx.
36 T{
37 \fITYPE\fR
38 T} T{
39 Description
40 T}
41 T{
42 \fBufdio\fR
43 T} T{
44 uncompressed
45 T}
46 T{
47 \fBgzdio\fR
48 T} T{
49 gzip (aka zlib)
50 T}
51 T{
52 \fBbzdio\fR
53 T} T{
54 bzip2
55 T}
56 T{
57 \fBxzdio\fR
58 T} T{
59 xz
60 T}
61 T{
62 \fBlzdio\fR
63 T} T{
64 legacy lzma
65 T}
66 T{
67 \fBzstdio\fR
68 T} T{
69 zstd
70 T}
71 .TE
72 .sp 1
73 The compression \fIFLAGS\fR must be listed in the following order and can be any of:
74 .PP
75 .TS
76 allbox;c lx c
77 c lx c
78 c lx c
79 c lx c.
80 T{
81 \fIFLAGS\fR
82 T} T{
83 Description
84 T} T{
85 Types
86 T}
87 T{
88 <0-9>
89 T} T{
90 compression level
91 T} T{
92 all (\fBufdio\fR ignores)
93 T}
94 T{
95 T[0-N]
96 T} T{
97 number of threads (no number or 0 = autodetect)
98 T} T{
99 \fBxzdio\fR, \fBzstdio\fR
100 T}
101 T{
102 L<0-9>
103 T} T{
104 window size(see \fB--long\fR in \fBzstd\fR(1))
105 T} T{
106 \fBzstdio\fR
107 T}
108 .TE
109 .sp 1
110 If a flag is omitted, the compressor'\&s default value will be used.\&
111 .PP
112 A higher compression level generally means better compression ratio at the
113 cost of increased resource use and compression times.\&
114 .PP
115 \fBT\fR is equivalent to \fBT0\fR and causes the number of threads to be
116 automatically detected.\& Note that while using threads can speed up compression
117 considerably, it typically causes the compression ratio to go down, and
118 make the output less predictable.\&
119 .PP
120 .SH EXAMPLES
121 .TS
122 allbox;l lx
123 l lx
124 l lx
125 l lx
126 l lx
127 l lx
128 l lx
129 l lx
130 l lx
131 l lx.
132 T{
133 Mode
134 T} T{
135 Description
136 T}
137 T{
138 \fBw9.\&gzdio\fR
139 T} T{
140 gzip level 9, default for package payload
141 T}
142 T{
143 \fBw9.\&bzdio\fR
144 T} T{
145 bzip2 level 9, bzip2'\&s default
146 T}
147 T{
148 \fBw.\&xzdio\fR
149 T} T{
150 xz default level
151 T}
152 T{
153 \fBw7T16.\&xzdio\fR
154 T} T{
155 xz level 7 using 16 threads
156 T}
157 T{
158 \fBw7T0.\&xzdio\fR
159 T} T{
160 xz level 7, autodetect no.\& of threads
161 T}
162 T{
163 \fBw6.\&lzdio\fR
164 T} T{
165 lzma (legacy) level 6, lzma'\&s default
166 T}
167 T{
168 \fBw19T8.\&zstdio\fR
169 T} T{
170 zstd level 19 using 8 threads
171 T}
172 T{
173 \fBw7T.\&zstdio\fR
174 T} T{
175 zstd level 7, autodetect no.\& of threads
176 T}
177 T{
178 \fBw.\&ufdio\fR
179 T} T{
180 uncompressed
181 T}
182 .TE
183 .sp 1
184 .SH SEE ALSO
185 \fBrpmbuild-config\fR(5), \fBrpm-config\fR(5)
186 .PP
187 \fBhttp://www.\&rpm.\&org/\fR