Skip to content

Commit

Permalink
zfs-create(8): ZFS for swap: caution, clarity
Browse files Browse the repository at this point in the history
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).

<openzfs#7734> (Swap deadlock in 0.7.9).

Singular, not plural, for non-supported swapping to a file.

Pull-request:  openzfs#14756
Signed-off-by: Graham Perrin <grahamperrin@freebsd.org>
  • Loading branch information
grahamperrin committed May 28, 2023
1 parent 0f03a41 commit 4e56af4
Showing 1 changed file with 5 additions and 8 deletions.
13 changes: 5 additions & 8 deletions man/man8/zfs-create.8
Original file line number Diff line number Diff line change
Expand Up @@ -234,14 +234,11 @@ if the volume is not sparse.
Print verbose information about the created dataset.
.El
.El
.Ss ZFS Volumes as Swap
ZFS volumes may be used as swap devices.
After creating the volume with the
.Nm zfs Cm create Fl V
enable the swap area using the
.Xr swapon 8
command.
Swapping to files on ZFS filesystems is not supported.
.Ss ZFS for Swap
Swapping to a ZFS volume is prone to deadlock and not recommended.
See OpenZFS FAQ.
.Pp
Swapping to a file on a ZFS filesystem is not supported.
.
.Sh EXAMPLES
.\" These are, respectively, examples 1, 10 from zfs.8
Expand Down

0 comments on commit 4e56af4

Please sign in to comment.