emu-push(1)

NAME
emu-push - record source snapshots

SYNOPSIS
emu push [<options>] [<sink> ...]

DESCRIPTION
Push a new snapshot of the source directory onto one or more sinks. If none are specified, push to all sinks.

The difference between the source and a sink's HEAD is transferred and linked against the existing content, combining to produce a full snapshot of the source directory. This enables emu sinks to be very compact, allowing multiple full snapshots to be stored in a space little larger than a single full snapshot.

Some of the features of snapshot creation are:

•   supports copying links, devices, owners, groups, and permissions

•   exclude and exclude-from options

•   does not require super-user privileges

Emu uses the rsync (1) file-copying tool for its delta-transfer algorithm, which reduces the amount of data sent by sending only the differences between the source files and the existing files in the sink. Rsync finds files that need to be transferred using a "quick check" algorithm that looks for files that have changed in size or in last-modified time.

OPTIONS
-d --dry-run Perform a trial run with no changes made.

-f --force
    Force push the snapshot, ignoring any concurrency locks on the source or sink.

-i --ignore-errors
    Ignore errors in the file transfer stage. Errors in the file transfer stage can be caused by insufficient permissions to transfer file attributes. Using this argument causes the push to continue despite any such errros.

--no-archive
    Do not preserve file attributes such as ownership and permission bits when creating the snapshot.

--no-owner
    Do not preserve file attributes such as ownership and permission bits when creating the snapshot.

-v --verbose
    Increase verbosity.

--version
    Show version information and quit.

-h --help
    Show this help and quit.

EMU
Part of the emu (1) suite

AUTHOR
Chris Cummins <chrisc.101@gmail.com>

SEE ALSO
emu (1) rsync (1)