table of contents
other versions
- jessie 3.17-1.1
- jessie-backports 4.7.3-1~bpo8+1
- stretch 4.7.3-1
- testing 4.20.1-2
- stretch-backports 4.17-1~bpo9+1+b1
- unstable 4.20.2-1
BTRFS-RECEIVE(8) | Btrfs Manual | BTRFS-RECEIVE(8) |
NAME¶
btrfs-receive - receive subvolumes from send streamSYNOPSIS¶
btrfs receive [options] <path>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 <infile>
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 <N>
terminate as soon as N errors happened while processing
commands from the send stream, default value is 1, 0 means no limit
-m <mountpoint>
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)10/02/2016 | Btrfs v4.7.3 |