git: 42f1df609996 - stable/13 - gvinum: add deprecation notice

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

URL: https://cgit.FreeBSD.org/src/commit/?id=42f1df609996acd7c506e6cb3f75ca8a142ef895

commit 42f1df609996acd7c506e6cb3f75ca8a142ef895
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:16:23 +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