.TH "DTRX" "" "Version 6.4" "" "" .SH "NAME" dtrx - Intelligent archive extraction .SH "SYNOPSIS" .B dtrx [ " -ltmrnofvq " ] .I archive [ archive ] ... .SH "DESCRIPTION" dtrx stands for Do The Right Extraction. It's a tool for Unix-like systems that takes all the hassle out of extracting archives. Here's an example of how you use it: .P .RS .B dtrx linux-2.6.10.tar.bz2 .RE .P That's basically the same thing as: .P .RS .B tar -jxf linux-2.6.10.tar.bz2 .RE .P But there's more to it than that. You know those really annoying files that don't put everything in a dedicated directory, and have the permissions all wrong? .P .PD 0.4 .RS .B tar -zvxf random-tarball.tar.gz .P .B foo .P .B bar .P .B data/ .P .B data/text .P .B cd data/ .P .B cd: permission denied: data .P .RE .PD .P dtrx takes care of all those problems for you, too: .P .PD 0.4 .RS .B dtrx random-tarball.tar.gz .P .B cd random-tarball/data .P .B cat text .RE .PD .P This all works properly. .P dtrx is simple and powerful. Just use the same command for all your archive files, and they'll never frustrate you again. .SH "OPTIONS" .TP .B -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. .TP .B --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: .IP .I inside: Extract the file/directory inside another directory named after the archive. This is the default. .IP .I rename: Extract the file/directory in the current directory, and then rename it to match the name of the archive. .IP .I here: Extract the file/directory in the current directory. .TP .B -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. .TP .B -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. .TP .B -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. .TP .B -l, -t, --list, --table Don't extract the archives; just list their contents on standard output. .TP .B -m, --metadata Extract the metadata from .deb and .gem archives, instead of their normal contents. .TP .B -q, --quiet Suppress warning messages. Listing this option twice will cause dtrx to be silent. .TP .B -v, --verbose Show the files that are being extracted. Listing this option twice will cause dtrx to print debugging information. .TP .B --help Display basic help. .TP .B --version Display dtrx's version, copyright, and license information. .SH "COPYRIGHT" Copyright 2006, 2007, 2008 Brett Smith .P Copyright 2008 Peter Kelemen .P This program 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. .P 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.s