PATOOL(1)                                                                                                                                                             PATOOL(1)



NAME
       patool - simple manager for file archives of various types

SYNOPSIS
       patool <command> [options] <archive-file>

DESCRIPTION
       Various archive types can be created, extracted and listed by patool.  The archive format is determined by the archive file extension and as a fallback with file(1).

       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), LZOP
       (.lzo)and RAR (.rar) formats.  It relies on helper applications to handle those archive formats (for example bzip2 for BZIP2 archives).

COMMANDS
       Several commands and options are available.

   extract
       Extract files from an archive4. Often one wants to extract all files in an archive to a single subdirectory.  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.

       --force
              Allow overwriting of local files.

       --verbose
              Be verbose when extracting (if the helper application supports it).

       --help Show help for this command.

   list
       List files in an archive.

       --verbose
              Verbose archive listing (if the helper application supports it).

       --help Show help for this command.

   formats
       Show all supported archive formats.

       --help Show help for this command.

CONFIGURATION
       The configuration files (see FILES) can specify which program to use for each archive format. Per default a list of programs are searched and the first one will be used
       for an archive.
       Additionally, default options like verbosity and force overwrite can be configured.
       The configuration format is the Windows INI format.


   [DEFAULT]
       force=0
              Set the force option to 1 or 0.

       verbose=0
              Set the verbose option to 1 or 0.

   [<archive format>]
       Supported archive formats are listed by the formats command.

       mode=/usr/bin/mycommand
              Set the application to handle the archive format for given mode.  mode can be one of extract, list.

FILES
       /etc/patool.conf, ~/.patool.conf - configuration files

AUTHOR
       Bastian Kleineidam <calvin@users.sourceforge.net>

COPYRIGHT
       Copyright © 2010 Bastian Kleineidam



patool                                                                           February 2010                                                                        PATOOL(1)
