Archiver Tool
=============

The archiver tool manipulates archive files.
Unlike the other tools, the archiver does not use configuration files, but simple command line options.

Usage
-----

 ::

    archiver [OPTION] <archive> <FILE>...

**Options**:

| ``--compress <bool>`` : compress new files added to the archive
| ``--mode <mode>`` : choose operational mode
| ``--verbose <bool>`` : be a bit more verbose
| ``--quiet <bool>`` : less output
| ``--select <file>`` : apply operation only to files (inside the archive) listed in <file>; only supported by modes combine and copy
| ``--overwrite <mode>`` : what to do when archive member already exists
| ``--type <T>`` : interpret cache as an object of type T (align, feat, ascii, bin-matrix, flow-cache) when --mode=show
| ``--allophone-file <a.txt>`` : use this allophone file to resolve symbols when calling with --mode show --type align

**Modes**:

| add          : add files or directories to archive
| combine      : combine other archives into new one
| copy         : copy files between archives directly (option 'compress' is ignored)
| extract      : extract single files with path
| extractAll   : extract all files to given directory
| list         : list archive(s) (default)
| remove       : remove single files from archive
| recover      : recover archive (if internal structure is broken)
| show         : serialize and print file content to stdout, if possible (requires --type)

**Overwrite-Modes**:

| no           : no overwriting
| yes          : overwrite files with the same name
| check        : check for data equality of archive members with the same name


Examples
--------

Combine archives ``features.1.cache`` and ``features.2.cache`` to a compressed file archive ``features.cache``::

    archiver \
      --mode=combine   \
      --compress=true  \
      features.cache   \
      features.1.cache \
      features.2.cache

Extract files "EPPS/20060704_0905_1205_OR_SAT/10603.5-10633.7" and "EPPS/20060704_0905_1205_OR_SAT/10560.3-10565.45" from archive ``eval07en.feature-cache``::

    archiver \
      --mode=extract \
      eval07en.feature-cache \
      EPPS/20060704_0905_1205_OR_SAT/10603.5-10633.7 \
      EPPS/20060704_0905_1205_OR_SAT/10560.3-10565.45

Create a subset of a cache given a file list.
Please note: If you use a list of segments with full names, remember to copy ``<segment-full-name>.attribs`` as well. ::

    archiver \
      --mode=copy    \
      --select=filelist.txt \
     subset.cache \
     full.cache