NAME¶
dtrx - cleanly extract many archive types
SYNOPSIS¶
dtrx [OPTIONS] ARCHIVE [ARCHIVE ...]
DESCRIPTION¶
dtrx extracts archives in a number of different formats; it currently supports
tar, zip (including self-extracting .exe files), cpio, rpm, deb, gem, 7z, cab,
rar, and InstallShield files. It can also decompress files compressed with
gzip, bzip2, lzma, or compress.
In addition to providing one command to handle many different archive types,
dtrx also aids the user by extracting contents consistently. By default,
everything will be written to a dedicated directory that's named after the
archive. dtrx will also change the permissions to ensure that the owner can
read and write all those files.
To run dtrx, simply call it with the archive(s) you wish to extract as
arguments. For example:
$ dtrx coreutils-5.*.tar.gz
OPTIONS¶
dtrx supports a number of options to mandate specific behavior:
- -r, --recursive
- With this option, dtrx will search inside the archives you
specify to see if any of the contents are themselves archives, and extract
those as well.
- --one, --one-entry
- Normally, if an archive only contains one file or directory
with a name that doesn't match the archive's, dtrx will ask you how to
handle it. With this option, you can specify ahead of time what should
happen. Possible values are:
- inside
- Extract the file/directory inside another directory named
after the archive. This is the default.
- rename
- Extract the file/directory in the current directory, and
then rename it to match the name of the archive.
- here
- Extract the file/directory in the current directory.
- -o, --overwrite
- Normally, dtrx will avoid extracting into a directory that
already exists, and instead try to find an alternative name to use. If
this option is listed, dtrx will use the default directory name no matter
what.
- -f, --flat
- Extract all archive contents into the current directory,
instead of their own dedicated directory. This is handy if you have
multiple archive files which all need to be extracted into the same
directory structure. Note that existing files may be overwritten with this
option.
- -n, --noninteractive
- dtrx will normally ask the user how to handle certain
corner cases, such as how to handle an archive that only contains one
file. This option suppresses those questions; dtrx will instead use sane,
conservative defaults.
- -l, -t, --list, --table
- Don't extract the archives; just list their contents on
standard output.
- -m, --metadata
- Extract the metadata from .deb and .gem archives, instead
of their normal contents.
- -q, --quiet
- Suppress warning messages. Listing this option twice will
cause dtrx to be silent.
- -v, --verbose
- Show the files that are being extracted. Listing this
option twice will cause dtrx to print debugging information.
- --help
- Display basic help.
- --version
- Display dtrx's version, copyright, and license
information.
AUTHOR¶
Brett Smith <brettcsmith@brettcsmith.org>
COPYRIGHT¶
dtrx 6.5 is copyright © 2006-2009 Brett Smith and others. Feel free to send
comments, bug reports, patches, and so on. You can find the latest version of
dtrx on its home page at <
http://www.brettcsmith.org/2007/dtrx/>.
dtrx is free software; you can redistribute it and/or modify it under the terms
of the GNU General Public License as published by the Free Software
Foundation; either version 3 of the License, or (at your option) any later
version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program; if not, see <
http://www.gnu.org/licenses/>.