Debian Codegraph @

upstream/debian-unstable/man1/rpmuncompress.1

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 "RPMUNCOMPRESS" "1" "2026-04-10" "RPM 6.0.1"
9 .PP
10 .SH NAME
11 \fBrpmuncompress\fR - RPM utility for compressed files and archives
12 .PP
13 .SH SYNOPSIS
14 \fBrpmuncompress\fR [options] \fIFILE\fR
15 .PP
16 \fBrpmuncompress\fR [options] [extract-options] {\fB-x\fR|\fB--extract\fR} \fIARCHIVE\fR
17 .PP
18 .SH DESCRIPTION
19 \fBrpmuncompress\fR is a utility for transparently outputting compressed
20 and uncompressed files, and extracting archives.\&
21 .PP
22 It'\&s normally invoked internally by \fBrpmbuild\fR(1) to handle \fB%setup\fR
23 and \fB%patch\fR related tasks in spec files, but can be useful manually
24 invoked as well.\&
25 The installation directory of \fBrpmuncompress\fR can be determined with
26 \fBrpm -E "%{_rpmconfigdir}"\fR.\&
27 .PP
28 .SH ARGUMENTS
29 \fIFILE\fR
30 .RS 4
31 A regular file, optionally compressed.\&
32 .PP
33 .RE
34 \fIARCHIVE\fR
35 .RS 4
36 A \fBtar\fR(1), \fBzip\fR(1) or Ruby GEM archive.\& \fBtar\fR archives may
37 be compressed.\&
38 .PP
39 .RE
40 .SH OPERATIONS
41 By default, \fBrpmuncompress\fR outputs \fIFILE\fR to standard output similar
42 to \fBcat\fR(1), but transparently decompressing many popular compression
43 formats, similar to \fBzcat\fR(1).\&
44 .PP
45 \fB-x\fR,
46 \fB--extract\fR
47 .RS 4
48 Extract the \fIARCHIVE\fR passed as argument into the current directory,
49 transparently uncompressing \fBtar\fR(1) archives if needed.\&
50 .PP
51 .RE
52 .SH OPTIONS
53 \fB-n\fR,
54 \fB--dry-run\fR
55 .RS 4
56 Output the shell command that would be executed without this option.\&
57 .PP
58 .RE
59 .SH EXTRACT OPTIONS
60 \fB-C\fR \fIPATH\fR,
61 \fB--path\fR=\fIPATH\fR
62 .RS 4
63 Extract into to \fIPATH\fR regardless of the archive'\&s internal layout.\&
64 .PP
65 .RE
66 \fB-v\fR,
67 \fB--verbose\fR
68 .RS 4
69 Provide verbose extraction output.\&
70 .PP
71 .RE
72 .SH EXIT STATUS
73 On success, 0 is returned, a nonzero failure code otherwise.\&
74 .PP
75 .SH EXAMPLES
76 \fBrpmuncompress /tmp/3911.\&patch.\&gz | patch -p1\fR
77 .RS 4
78 Uncompress and output \fI/tmp/3911.\&patch.\&gz\fR, similar to \fBzcat\fR(1),
79 and pipe to \fBpatch\fR(1).\&
80 .PP
81 .RE
82 \fBrpmuncompress -x myproject.\&zip\fR
83 .RS 4
84 Extract \fImyproject.\&zip\fR archive into the current directory.\&
85 .PP
86 .RE
87 \fBrpmuncompress -x -C myproject myproject-1.\&0.\&7rc1.\&tar.\&gz\fR
88 .RS 4
89 Uncompress and extract \fImyproject-1.\&0.\&7rc1.\&tar.\&gz\fR archive into
90 \fImyproject\fR directory, regardless of it'\&s internal structure.\&
91 .PP
92 .RE
93 .SH SEE ALSO
94 \fBrpmbuild\fR(1), \fBpopt\fR(3)
95 .PP
96 \fBhttp://www.\&rpm.\&org/\fR