| 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 |