|author||David Sterba <email@example.com>||2016-05-06 13:12:42 +0200|
|committer||David Sterba <firstname.lastname@example.org>||2016-05-11 16:37:12 +0200|
btrfs-progs: docs: update btrfs-receive
Signed-off-by: David Sterba <email@example.com>
1 files changed, 29 insertions, 23 deletions
diff --git a/Documentation/btrfs-receive.asciidoc b/Documentation/btrfs-receive.asciidoc
index 758eebe3..fbbded21 100644
@@ -3,7 +3,7 @@ btrfs-receive(8)
-btrfs-receive - receive subvolumes from stdin/file.
+btrfs-receive - receive subvolumes from send stream
@@ -11,43 +11,49 @@ SYNOPSIS
-Receives one or more subvolumes that were previously
-sent with *btrfs send*. The received subvolumes are stored
-*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
-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
-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.
-Enable verbose debug output. Each occurrence of this option increases the
-verbose level more.
+enable verbose debug output, print each operation (each occurrence of this
+option increases the verbosity level)
-By default, btrfs receive uses stdin to receive the subvolumes.
-Use this option to specify a file to use instead.
+by default, btrfs receive uses standard input to receive the stream,
+use this option to read from a file instead
-Confine the process to <mount> using chroot.
+confine the process to 'mount' using `chroot`(1)
-Terminate after receiving an <end cmd> in the data stream.
-Without this option, the receiver terminates only if an error is recognized
-or on EOF.
+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
-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.
+terminate as soon as N errors happened while processing commands from the send
+stream, default value is 1, 0 means no limit
-The root mount point of the destination fs.
+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
+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.