Overview
This post covers:
- How to examine files in an RPM package you possess
- How to examine files of an RPM package installed on a system
- How to extract a cpio archive from an RPM package
- How to extract files from a cpio archive
- How to show preinstall and postinstall scripts of an RPM package
- How to examine files in an RPM package in a remote repository
Extract files from an RPM (quick start)
For the impatient, this is the command to extract files from an RPM package you possess:
$ rpm2cpio ./packagecloud-test-1.1-1.x86_64.rpm | cpio -idmv
Continue reading this post for more information about listing and extracting RPMs.
Related Post
Inspecting and extracting Debian package contents
What is an RPM package?
RPM stands for RedHat Package Manager and it is used in RedHat Linux and all its derivative Linuxes. RPM is also used to refer to the package format used to package software used by RedHatLinux and its derivates. An RPM package is simply a header structure on top of aCPIO
archive. The package itself is comprised of four sections: a header with a leading identifier (magic number) that identifies the file as an RPM package, a signature to verify the integrity of the package, the header or ‘tagged’ data containing package information, version numbers, and copyright messaging, and the archive containing the actual program files.
How to list files in an RPM package file using therpm
command
The RPM package managerrpm
comes with various utilities to interact with packages. The following command will list all the files inside an RPM package:
$ rpm -qlp ./path/to/test.rpm
For example:
$ rpm -qlpv ./packagecloud-test-1.1-1.x86_64.rpm-rwxr-xr-x 1 root root 8286 Jul 16 2014 /usr/local/bin/packagecloud_hello
In this example, therpm
command is used with the flag-q
to specify it as a query command,-l
to list the files in the package, and-p
so it knows to query the uninstalled package file. The-v
flag (verbose) just provides additional information (permissions, owner, etc.) for the sake of this example. As we can see, the package installs an executable binary calledpackagecloud_hello
into/usr/local/bin/
.
How to list files of an installed RPM package
Use therpm
command with-q
and-l
flags to list the files from an installed RPM package:
$ rpm -ql packagecloud-test
NOTEthe use of a package’s name in the previous command and not the path to a specific RPM package.
How to extractcpio
archive from RPM packages
To extract files from an RPM package you must first extract acpio
archive from the package itself. RedHat provides a utility calledrpm2cpio
which does exactly that:
$ rpm2cpio ./packagecloud-test-1.1-1.x86_64.rpm
How to extract files from an RPM package’scpio
archive
Therpm2cpio
command will output (to stdout) acpio
archive from the RPM package. To extract the package files we’ll use the output fromrpm2cpio
and then use thecpio
command to extract and create the files we need.
For example:
$ rpm2cpio ./packagecloud-test-1.1-1.x86_64.rpm | cpio -idmv./usr/local/bin/packagecloud_hello17 blocks
Thecpio
command copies files to and from archives. In the example above, we usecpio
with the-i
flag to extract the files from the archive,-d
to create the leading directories where needed, and-m
to preserve the file modification times when creating files. The-v
flag (verbose) is to list the files processed for the sake of this example.
The result of our previous example is the creation of a./usr/
folder in our working directory containing the files from the RPM packagepackagecloud-test-1.1-1.x86_64.rpm
.
$ file usr/local/bin/packagecloud_hellousr/local/bin/packagecloud_hello: ELF 64-bit LSB executable, x86-64, version 1 (SYSV), dynamically linked (uses shared libs), for GNU/Linux 2.6.24, BuildID[sha1]=0x77fe4f2fa02ee973bf4d74867729e950fcde7107, not stripped
NOTEthat simply extracting package files to the root directory doesNOTproperly install a package. Use theyum
orrpm
tools to correctly install RPM packages.
How to show RPM package preinstall and postinstall scripts
To show the scripts that will run when a package is installed or uninstalled from a system, use the--scripts
flag when querying a package usingrpm
. The following command will show the scripts for an uninstalled packagetest-1.1-1.el6.x86_64.rpm
:
$ rpm -qp --scripts ./packagecloud-test-1.1-1.x86_64.rpm
This will output something like:
preinstall scriptlet (using /bin/sh):# Do somethingpostinstall scriptlet (using /bin/sh):if [ $1 -eq 1 ] ; then # Do another thingfipreuninstall scriptlet (using /bin/sh):if [ $1 -eq 0 ] ; then # Do something elsefipostuninstall scriptlet (using /bin/sh):# Do things here, too
To view the scriptlets of an already installed package, you can use the following syntax when usingrpm
$ rpm -q --scripts <packagename>
How to view contents of RPM packages on remote repositories usingrepoquery
repoquery
is provided by theyum-utils
package, make sure it’s installed:
$ yum install yum-utils
Therepoquery
command is used to query information fromYum
repositories installed on the system. By default, therepoquery
command will download theYum
repo metadata and update the cache. To runrepoquery
entirely from theYum
cache, use the-C
or--cache
flag. To list the contents of a package, pass the--list
flag to therepoquery
command:
$ repoquery --list <packagename>
For example:
$ repoquery --list packagecloud-test/usr/local/bin/packagecloud_hello
This can be useful when viewing the contents of packages that aren’t downloaded or installed on your the system.repoquery
will only provide information on packages avaliable in the configuredYum
repositories.
Conclusion
Understanding how packages interact with the systems they’re installed on can be helpful in day-to-day operations. By knowing that the RPM package is comprised of acpio
archive and header data, we can extract the information needed with already existing tools (rpm2cpio
andcpio
) and use the RPM toolchain to query, inspect, and view the contents of an RPM package.
Set up your own package repository.
Fast, reliable, and secure software starts here.
Try Packagecloud