git: a08b38dfcea3 - main - gpart.8: Document one of gpart destroy diagnostic message

From: Mateusz Piotrowski <0mp_at_FreeBSD.org>
Date: Fri, 24 Oct 2025 14:51:43 UTC
The branch main has been updated by 0mp:

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

commit a08b38dfcea3c61718dfa40b003518fa3d9adac4
Author:     Mateusz Piotrowski <0mp@FreeBSD.org>
AuthorDate: 2025-10-24 14:51:07 +0000
Commit:     Mateusz Piotrowski <0mp@FreeBSD.org>
CommitDate: 2025-10-24 14:51:07 +0000

    gpart.8: Document one of gpart destroy diagnostic message
    
    Reviewed by:    ziaee
    MFC after:      2 weeks
    Differential Revision:  https://reviews.freebsd.org/D52992
---
 lib/geom/part/gpart.8 | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/lib/geom/part/gpart.8 b/lib/geom/part/gpart.8
index f76c1d9d5d6c..2e11417f8494 100644
--- a/lib/geom/part/gpart.8
+++ b/lib/geom/part/gpart.8
@@ -22,7 +22,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd February 11, 2025
+.Dd October 24, 2025
 .Dt GPART 8
 .Os
 .Sh NAME
@@ -1497,6 +1497,26 @@ and
 .Bd -literal -offset indent
 /sbin/gpart backup ada0 | /sbin/gpart restore -F ada1 ada2
 .Ed
+.Sh DIAGNOSTICS
+.Bl -diag
+.It gpart: arg0 '%s': Invalid argument
+The provided
+.Ar geom
+argument
+is not a GEOM provider.
+Not every device in
+.Xr devfs 4
+is a GEOM provider.
+For example, a
+.Xr zfs 4
+zvol will show up as a GEOM provider only if its
+.Sy volmode
+is set properly
+.Po refer to
+.Xr zfsprops 8
+for details
+.Pc .
+.El
 .Sh SEE ALSO
 .Xr geom 4 ,
 .Xr boot0cfg 8 ,