'\" t
.\"     Title: btrfs-send
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 06/20/2015
.\"    Manual: Btrfs Manual
.\"    Source: Btrfs v3.17
.\"  Language: English
.\"
.TH "BTRFS\-SEND" "8" "06/20/2015" "Btrfs v3\&.17" "Btrfs Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
btrfs-send \- send data of subvolume(s) to stdout/file\&.
.SH "SYNOPSIS"
.sp
\fBbtrfs send\fR [\-ve] [\-p \fI<parent>\fR] [\-c \fI<clone\-src>\fR] [\-f \fI<outfile>\fR] \fI<subvol>\fR [\fI<subvol>\fR\&...]
.SH "DESCRIPTION"
.sp
Sends the subvolume(s) specified by \fI<subvol>\fR to stdout\&.
.sp
By default, this will send the whole subvolume\&. To do an incremental send, use \fI\-p \*(Aq<parent>\fR\*(Aq\&.
.sp
If you want to allow btrfs to clone from any additional local snapshots, use \fI\-c \*(Aq<clone\-src>\fR\*(Aq (multiple times where applicable)\&.
.sp
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\&.
.sp
It is allowed to omit the \fI\-p \*(Aq<parent>\fR\*(Aq option when \fI\-c \*(Aq<clone\-src>\fR\*(Aq options are given, in which case \fBbtrfs send\fR will determine a suitable parent among the clone sources itself\&.
.sp
\fBOptions\fR
.PP
\-v
.RS 4
Enable verbose debug output\&. Each occurrence of this option increases the verbose level more\&.
.RE
.PP
\-e
.RS 4
If sending multiple subvols at once, use the new format and omit the
\fI<end cmd>\fR
between the subvols\&.
.RE
.PP
\-p \fI<parent>\fR
.RS 4
Send an incremental stream from
\fI<parent>\fR
to
\fI<subvol>\fR\&.
.RE
.PP
\-c \fI<clone\-src>\fR
.RS 4
Use this snapshot as a clone source for an incremental send (multiple allowed)\&.
.RE
.PP
\-f \fI<outfile>\fR
.RS 4
Output is normally written to stdout\&. To write to a file, use this option\&. An alternative would be to use pipes\&.
.RE
.SH "EXIT STATUS"
.sp
\fBbtrfs send\fR returns a zero exit status if it succeeds\&. Non zero is returned in case of failure\&.
.SH "AVAILABILITY"
.sp
\fBbtrfs\fR is part of btrfs\-progs\&. Please refer to the btrfs wiki \m[blue]\fBhttp://btrfs\&.wiki\&.kernel\&.org\fR\m[] for further details\&.
.SH "SEE ALSO"
.sp
\fBmkfs\&.btrfs\fR(8), \fBbtrfs\-receive\fR(8)