Bug 1016576

Summary:	btrfs manpage: need detailed descriptions about command "filesystem balance"
Product:	Red Hat Enterprise Linux 7	Reporter:	Eryu Guan <eguan>
Component:	btrfs-progs	Assignee:	fs-maint
Status:	CLOSED DUPLICATE	QA Contact:	Filesystem QE <fs-qe>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	7.0	CC:	esandeen, pschiffe
Target Milestone:	rc	Keywords:	ManPageChange
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:	btrfs-progs-3.16-1.el7	Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2014-10-15 23:15:09 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:

Description Eryu Guan 2013-10-08 11:13:43 UTC

Description of problem:
We have very simple description about "filesystem balance" command, need more detailed descriptions about:

btrfs fi balance start
btrfs fi balance pause
btrfs fi balance cancel
btrfs fi balance resume
btrfs fi balance status
(described at http://www.mail-archive.com/linux-btrfs@vger.kernel.org/msg14365.html)

And all filters as described at https://btrfs.wiki.kernel.org/index.php/Balance_Filters

Version-Release number of selected component (if applicable):
btrfs-progs-0.20.rc1.20130917git194aa4a-1.el7
upstream btrfs-progs too

How reproducible:
always

Steps to Reproduce:
1. man 8 btrfs and search for balance command
2.
3.

Actual results:


Expected results:


Additional info:

Comment 2 Eric Sandeen 2014-07-14 23:40:26 UTC

This has moved to the btrfs-balance(8) manpage.

However, there is still no description of filters, for example.

Comment 3 Eric Sandeen 2014-10-15 23:15:09 UTC

Fixed in v3.16 with:

6c30bee btrfs-progs: Documentation: Add filter section for btrfs-balance.


Closing this and others with NEXTRELEASE since it's part of a rebase, but if you prefer we can re-open, get all the acks, and add it to the errata.  I'm not sure if that's worth it, but if you want to, please let me know.

Thanks,
-Eric

Comment 4 Eric Sandeen 2014-10-15 23:20:08 UTC

Actually, probably better to dup to the rebase bug.

*** This bug has been marked as a duplicate of bug 1134981 ***