From 6cb6eeb11de9fe0345a4c3f173c157931bb9d1bb Mon Sep 17 00:00:00 2001 From: Shawn Bohrer Date: Sat, 26 May 2012 12:57:55 -0500 Subject: 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 --- man/btrfs.8.in | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) (limited to 'man/btrfs.8.in') diff --git a/man/btrfs.8.in b/man/btrfs.8.in index 852d82d1..d038b39f 100644 --- a/man/btrfs.8.in +++ b/man/btrfs.8.in @@ -19,7 +19,7 @@ btrfs \- control a btrfs filesystem .PP \fBbtrfs\fP \fBfilesystem sync\fP\fI \fP .PP -\fBbtrfs\fP \fBfilesystem resize\fP\fI [+/\-][gkm]|max \fP +\fBbtrfs\fP \fBfilesystem resize\fP\fI [devid:][+/\-][gkm]|[devid:]max \fP .PP \fBbtrfs\fP \fBfilesystem label\fP\fI [newlabel]\fP .PP @@ -168,23 +168,28 @@ Force a sync for the filesystem identified by \fI\fR. .\" Some wording are extracted by the resize2fs man page .\" -\fBfilesystem resize\fR\fI [+/\-][gkm]|max \fR -Resize a filesystem identified by \fI\fR. +\fBfilesystem resize\fR\fI [devid:][+/\-][gkm]|[devid:]max \fR +Resize a filesystem identified by \fI\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\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\fR. If no units are specified, the unit of the \fI\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, respectively. If 'max' is passed, the filesystem will occupy all available space on the -volume(s). +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. .TP \fBbtrfs\fP \fBfilesystem label\fP\fI [newlabel]\fP -- cgit v1.2.3