Content-type: text/html Manpage of barch

barch

Section: User Commands (1)
Index Return to Main Contents

NAME

barch - backup archive utility

SYNOPSIS

barch <operation> [options]

DESCRIPTION

barch is an archive utility specifically designed with the needs of the backup and restore process in mind.

OPTIONS

Most of the following options were adopted from tar in order to ease migration from one tool to the other.

Operation Modes

-c, --create: Create a new archive.
-t, --list: List the contents of an archive.
-x, --extract: Extract files from an archive.

Operation Modifiers

-g, --incremental: When creating an archive, record all of the files encountered in each matching directory in the archive file, for use when extracting the archive. When extracting files from an archive, the list of files in each matching directory is compared against the files in the corresponding destination directory. All files present in the destination that are not listed in the archive are removed.
--overwrite-files: When extracting an archive, overwrite files directly instead of using temporary files.
-j, --bzip2: Filter (compress or uncompress) the archive using bzip2.
-z, --gzip: Filter (compress or uncompress) the archive using gzip.
-Z, --compress: Filter (compress or uncompress) the archive using compress.

Archive I/O Options

-f FILE, --file=FILE: Archive filename (defaults to standard input when reading archives, or standard output when writing archives).

Local File Selection

-C PATH, --directory=PATH: Change to named directory after opening archive and before reading or writing files.
--exclude=PATTERN: File names to exclude files, given as a glob pattern.
-X FILE, --exclude-from=FILE: Exclude patterns listed in the named file.
--include=PATTERN: Include files, given as a glob pattern
-I FILE, --include-from=FILE: Include patterns listed in the named file
--patterns-from=FILE: Ex/include patterns listed in the named file. Each line in the file contains one pattern, prefixed by either + for files to include, or - for files to exclude. Lines starting with # are ignored. The patterns are applied in order, and the first matching pattern determines the outcome.
-P, --absolute-names: Don't strip leading '/'s from file names
-h, --dereference: Dump instead the files symlinks point to
-N FILE, --newer=FILE, --after-date=FILE: Only store files newer than the given file
--one-file-system: When creating an archive, do not recurse into directories that are located on different filesystems from their parents. The directory itself is still recorded in the archive, for compatibility with tar. Note that directories specifically listed on the command line are always archived.
--snapshot=FILE: Snapshot CDB for creating incremental archives. This feature is not yet useful, since the resulting CDB is only written and not used by any part of this program.

Informative Output

-v, --verbose: Show more information about progress. This option may be used multiple times.
--checkpoint: Print directory names as they are processed.
--totals: Output the total number of bytes written after the archive is created.

WARNINGS

The default behavior of barch is to create temporary files and then rename them on top of the destination file. This default behavior is required to overwrite files that are in use (ie mmaped), but it destroys any hard links to files being written. Use --overwrite-files if this is a problem.

WARNINGS

This document was created by man2html, using the manual pages.
Time: 05:19:04 GMT, August 02, 2005