diff options
Diffstat (limited to 'upstream/archlinux/man8/btrfs-balance.8')
| -rw-r--r-- | upstream/archlinux/man8/btrfs-balance.8 | 52 |
1 files changed, 19 insertions, 33 deletions
diff --git a/upstream/archlinux/man8/btrfs-balance.8 b/upstream/archlinux/man8/btrfs-balance.8 index c30684c6..dbf1c982 100644 --- a/upstream/archlinux/man8/btrfs-balance.8 +++ b/upstream/archlinux/man8/btrfs-balance.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-BALANCE" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-BALANCE" "8" "May 03, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-balance \- balance block groups on a btrfs filesystem .SH SYNOPSIS @@ -37,7 +37,7 @@ btrfs-balance \- balance block groups on a btrfs filesystem .sp The primary purpose of the balance feature is to spread block groups across all devices so they match constraints defined by the respective profiles. See -\fI\%mkfs.btrfs(8)\fP section \fI\%PROFILES\fP +\fI\%mkfs.btrfs(8)\fP section \X'tty: link #man-mkfs-profiles'\fI\%PROFILES\fP\X'tty: link' for more details. The scope of the balancing process can be further tuned by use of filters that can select the block groups to process. Balance works only on a mounted @@ -185,7 +185,7 @@ or \fIraid6\fP .INDENT 7.0 .TP .B \-\-background|\-\-bg -run the balance operation asynchronously in the background, uses \fBfork(2)\fP to +run the balance operation asynchronously in the background, uses \X'tty: link https://man7.org/linux/man-pages/man2/fork.2.html'\fI\%fork(2)\fP\X'tty: link' to start the process that calls the kernel ioctl .UNINDENT .INDENT 7.0 @@ -366,7 +366,7 @@ Profile names, used in \fBprofiles\fP and \fBconvert\fP are one of: The mixed data/metadata profiles can be converted in the same way, but conversion between mixed and non\-mixed is not implemented. For the constraints of the profiles please refer to \fI\%mkfs.btrfs(8)\fP section -\fI\%PROFILES\fP\&. +\X'tty: link #man-mkfs-profiles'\fI\%PROFILES\fP\X'tty: link'\&. .SH ENOSPC .sp The way balance operates, it usually needs to temporarily create a new block @@ -381,14 +381,12 @@ command: .INDENT 0.0 .INDENT 3.5 .sp -.nf -.ft C +.EX Label: \(aqBTRFS\(aq uuid: 8a9d72cd\-ead3\-469d\-b371\-9c7203276265 Total devices 2 FS bytes used 77.03GiB devid 1 size 53.90GiB used 51.90GiB path /dev/sdc2 devid 2 size 53.90GiB used 51.90GiB path /dev/sde1 -.ft P -.fi +.EE .UNINDENT .UNINDENT .sp @@ -419,15 +417,13 @@ Let\(aqs use the following real life example and start with the output: .INDENT 0.0 .INDENT 3.5 .sp -.nf -.ft C +.EX $ btrfs filesystem df /path Data, single: total=75.81GiB, used=64.44GiB System, RAID1: total=32.00MiB, used=20.00KiB Metadata, RAID1: total=15.87GiB, used=8.84GiB GlobalReserve, single: total=512.00MiB, used=0.00B -.ft P -.fi +.EE .UNINDENT .UNINDENT .sp @@ -451,8 +447,7 @@ data and thus will be faster. A typical filter command would look like: .INDENT 0.0 .INDENT 3.5 .sp -.nf -.ft C +.EX # btrfs balance start \-dusage=50 /path Done, had to relocate 2 out of 97 chunks @@ -461,8 +456,7 @@ Data, single: total=74.03GiB, used=64.43GiB System, RAID1: total=32.00MiB, used=20.00KiB Metadata, RAID1: total=15.87GiB, used=8.84GiB GlobalReserve, single: total=512.00MiB, used=0.00B -.ft P -.fi +.EE .UNINDENT .UNINDENT .sp @@ -472,8 +466,7 @@ usage filter. .INDENT 0.0 .INDENT 3.5 .sp -.nf -.ft C +.EX # btrfs balance start \-dusage=85 /path Done, had to relocate 13 out of 95 chunks @@ -482,8 +475,7 @@ Data, single: total=68.03GiB, used=64.43GiB System, RAID1: total=32.00MiB, used=20.00KiB Metadata, RAID1: total=15.87GiB, used=8.85GiB GlobalReserve, single: total=512.00MiB, used=0.00B -.ft P -.fi +.EE .UNINDENT .UNINDENT .sp @@ -499,8 +491,7 @@ reflinks updated frequently. .INDENT 0.0 .INDENT 3.5 .sp -.nf -.ft C +.EX # btrfs balance start \-musage=50 /path Done, had to relocate 4 out of 89 chunks @@ -509,8 +500,7 @@ Data, single: total=68.03GiB, used=64.43GiB System, RAID1: total=32.00MiB, used=20.00KiB Metadata, RAID1: total=14.87GiB, used=8.85GiB GlobalReserve, single: total=512.00MiB, used=0.00B -.ft P -.fi +.EE .UNINDENT .UNINDENT .sp @@ -523,8 +513,7 @@ further compaction: .INDENT 0.0 .INDENT 3.5 .sp -.nf -.ft C +.EX # btrfs balance start \-musage=70 /path Done, had to relocate 13 out of 88 chunks @@ -533,8 +522,7 @@ Data, single: total=68.03GiB, used=64.43GiB System, RAID1: total=32.00MiB, used=20.00KiB Metadata, RAID1: total=11.97GiB, used=8.83GiB GlobalReserve, single: total=512.00MiB, used=0.00B -.ft P -.fi +.EE .UNINDENT .UNINDENT .SS GETTING RID OF COMPLETELY UNUSED BLOCK GROUPS @@ -551,11 +539,9 @@ can be used to reclaim unused block groups to make it available. .INDENT 0.0 .INDENT 3.5 .sp -.nf -.ft C +.EX # btrfs balance start \-dusage=0 /path -.ft P -.fi +.EE .UNINDENT .UNINDENT .sp @@ -575,7 +561,7 @@ or a balance operation is still running, and \fB2\fP on other errors. .SH AVAILABILITY .sp \fBbtrfs\fP is part of btrfs\-progs. Please refer to the documentation at -\fI\%https://btrfs.readthedocs.io\fP\&. +\X'tty: link https://btrfs.readthedocs.io'\fI\%https://btrfs.readthedocs.io\fP\X'tty: link'\&. .SH SEE ALSO .sp \fI\%mkfs.btrfs(8)\fP, |