Archive-Team
/
zfs
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 103 Wiki Activity

zfs-create(8): ZFS for swap: caution, clarity 

Make the section heading more generic (the section relates to ZFS files
as well as ZFS volumes).

Swapping to a ZFS volume is prone to deadlock. Remove the related
instruction, direct readers to OpenZFS FAQ. Related, but not linked
from within the manual page:

<https://openzfs.github.io/openzfs-docs/Project%20and%20Community/FAQ.html#using-a-zvol-for-a-swap-device-on-linux>
(Using a zvol for a swap device on Linux).

Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Signed-off-by: Graham Perrin <grahamperrin@freebsd.org>
Issue #7734 
Closes #14756
This commit is contained in:
Graham Perrin 2023-06-02 19:25:13 +01:00 committed by GitHub
parent 482da24e20
commit 6c29422e90
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 5 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
man/man8/zfs-create.8
View File

@ -234,14 +234,11 @@ if the volume is not sparse.
Print verbose information about the created dataset. Print verbose information about the created dataset.
.El .El
.El .El
.Ss ZFS Volumes as Swap .Ss ZFS for Swap
ZFS volumes may be used as swap devices. Swapping to a ZFS volume is prone to deadlock and not recommended.
After creating the volume with the See OpenZFS FAQ.
.Nm zfs Cm create Fl V .Pp
enable the swap area using the Swapping to a file on a ZFS filesystem is not supported.
.Xr swapon 8
command.
Swapping to files on ZFS filesystems is not supported.
. .
.Sh EXAMPLES .Sh EXAMPLES
.\" These are, respectively, examples 1, 10 from zfs.8 .\" These are, respectively, examples 1, 10 from zfs.8