Provided by: dtrx_6.6-1.2_all bug

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/>.