.\" Generated by scdoc 1.11.4
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "RPMUNCOMPRESS" "1" "2026-01-08" "RPM 6.0.1"
.PP
.SH NAME
\fBrpmuncompress\fR - RPM utility for compressed files and archives
.PP
.SH SYNOPSIS
\fBrpmuncompress\fR [options] \fIFILE\fR
.PP
\fBrpmuncompress\fR [options] [extract-options] {\fB-x\fR|\fB--extract\fR} \fIARCHIVE\fR
.PP
.SH DESCRIPTION
\fBrpmuncompress\fR is a utility for transparently outputting compressed
and uncompressed files, and extracting archives.\&
.PP
It'\&s normally invoked internally by \fBrpmbuild\fR(1) to handle \fB%setup\fR
and \fB%patch\fR related tasks in spec files, but can be useful manually
invoked as well.\&
The installation directory of \fBrpmuncompress\fR can be determined with
\fBrpm -E "%{_rpmconfigdir}"\fR.\&
.PP
.SH ARGUMENTS
\fIFILE\fR
.RS 4
A regular file, optionally compressed.\&
.PP
.RE
\fIARCHIVE\fR
.RS 4
A \fBtar\fR(1), \fBzip\fR(1) or Ruby GEM archive.\& \fBtar\fR archives may
be compressed.\&
.PP
.RE
.SH OPERATIONS
By default, \fBrpmuncompress\fR outputs \fIFILE\fR to standard output similar
to \fBcat\fR(1), but transparently decompressing many popular compression
formats, similar to \fBzcat\fR(1).\&
.PP
\fB-x\fR,
\fB--extract\fR
.RS 4
Extract the \fIARCHIVE\fR passed as argument into the current directory,
transparently uncompressing \fBtar\fR(1) archives if needed.\&
.PP
.RE
.SH OPTIONS
\fB-n\fR,
\fB--dry-run\fR
.RS 4
Output the shell command that would be executed without this option.\&
.PP
.RE
.SH EXTRACT OPTIONS
\fB-C\fR \fIPATH\fR,
\fB--path\fR=\fIPATH\fR
.RS 4
Extract into to \fIPATH\fR regardless of the archive'\&s internal layout.\&
.PP
.RE
\fB-v\fR,
\fB--verbose\fR
.RS 4
Provide verbose extraction output.\&
.PP
.RE
.SH EXIT STATUS
On success, 0 is returned, a nonzero failure code otherwise.\&
.PP
.SH EXAMPLES
\fBrpmuncompress /tmp/3911.\&patch.\&gz | patch -p1\fR
.RS 4
Uncompress and output \fI/tmp/3911.\&patch.\&gz\fR, similar to \fBzcat\fR(1),
and pipe to \fBpatch\fR(1).\&
.PP
.RE
\fBrpmuncompress -x myproject.\&zip\fR
.RS 4
Extract \fImyproject.\&zip\fR archive into the current directory.\&
.PP
.RE
\fBrpmuncompress -x -C myproject myproject-1.\&0.\&7rc1.\&tar.\&gz\fR
.RS 4
Uncompress and extract \fImyproject-1.\&0.\&7rc1.\&tar.\&gz\fR archive into
\fImyproject\fR directory, regardless of it'\&s internal structure.\&
.PP
.RE
.SH SEE ALSO
\fBrpmbuild\fR(1), \fBpopt\fR(3)
.PP
\fBhttp://www.\&rpm.\&org/\fR