24468f395f
- Make requirement on libattr-devel explicit (forwarded request 179218 from jengelh) OBS-URL: https://build.opensuse.org/request/show/179277 OBS-URL: https://build.opensuse.org/package/show/openSUSE:Factory/btrfsprogs?expand=0&rev=29
127 lines
3.7 KiB
Diff
127 lines
3.7 KiB
Diff
From ba5f32986c342795eb910e8d77b5a5756af049ce Mon Sep 17 00:00:00 2001
|
|
From: David Sterba <dsterba@suse.cz>
|
|
Date: Mon, 26 Mar 2012 19:25:41 +0200
|
|
Subject: [PATCH 05/10] btrfs-progs: document balance in manpage
|
|
|
|
Signed-off-by: David Sterba <dsterba@suse.cz>
|
|
---
|
|
btrfs_cmds.c | 74 +++++++++++++++++++++++++++++++++++++++++++++++++++++++--
|
|
1 files changed, 71 insertions(+), 3 deletions(-)
|
|
|
|
diff --git a/btrfs_cmds.c b/btrfs_cmds.c
|
|
index 17c3f8e..a7231d0 100644
|
|
--- a/btrfs_cmds.c
|
|
+++ b/btrfs_cmds.c
|
|
@@ -1350,9 +1350,38 @@ static struct option balance_longopts[] = {
|
|
{ 0, 0, 0, 0}
|
|
};
|
|
|
|
-/*
|
|
- * [-d [filters]] [-m [filters]] [-s [filters]] [-vf]
|
|
- */
|
|
+/**** man: btrfs filesystem balance start
|
|
+ *
|
|
+ * \Bbtrfs\b \Bfilesystem balance start\b \B[-d [filters]] [-m [filters]] [-s [filters]] [-vf]\b \I<path>\i
|
|
+ *
|
|
+ * Balance chunks accross the devices on filesystem under \Ipath\i. Control
|
|
+ * operation by subcommands.
|
|
+ *
|
|
+ * \B-d\b apply filters on data block groups
|
|
+ *
|
|
+ * \B-m\b apply filters on metadata block groups
|
|
+ *
|
|
+ * \B-s\b apply filters on system block groups
|
|
+ *
|
|
+ * \B-f\b force operation on system block groups
|
|
+ *
|
|
+ * \B-v\b verbose, dupms filters at the end of operation
|
|
+ *
|
|
+ * \Ifilters\i may be a comma separated list of the following items, see section \BBALANCE FILTERS\b for more.
|
|
+ *
|
|
+ * \Bprofile\b=raid0|raid1|raid10|single|dup specify profiles, multiple allowed, note to escape the '|' from shell
|
|
+ *
|
|
+ * \Busage\b=<nnn> process only block groups with usage above \Innn\i percent
|
|
+ *
|
|
+ * \Bdevid\b=<devid> process only block groups on device \Idevid\i
|
|
+ *
|
|
+ * \Bconvert\b=raid0|raid1|radi10|single|dup convert raid profile to the specified one (only one profile allowed)
|
|
+ *
|
|
+ * \Bvrange\b=[start]..[end] virtual block address space subset filter
|
|
+ *
|
|
+ * \Bdrange\b=[start]..[end] devid subset filter, it's tied to devid filter: we say balance out range [start..end) on a particular devid.
|
|
+ ****/
|
|
+
|
|
int do_balance(int argc, char **argv)
|
|
{
|
|
int fd;
|
|
@@ -1496,6 +1525,16 @@ int do_balance(int argc, char **argv)
|
|
return 0;
|
|
}
|
|
|
|
+/**** man: btrfs filesystem balance pause
|
|
+ *
|
|
+ * \Bbtrfs\b \Bfilesystem balance pause\b \I<path>\i
|
|
+ *
|
|
+ * Pause balance operation at the first possible occasion.
|
|
+ *
|
|
+ * Pause balance operation at the first possible occasion. This may block for a
|
|
+ * few minutes if the balance is in the middle of processing.
|
|
+ ****/
|
|
+
|
|
int do_balance_pause(int argc, char **argv)
|
|
{
|
|
int fd;
|
|
@@ -1522,6 +1561,16 @@ int do_balance_pause(int argc, char **argv)
|
|
return 0;
|
|
}
|
|
|
|
+/**** man: btrfs filesystem balance cancel
|
|
+ *
|
|
+ * \Bbtrfs\b \Bfilesystem balance cancel\b \I<path>\i
|
|
+ *
|
|
+ * Cancel balance operation at the first possible occasion.
|
|
+ *
|
|
+ * Cancel balance operation at the first possible occasion. This may block for
|
|
+ * a few minutes if the balance is in the middle of processing.
|
|
+ ****/
|
|
+
|
|
int do_balance_cancel(int argc, char **argv)
|
|
{
|
|
int fd;
|
|
@@ -1548,6 +1597,15 @@ int do_balance_cancel(int argc, char **argv)
|
|
return 0;
|
|
}
|
|
|
|
+/**** man: btrfs filesystem balance resume
|
|
+ *
|
|
+ * \Bbtrfs\b \Bfilesystem balance resume\b \I<path>\i
|
|
+ *
|
|
+ * Resume balance operation.
|
|
+ *
|
|
+ * Resume balance operation and continue from the last position.
|
|
+ ****/
|
|
+
|
|
int do_balance_resume(int argc, char **argv)
|
|
{
|
|
int fd;
|
|
@@ -1601,6 +1659,16 @@ static struct option balance_progress_longopts[] = {
|
|
{ 0, 0, 0, 0}
|
|
};
|
|
|
|
+/**** man: btrfs filesystem balance status
|
|
+ *
|
|
+ * \Bbtrfs\b \Bfilesystem balance status\b [-v] \I<path>\i
|
|
+ *
|
|
+ * Show status of running or paused balance operation.
|
|
+ *
|
|
+ * Show status of running or paused balance operation.
|
|
+ *
|
|
+ * \B-v\b verbose
|
|
+ ****/
|
|
int do_balance_progress(int argc, char **argv)
|
|
{
|
|
int fd;
|
|
--
|
|
1.7.6.233.gd79bc
|
|
|