Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Wrong information inside the zfs-create man page on the 2.1-release branch #16891

Open
makhomed opened this issue Dec 20, 2024 · 1 comment
Open
Labels
Type: Defect Incorrect behavior (e.g. crash, hang)

Comments

@makhomed
Copy link

System information

Type Version/Name
OpenZFS Version zfs-2.1.16-1

Describe the problem you're observing

Wrong information inside the zfs-create man page on the 2.1-release branch

Describe how to reproduce the problem

https://github.com/openzfs/zfs/blob/zfs-2.1-release/man/man8/zfs-create.8#L237-L243

.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.

This manual bug only present on the 2.1-release branch:

https://github.com/openzfs/zfs/blob/zfs-2.1-release/man/man8/zfs-create.8#L237-L243

Inside 2.2-release release branch this bug already fixed:

https://github.com/openzfs/zfs/blob/zfs-2.2-release/man/man8/zfs-create.8#L237-L239

Inside 2.3-release release branch this bug already fixed:

https://github.com/openzfs/zfs/blob/zfs-2.3-release/man/man8/zfs-create.8#L237-L239

P.S.

More details - in the OpenZFS FAQ - Using a zvol for a swap device on Linux and ZFS issue #7734

@makhomed makhomed added the Type: Defect Incorrect behavior (e.g. crash, hang) label Dec 20, 2024
@amotin
Copy link
Member

amotin commented Dec 20, 2024

Anybody who care about 2.1 is always welcome to open a PR. But the questions are: does anybody care, and will there be another 2.1 release for this to appear at.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Type: Defect Incorrect behavior (e.g. crash, hang)
Projects
None yet
Development

No branches or pull requests

2 participants