.\" Generated by scdoc 1.11.5
.\" 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\-08\-31" "RPM 6.1.0"
.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.\&
.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), CAR or Ruby GEM file.\& \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
See \fBrpm\-common\fR(8) for options common to all rpm executables.\&
.PP
.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
.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
\fBrpm\-common\fR(8), \fBrpmbuild\fR(1), \fBpopt\fR(3)
.PP
\fBhttp://www.\&rpm.\&org/\fR