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, lzh, arj, and  InstallShield  files.   It
       can also decompress files compressed with gzip, bzip2, lzma, xz, lrzip, lzip, 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

       You  may  specify URLs as arguments as well.  If you do, dtrx will use wget -c to download the URL to the
       current directory and then extract what it downloads.  This may fail if you already have a  file  in  the
       current directory with the same name as the file you're trying to download.

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.  List this option twice to make dtrx silent.

       -v, --verbose
              Show the files that are being extracted.  List this option twice to print debugging information.

       --help Display basic help.

       --version
              Display dtrx's version, copyright, and license information.

LICENSE

       dtrx  7.1  is  copyright  ©  2006-2011  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/> >.

AUTHOR

       Brett Smith <brettcsmith@brettcsmith.org>

COPYRIGHT

       2006-2011 Brett Smith and others

                                                   2011-11-19                                            DTRX(1)