| 1 | ==== |
| 2 | dtrx |
| 3 | ==== |
| 4 | |
| 5 | ---------------------------------- |
| 6 | cleanly extract many archive types |
| 7 | ---------------------------------- |
| 8 | |
| 9 | :Author: Brett Smith <brettcsmith@brettcsmith.org> |
| 10 | :Date: 2009-07-04 |
| 11 | :Copyright: |
| 12 | |
| 13 | dtrx 6.6 is copyright © 2006-2009 Brett Smith and others. Feel free to |
| 14 | send comments, bug reports, patches, and so on. You can find the latest |
| 15 | version of dtrx on its home page at |
| 16 | <http://www.brettcsmith.org/2007/dtrx/>. |
| 17 | |
| 18 | dtrx is free software; you can redistribute it and/or modify it under the |
| 19 | terms of the GNU General Public License as published by the Free Software |
| 20 | Foundation; either version 3 of the License, or (at your option) any |
| 21 | later version. |
| 22 | |
| 23 | This program is distributed in the hope that it will be useful, but |
| 24 | WITHOUT ANY WARRANTY; without even the implied warranty of |
| 25 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General |
| 26 | Public License for more details. |
| 27 | |
| 28 | You should have received a copy of the GNU General Public License along |
| 29 | with this program; if not, see <http://www.gnu.org/licenses/>. |
| 30 | |
| 31 | :Version: 6.6 |
| 32 | :Manual section: 1 |
| 33 | |
| 34 | SYNOPSIS |
| 35 | ======== |
| 36 | |
| 37 | dtrx [OPTIONS] ARCHIVE [ARCHIVE ...] |
| 38 | |
| 39 | DESCRIPTION |
| 40 | =========== |
| 41 | |
| 42 | dtrx extracts archives in a number of different formats; it currently |
| 43 | supports tar, zip (including self-extracting .exe files), cpio, rpm, deb, |
| 44 | gem, 7z, cab, rar, and InstallShield files. It can also decompress files |
| 45 | compressed with gzip, bzip2, lzma, or compress. |
| 46 | |
| 47 | In addition to providing one command to handle many different archive |
| 48 | types, dtrx also aids the user by extracting contents consistently. By |
| 49 | default, everything will be written to a dedicated directory that's named |
| 50 | after the archive. dtrx will also change the permissions to ensure that the |
| 51 | owner can read and write all those files. |
| 52 | |
| 53 | To run dtrx, simply call it with the archive(s) you wish to extract as |
| 54 | arguments. For example:: |
| 55 | |
| 56 | $ dtrx coreutils-5.*.tar.gz |
| 57 | |
| 58 | OPTIONS |
| 59 | ======= |
| 60 | |
| 61 | dtrx supports a number of options to mandate specific behavior: |
| 62 | |
| 63 | -r, --recursive |
| 64 | With this option, dtrx will search inside the archives you specify to see |
| 65 | if any of the contents are themselves archives, and extract those as |
| 66 | well. |
| 67 | |
| 68 | --one, --one-entry |
| 69 | Normally, if an archive only contains one file or directory with a name |
| 70 | that doesn't match the archive's, dtrx will ask you how to handle it. |
| 71 | With this option, you can specify ahead of time what should happen. |
| 72 | Possible values are: |
| 73 | |
| 74 | inside |
| 75 | Extract the file/directory inside another directory named after the |
| 76 | archive. This is the default. |
| 77 | |
| 78 | rename |
| 79 | Extract the file/directory in the current directory, and then rename |
| 80 | it to match the name of the archive. |
| 81 | |
| 82 | here |
| 83 | Extract the file/directory in the current directory. |
| 84 | |
| 85 | -o, --overwrite |
| 86 | Normally, dtrx will avoid extracting into a directory that already exists, |
| 87 | and instead try to find an alternative name to use. If this option is |
| 88 | listed, dtrx will use the default directory name no matter what. |
| 89 | |
| 90 | -f, --flat |
| 91 | Extract all archive contents into the current directory, instead of |
| 92 | their own dedicated directory. This is handy if you have multiple |
| 93 | archive files which all need to be extracted into the same directory |
| 94 | structure. Note that existing files may be overwritten with this |
| 95 | option. |
| 96 | |
| 97 | -n, --noninteractive |
| 98 | dtrx will normally ask the user how to handle certain corner cases, such |
| 99 | as how to handle an archive that only contains one file. This option |
| 100 | suppresses those questions; dtrx will instead use sane, conservative |
| 101 | defaults. |
| 102 | |
| 103 | -l, -t, --list, --table |
| 104 | Don't extract the archives; just list their contents on standard output. |
| 105 | |
| 106 | -m, --metadata |
| 107 | Extract the metadata from .deb and .gem archives, instead of their normal |
| 108 | contents. |
| 109 | |
| 110 | -q, --quiet |
| 111 | Suppress warning messages. Listing this option twice will cause dtrx to |
| 112 | be silent. |
| 113 | |
| 114 | -v, --verbose |
| 115 | Show the files that are being extracted. Listing this option twice will |
| 116 | cause dtrx to print debugging information. |
| 117 | |
| 118 | --help |
| 119 | Display basic help. |
| 120 | |
| 121 | --version |
| 122 | Display dtrx's version, copyright, and license information. |