summaryrefslogtreecommitdiff
path: root/Documentation/btrfs-send.txt
blob: 18a98fa3861e230eb7fd064546f14c6be2829fa3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
btrfs-send(8)
=============

NAME
----
btrfs-send - send data of subvolume(s) to stdout/file.

SYNOPSIS
--------
'btrfs send' [-ve] [-p <parent>] [-c <clone-src>] [-f <outfile>] <subvol> [<subvol>...]

DESCRIPTION
-----------
Sends the subvolume(s) specified by <subvol> to stdout.

By default, this will send the whole subvolume. To do an incremental
send, use '-p <parent>'.

If you want to allow btrfs to clone from any additional local snapshots,
use '-c <clone-src>' (multiple times where applicable). 

You must not specify clone sources unless you guarantee that these snapshots
are exactly in the same state on both sides, the sender and the receiver.

It is allowed to omit the '-p <parent>' option when '-c <clone-src>' options
are given, in which case 'btrfs send' will determine a suitable parent among the
clone sources itself.

`Options`

-v::
Enable verbose debug output. Each occurrence of this option increases the
verbose level more.
-e::
If sending multiple subvols at once, use the new format and omit the <end cmd> between the subvols.
-p <parent>::
Send an incremental stream from <parent> to <subvol>.
-c <clone-src>::
Use this snapshot as a clone source for an incremental send (multiple allowed).
-f <outfile>::
Output is normally written to stdout. To write to a file, use this option.
An alternative would be to use pipes.

EXIT STATUS
-----------
'btrfs send' returns a zero exist status if it succeeds. Non zero is
returned in case of failure.

AVAILABILITY
------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
development,
and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
further details.

SEE ALSO
--------
`mkfs.btrfs`(8),
`btrfs-receive`(8)