Skip to content

Latest commit

 

History

History
85 lines (63 loc) · 2.46 KB

MANUAL.md

File metadata and controls

85 lines (63 loc) · 2.46 KB

xt(1) -- eXtractor Tool - Recursively decompress archives

SYNOPSIS

xt [options] [path [path] [path] ...]
xt --job-file /tmp/job1 -j /tmp/job2\

DESCRIPTION

  • This application recursively extracts compressed archives.
  • Provide directories to search or provide files to extract.
  • Supports ZIP, RAR, GZIP, BZIP2, TAR, TGZ, TBZ2, 7ZIP, ISO9660
  • ie. *.zip *.rar *.r00 *.gz *.bz2 *.tar *.tgz *.tbz2 *.7z *.iso

OPTIONS

xt [-o </dir>] [-d <#>] [-m <#>] [-e <.ext>] [-p <p4ss,words>] [paths]

-o directory, --output directory
Provide a file system directory where content is written. The default output directory is the current working directory.

-d count, --max-depth count
This option limits how deep into the file system xt recurses. The default is (0) unlimited. Setting to 1 disables recursion.

-m count, --min-depth count
This option determines if archives should only be found deeper into the file system. The default is (0) root. Archives are only extracted from count sub directories deep or deeper.

-P password, --password password
Provided passwords are attempted against extraction of encrypted rar and/or 7zip archives. The -p option may be provided many times.

-e .ext, --extension .ext
Only extract archives with these extensions. Include the leading dot. The -e option may be provided many times. Use -v for supported extensions. <- Your input must match the supported extensions. Unknown extensions are still ignored.

-j file, --job-file file
The options above create a single job. If you want more control, you may provide one or more job files. Each file may define the input, output, depths and passwords, etc. Acceptable formats are xml, json, toml and yaml. TOML is the default. See JOB FILES below.

-v, --version
Display version and exit.

-h, --help
Display usage and exit.

JOB FILES

If include_suffix is provided exclude_suffix is ignored.

Example TOML job file:

paths     = [ '/path1', '/another/path' ]
output    = '.'
passwords = [ 'password1', '''password"With'Specials!''', 'pass3']
exclude_suffix = ['.iso', '.gz']
include_suffix = ['.zip', '.rar', '.r00']
max_depth = 0
min_depth = 1
file_mode = 644
dir_mode  = 755

AUTHOR

  • David Newhall II - 1/20/2024

LOCATION