btrfs-receive(8) ================ NAME ---- btrfs-receive - receive subvolumes from send stream SYNOPSIS -------- *btrfs receive* [options] DESCRIPTION ----------- Receive a stream of changes and replicate one or more subvolumes that were previously used with *btrfs send* The received subvolumes are stored to 'path'. *btrfs receive* will fail int the following cases: 1. receiving subvolume already exists 2. previously received subvolume was changed after it was received 3. default subvolume has changed or you didn't mount BTRFS filesystem at the toplevel subvolume A subvolume is made read-only after the receiving process finishes succesfully. `Options` -v:: enable verbose debug output, print each operation (each occurrence of this option increases the verbosity level) -f :: by default, btrfs receive uses standard input to receive the stream, use this option to read from a file instead -C|--chroot:: confine the process to 'path' using `chroot`(1) -e:: terminate after receiving an 'end cmd' marker in the stream. + Without this option, the receiver terminates only if an error is encountered or at end of file --max-errors :: terminate as soon as N errors happened while processing commands from the send stream, default value is 1, 0 means no limit -m :: the root mount point of the destination filesystem + By default the mountpoint is searched in '/proc/self/mounts'. If you do not have '/proc', eg. in a chroot environment, use this option to tell us where this filesystem is mounted. EXIT STATUS ----------- *btrfs receive* returns a zero exit status if it succeeds. Non zero is returned in case of failure. AVAILABILITY ------------ *btrfs* is part of btrfs-progs. Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for further details. SEE ALSO -------- `mkfs.btrfs`(8), `btrfs-send`(8)