'\" t
.\" Title: btrfs-replace
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.78.1
.\" Date: 10/02/2016
.\" Manual: Btrfs Manual
.\" Source: Btrfs v4.7.3
.\" Language: English
.\"
.TH "BTRFS\-REPLACE" "8" "10/02/2016" "Btrfs v4\&.7\&.3" "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-replace \- replace devices managed by btrfs with other device\&.
.SH "SYNOPSIS"
.sp
\fBbtrfs replace\fR \fI\fR \fI\fR
.SH "DESCRIPTION"
.sp
\fBbtrfs replace\fR is used to replace btrfs managed devices with other device\&.
.SH "SUBCOMMAND"
.PP
\fBcancel\fR \fI\fR
.RS 4
Cancel a running device replace operation\&.
.RE
.PP
\fBstart\fR [\-Bfr] \fI\fR|\fI\fR \fI\fR \fI\fR
.RS 4
Replace device of a btrfs filesystem\&.
.sp
On a live filesystem, duplicate the data to the target device which is currently stored on the source device\&. If the source device is not available anymore, or if the \-r option is set, the data is built only using the RAID redundancy mechanisms\&. After completion of the operation, the source device is removed from the filesystem\&. If the
\fI\fR
is a numerical value, it is assumed to be the device id of the filesystem which is mounted at
\fI\fR, otherwise is is the path to the source device\&. If the source device is disconnected, from the system, you have to use the devid parameter format\&. The
\fI\fR
needs to be same size or larger than the
\fI\fR\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
the filesystem has to be resized to fully take advantage of a larger target device, this can be achieved with
\fBbtrfs filesystem resize :max /path\fR
.sp .5v
.RE
\fBOptions\fR
.PP
\-r
.RS 4
only read from
\fI\fR
if no other zero\-defect mirror exists\&. (enable this if your drive has lots of read errors, the access would be very slow)
.RE
.PP
\-f
.RS 4
force using and overwriting
\fI\fR
even if it looks like containing a valid btrfs filesystem\&.
.sp
A valid filesystem is assumed if a btrfs superblock is found which contains a correct checksum\&. Devices which are currently mounted are never allowed to be used as the
\fI\fR\&.
.RE
.PP
\-B
.RS 4
no background replace\&.
.RE
.RE
.PP
\fBstatus\fR [\-1] \fI\fR
.RS 4
Print status and progress information of a running device replace operation\&.
.sp
\fBOptions\fR
.PP
\-1
.RS 4
print once instead of print continuously until the replace operation finishes (or is cancelled)
.RE
.RE
.SH "EXIT STATUS"
.sp
\fBbtrfs replace\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\-device\fR(8),