summaryrefslogtreecommitdiffstats
path: root/upstream/fedora-rawhide/man8/btrfs-filesystem.8
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/fedora-rawhide/man8/btrfs-filesystem.8')
-rw-r--r--upstream/fedora-rawhide/man8/btrfs-filesystem.821
1 files changed, 15 insertions, 6 deletions
diff --git a/upstream/fedora-rawhide/man8/btrfs-filesystem.8 b/upstream/fedora-rawhide/man8/btrfs-filesystem.8
index f73467d9..dcf12d42 100644
--- a/upstream/fedora-rawhide/man8/btrfs-filesystem.8
+++ b/upstream/fedora-rawhide/man8/btrfs-filesystem.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-FILESYSTEM" "8" "Feb 14, 2024" "6.7.1" "BTRFS"
+.TH "BTRFS-FILESYSTEM" "8" "Mar 26, 2024" "6.8.1" "BTRFS"
.SH NAME
btrfs-filesystem \- command group that primarily does work on the whole filesystems
.SH SYNOPSIS
@@ -292,7 +292,7 @@ Subvolume containing a swapfile cannot be snapshotted and blocks of an
activated swapfile cannot be balanced.
.sp
Swapfile creation can be achieved by standalone commands too. Activation
-needs to be done by command \fBswapon(8)\fP\&. See also command
+needs to be done by command \fI\%swapon(8)\fP\&. See also command
\fBbtrfs inspect\-internal map\-swapfile\fP
and the \fI\%Swapfile feature\fP description.
.sp
@@ -346,12 +346,21 @@ device respecting \fIdevid\fP (remember, devid 1 by default).
.sp
The resize command does not 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. This can done using
-\fBfdisk(8)\fP or \fBparted(8)\fP to delete the existing partition and recreate
+expand the partition before enlarging the filesystem and shrink the
+partition after reducing the size of the filesystem. This can be done using
+\fI\%fdisk(8)\fP or \fI\%parted(8)\fP to delete the existing partition and recreate
it with the new desired size. When recreating the partition make sure to use
the same starting partition offset as before.
.sp
+The size of the portion that the filesystem uses of an underlying device can be
+determined via the \fBbtrfs filesystem show \-\-raw\fP command on the
+filesystem’s mount point (where it’s given for each \fIdevid\fP after the string
+\fIsize\fP or via the \fBbtrfs inspect\-internal dump\-super\fP command on the
+specific device (where it’s given as the value of \fIdev_item.total_bytes\fP, which
+is not to be confused with \fItotal_bytes\fP).
+The value is also the address of the first byte not used by the
+filesystem.
+.sp
Growing is usually instant as it only updates the size. However, shrinking could
take a long time if there are data in the device area that\(aqs beyond the new
end. Relocation of the data takes time.
@@ -411,7 +420,7 @@ show sizes in TiB, or TB with \-\-si
.UNINDENT
.TP
.B sync <path>
-Force a sync of the filesystem at \fIpath\fP, similar to the \fBsync(1)\fP command. In
+Force a sync of the filesystem at \fIpath\fP, similar to the \fI\%sync(1)\fP command. In
addition, it starts cleaning of deleted subvolumes. To wait for the subvolume
deletion to complete use the \fBbtrfs subvolume sync\fP command.
.TP