patool/doc/patool.txt

81 lines
2.5 KiB
Plaintext
Raw Normal View History

PATOOL(1) PATOOL(1)
2010-02-21 11:14:57 +00:00
NAME
patool - simple manager for file archives of various types
SYNOPSIS
2010-02-21 12:40:42 +00:00
patool (extract|list|test) [options] <archive-file>
patool create [options] <archive-file> [files..]
patool formats [options]
2010-02-21 11:14:57 +00:00
DESCRIPTION
Various archive types can be created, extracted, tested and listed by
patool. The advantage of patool is its simplicity in handling archive
files without having to remember a myriad of programs and options.
2010-02-21 11:14:57 +00:00
The archive format is determined by the file(1) program and as a fall
back by the archive file extension.
2010-02-22 17:28:07 +00:00
patool supports 7z (.7z), ZIP (.zip, .jar), GZIP (.gz), compress (.Z),
BZIP2 (.bz2), TAR (.tar), ARJ (.arj), CAB (.cab), CPIO (.cpio), RPM
(.rpm), DEB (.deb), LZIP (.lz), LZOP (.lzo), LZMA (.lzma), RAR (.rar)
and XZ (.xz) formats. It relies on helper applications to handle those
archive formats (for example bzip2 for BZIP2 archives).
2010-02-21 11:14:57 +00:00
COMMANDS
Several commands and options are available.
extract
Extract files from an archive. This is the default command if no com
mand was given.
Often one wants to extract all files in an archive to a single subdi
rectory. However, some archives contain multiple files in their root
directories. The patool program overcomes this problem by first
extracting files to a unique (temporary) directory, and then moving its
contents back if possible. This also prevents local files from being
overwritten by mistake.
2010-02-21 11:14:57 +00:00
2010-03-06 10:38:29 +00:00
-v, --verbose
Be verbose when extracting (if the helper application supports
it).
2010-02-21 11:14:57 +00:00
--help Show help for this command.
list
List files in an archive.
2010-03-06 10:38:29 +00:00
-v, --verbose
2010-02-21 11:14:57 +00:00
Verbose archive listing (if the helper application supports it).
--help Show help for this command.
2010-02-21 18:04:13 +00:00
create
Create an archive from given files.
--help Show help for this command.
2010-02-21 12:40:42 +00:00
test
Test files in an archive.
2010-03-06 10:38:29 +00:00
-v, --verbose
2010-02-21 12:40:42 +00:00
Verbose archive testing (if the helper application supports it).
--help Show help for this command.
2010-02-21 11:14:57 +00:00
formats
Show all supported archive formats.
--help Show help for this command.
AUTHOR
Bastian Kleineidam <calvin@users.sourceforge.net>
COPYRIGHT
Copyright © 2010 Bastian Kleineidam
patool February 2010 PATOOL(1)