← Back to branch summary

~ubuntu-branches/debian/jessie/btrfs-tools/jessie

« back to all changes in this revision

Viewing changes to Documentation/btrfs-receive.txt

  • Committer: Package Import Robot
  • Author(s): Dimitri John Ledkov
  • Date: 2014-09-21 02:05:14 UTC
  • mfrom: (1.2.13) (6.1.38 sid)
  • Revision ID: package-import@ubuntu.com-20140921020514-kx4b23aw4grvevrc
Tags: 3.16-1
* New upstream release.
* Add asciidoc & xmlto build dependencies.
* Disable test-suites for now, should be run as autopkgtests.

Show diffs side-by-side

added added

removed removed

Lines of Context:
Documentation/btrfs-receive.txt
 
1
btrfs-receive(8)
 
2
================
 
3
 
 
4
NAME
 
5
----
 
6
btrfs-receive - receive subvolumes from stdin/file.
 
7
 
 
8
SYNOPSIS
 
9
--------
 
10
*btrfs receive* [-ve] [-f <infile>] [--max-errors <N>] <mount>
 
11
 
 
12
DESCRIPTION
 
13
-----------
 
14
Receives one or more subvolumes that were previously
 
15
sent with *btrfs send*. The received subvolumes are stored
 
16
into <mount>.
 
17
 
 
18
*btrfs receive* will fail with the following case:
 
19
 
 
20
1. a receiving subvolume already exists.
 
21
 
 
22
2. a previously received subvolume was changed after it was received.
 
23
 
 
24
3. default subvolume is changed or you don't mount btrfs filesystem with
 
25
fs tree.
 
26
 
 
27
After receiving a subvolume, it is immediately set to read only.
 
28
 
 
29
`Options`
 
30
 
 
31
-v::
 
32
Enable verbose debug output. Each occurrence of this option increases the
 
33
verbose level more.
 
34
-f <infile>::
 
35
By default, btrfs receive uses stdin to receive the subvolumes.
 
36
Use this option to specify a file to use instead.
 
37
-e::
 
38
Terminate after receiving an <end cmd> in the data stream.
 
39
Without this option, the receiver terminates only if an error is recognized
 
40
or on EOF.
 
41
--max-errors <N>::
 
42
Terminate as soon as N errors happened while processing commands from the send
 
43
stream. Default value is 1. A value of 0 means no limit.
 
44
 
 
45
EXIT STATUS
 
46
-----------
 
47
*btrfs receive* returns a zero exist status if it succeeds. Non zero is
 
48
returned in case of failure.
 
49
 
 
50
AVAILABILITY
 
51
------------
 
52
*btrfs* is part of btrfs-progs.
 
53
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 
54
further details.
 
55
 
 
56
SEE ALSO
 
57
--------
 
58
`mkfs.btrfs`(8),
 
59
`btrfs-send`(8)