git: daa6660f8993 - main - deadfs.9: Document

The branch main has been updated by 0mp:

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

commit daa6660f899309f832bba0c7ac72dada125cfed5
Author:     Mateusz Piotrowski <0mp@FreeBSD.org>
AuthorDate: 2025-10-24 18:08:31 +0000
Commit:     Mateusz Piotrowski <0mp@FreeBSD.org>
CommitDate: 2025-10-24 18:35:15 +0000

    deadfs.9: Document
    
    Reviewed by:    kib
    MFC after:      2 weeks
    Differential Revision:  https://reviews.freebsd.org/D53334
---
 share/man/man9/Makefile |  1 +
 share/man/man9/deadfs.9 | 36 ++++++++++++++++++++++++++++++++++++
 2 files changed, 37 insertions(+)

diff --git a/share/man/man9/Makefile b/share/man/man9/Makefile
index 52ec9be3ae02..80fd8e198a5b 100644
--- a/share/man/man9/Makefile
+++ b/share/man/man9/Makefile
@@ -90,6 +90,7 @@ MAN=	accept_filter.9 \
 	DECLARE_MODULE.9 \
 	DEFINE_IFUNC.9 \
 	DELAY.9 \
+	deadfs.9 \
 	devclass.9 \
 	devclass_find.9 \
 	devclass_get_device.9 \
diff --git a/share/man/man9/deadfs.9 b/share/man/man9/deadfs.9
new file mode 100644
index 000000000000..360451266625
--- /dev/null
+++ b/share/man/man9/deadfs.9
@@ -0,0 +1,36 @@
+.\"
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
+.\" Copyright (c) 2025 Mateusz Piotrowski <0mp@FreeBSD.org>
+.\"
+.Dd October 24, 2025
+.Dt DEADFS 9
+.Os
+.Sh NAME
+.Nm deadfs
+.Nd pseudo-filesystem to own reclaimed vnodes
+.Sh DESCRIPTION
+The
+.Nm
+file system implements operations that do not modify any data
+and instead return indications of invalid IO.
+Its role is to provide a fallback vnode operations vector for reclaimed
+.Xr vnode 9 Ap s .
+.Pp
+It is a kernel-only pseudo-file system and so cannot be mounted from userspace.
+.Sh SEE ALSO
+.Xr insmntque 9 ,
+.Xr vnode 9 ,
+.Xr VOP_RECLAIM 9
+.Sh HISTORY
+UNIX System Manager's Manual (SMM) for
+.Bx 4.4
+described
+.Nm
+as a file system
+.Dq where rejected vnods go to die .
+.Sh AUTHORS
+The
+.Nm
+manual page was written by
+.An Mateusz Piotrowski Aq Mt 0mp@FreeBSD.org .