RepoMirrors/btrfs-progs
1
0
Fork 0
mirror of https://github.com/kdave/btrfs-progs synced 2025-04-01 22:48:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

btrfs-progs: docs: update btrfs-receive

Browse Source 
Signed-off-by: David Sterba <dsterba@suse.com>
This commit is contained in:
David Sterba 2016-05-06 13:12:42 +02:00
parent eb3092c2a1
commit ae213f7633
1 changed files with 31 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

56
Documentation/btrfs-receive.asciidoc
View File

@ -3,7 +3,7 @@ btrfs-receive(8)
NAME NAME
---- ----
btrfs-receive - receive subvolumes from stdin/file. btrfs-receive - receive subvolumes from send stream
SYNOPSIS SYNOPSIS
-------- --------
@ -11,43 +11,49 @@ SYNOPSIS
DESCRIPTION DESCRIPTION
----------- -----------
Receives one or more subvolumes that were previously
sent with *btrfs send*. The received subvolumes are stored
into <mount>.
*btrfs receive* will fail with the following case: Receive a stream of changes and replicate one or more subvolumes that were
previously used with *btrfs send* The received subvolumes are stored to
'mount'.
1. a receiving subvolume already exists. *btrfs receive* will fail int the following cases:
2. a previously received subvolume was changed after it was received. 1. receiving subvolume already exists
3. default subvolume is changed or you don't mount btrfs filesystem with 2. previously received subvolume was changed after it was received
fs tree.
After receiving a subvolume, it is immediately set to read only. 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` `Options`
-v:: -v::
Enable verbose debug output. Each occurrence of this option increases the enable verbose debug output, print each operation (each occurrence of this
verbose level more. option increases the verbosity level)
-f <infile>:: -f <infile>::
By default, btrfs receive uses stdin to receive the subvolumes. by default, btrfs receive uses standard input to receive the stream,
Use this option to specify a file to use instead. use this option to read from a file instead
-C|--chroot:: -C|--chroot::
Confine the process to <mount> using chroot. confine the process to 'mount' using `chroot`(1)
-e:: -e::
Terminate after receiving an <end cmd> in the data stream. terminate after receiving an 'end cmd' marker in the stream.
Without this option, the receiver terminates only if an error is recognized
or on EOF.
--max-errors <N>::
Terminate as soon as N errors happened while processing commands from the send
stream. Default value is 1. A value of 0 means no limit.
-m <mountpoint>::
The root mount point of the destination fs.
+ +
By default the mountpoint is searched in /proc/self/mounts. Without this option, the receiver terminates only if an error is encountered
If you do not have /proc, eg. in a chroot environment, use this option to tell 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. us where this filesystem is mounted.
EXIT STATUS EXIT STATUS