gvinum: add deprecation notice

Vinum is a Logical Volume Manager that was introduced in FreeBSD 3.0,
and for FreeBSD 5 was ported to geom(4) as gvinum. gvinum has had no
specific development at least as far back as 2010, and has a number of
known bugs which are unlikely to be resolved.

Add a deprecation notice to raise awareness but state that vinum "may
not be" available in FreeBSD 14.  Either it will be removed and the
notice will be updated to "is not" available, or someone will step up
to fix issues and maintain it and we will remove the notice.

Reviewed by:	imp (earlier version)
MFC after:	3 days
Sponsored by:	The FreeBSD Foundation
Differential Revision:	https://reviews.freebsd.org/D29424
This commit is contained in:
Ed Maste 2021-03-26 11:26:22 -04:00
parent 3428b6c050
commit b218441ac0

View File

@ -28,12 +28,28 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd May 6, 2014 .Dd March 28, 2021
.Dt GVINUM 8 .Dt GVINUM 8
.Os .Os
.Sh NAME .Sh NAME
.Nm gvinum .Nm gvinum
.Nd Logical Volume Manager control program .Nd Logical Volume Manager control program
.Sh DEPRECATION NOTICE
.Nm
and associated
.Xr geom 4
kernel support is deprecated, and may not be available in
.Fx 14.0
and later.
Users are advised to migrate to
.Xr gconcat 8 ,
.Xr gmirror 8 ,
.Xr gstripe 8 ,
.Xr graid 8 ,
or
.Xr ZFS 8 .
More information is available at
.Pa https://wiki.freebsd.org/DeprecationPlan/gvinum .
.Sh SYNOPSIS .Sh SYNOPSIS
.Nm .Nm
.Op Ar command .Op Ar command