git: 3664eb6ff7fa - stable/12 - gvinum: add deprecation notice

From: Ed Maste <emaste_at_FreeBSD.org>
Date: Fri, 03 Dec 2021 15:17:39 UTC
The branch stable/12 has been updated by emaste:

URL: https://cgit.FreeBSD.org/src/commit/?id=3664eb6ff7fa7161fb346c2b7c24c919d84ad6dd

commit 3664eb6ff7fa7161fb346c2b7c24c919d84ad6dd
Author:     Ed Maste <emaste@FreeBSD.org>
AuthorDate: 2021-03-26 15:26:22 +0000
Commit:     Ed Maste <emaste@FreeBSD.org>
CommitDate: 2021-12-03 15:17:12 +0000

    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
    
    (cherry picked from commit b218441ac074d9cb9417e284980bf87f79a89585)
---
 sbin/gvinum/gvinum.8 | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/sbin/gvinum/gvinum.8 b/sbin/gvinum/gvinum.8
index 950a0188946f..a8135e9bf4a2 100644
--- a/sbin/gvinum/gvinum.8
+++ b/sbin/gvinum/gvinum.8
@@ -28,12 +28,28 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 6, 2014
+.Dd March 28, 2021
 .Dt GVINUM 8
 .Os
 .Sh NAME
 .Nm gvinum
 .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
 .Nm
 .Op Ar command