btrfs-progs: docs: how to use swapfile from fstab

This was asked on reddit, how to automatically mount a swapfile from
fstab. As this is not completely obvious, document it with an example.

Signed-off-by: David Sterba <dsterba@suse.com>
This commit is contained in:
David Sterba 2021-04-22 23:00:58 +02:00
parent c266dd462b
commit 47fdb7f5da
1 changed files with 30 additions and 6 deletions

View File

@ -684,6 +684,8 @@ When there are no active swapfiles and a whole-filesystem exclusive operation
is running (ie. balance, device delete, shrink), the swapfiles cannot be
temporarily activated. The operation must finish first.
To create and activate a swapfile run the following commands:
--------------------
# truncate -s 0 swapfile
# chattr +C swapfile
@ -693,6 +695,28 @@ temporarily activated. The operation must finish first.
# swapon swapfile
--------------------
Please note that the UUID returned by the 'mkswap' utility identifies the swap
"filesystem" and because it's stored in a file, it's not generally visible and
usable as an identifier unlike if it was on a block device.
The file will appear in '/proc/swaps':
--------------------
# cat /proc/swaps
Filename Type Size Used Priority
/path/swapfile file 2097152 0 -2
--------------------
The swapfile can be created as one-time operation or, once properly created,
activated on each boot by the 'swapon -a' command (usually started by the
service manager). Add the following entry to '/etc/fstab', assuming the
filesystem that provides the '/path' has been already mounted at this point.
Additional mount options relevant for the swapfile can be set too (like
priority, not the btrfs mount options).
--------------------
/path/swapfile none swap defaults 0 0
--------------------
CHECKSUM ALGORITHMS
-------------------