path: root/man
diff options
authorShawn Bohrer <>2012-05-26 12:57:55 -0500
committerChris Mason <>2012-07-03 16:27:46 -0400
commit6cb6eeb11de9fe0345a4c3f173c157931bb9d1bb (patch)
tree86fab582842e5302d9836fe9790b65d209a92407 /man
parentdfb2230423b48df0ad04112f102ea746338c845b (diff)
btrfs-progs: Update resize documentation
The btrfs filesystem resize command defaults to only resizing the filesystem for devid 1, and must have a devid passed in to resize the filesystem for the other devices in the filesystem. Additionally the documentation lacked information on how to actually resize the underlying partition so this provides a little more detail. Signed-off-by: Shawn Bohrer <>
Diffstat (limited to 'man')
1 files changed, 11 insertions, 6 deletions
diff --git a/man/ b/man/
index 852d82d1..d038b39f 100644
--- a/man/
+++ b/man/
@@ -19,7 +19,7 @@ btrfs \- control a btrfs filesystem
\fBbtrfs\fP \fBfilesystem sync\fP\fI <path> \fP
-\fBbtrfs\fP \fBfilesystem resize\fP\fI [+/\-]<size>[gkm]|max <filesystem>\fP
+\fBbtrfs\fP \fBfilesystem resize\fP\fI [devid:][+/\-]<size>[gkm]|[devid:]max <filesystem>\fP
\fBbtrfs\fP \fBfilesystem label\fP\fI <dev> [newlabel]\fP
@@ -168,23 +168,28 @@ Force a sync for the filesystem identified by \fI<path>\fR.
.\" Some wording are extracted by the resize2fs man page
-\fBfilesystem resize\fR\fI [+/\-]<size>[gkm]|max <path>\fR
-Resize a filesystem identified by \fI<path>\fR.
+\fBfilesystem resize\fR\fI [devid:][+/\-]<size>[gkm]|[devid:]max <path>\fR
+Resize a filesystem identified by \fI<path>\fR for the underlying device
+\fIdevid\fR. The \fIdevid\fR can be found with \fBbtrfs filesystem show\fR and
+defaults to 1 if not specified.
The \fI<size>\fR parameter specifies the new size of the filesystem.
If the prefix \fI+\fR or \fI\-\fR is present the size is increased or decreased
by the quantity \fI<size>\fR.
If no units are specified, the unit of the \fI<size>\fR parameter defaults to
bytes. Optionally, the size parameter may be suffixed by one of the following
-the units designators: 'K', 'M', or 'G', kilobytes, megabytes, or gigabytes,
+the unit designators: 'K', 'M', or 'G', kilobytes, megabytes, or gigabytes,
If 'max' is passed, the filesystem will occupy all available space on the
+device \fIdevid\fR.
The \fBresize\fR command \fBdoes not\fR manipulate the size of underlying
partition. If you wish to enlarge/reduce a filesystem, you must make sure you
can expand the partition before enlarging the filesystem and shrink the
-partition after reducing the size of the filesystem.
+partition after reducing the size of the filesystem. This can done using
+\fBfdisk(8)\fR or \fBparted(8)\fR to delete the existing partition and recreate
+it with the new desired size. When recreating the partition make sure to use
+the same starting disk cylinder as before.
\fBbtrfs\fP \fBfilesystem label\fP\fI <dev> [newlabel]\fP