git: 8a1d6d6da5cf - main - VOP_OPENCLOSE.9: note that td may be NULL for VOP_CLOSE

From: Jason A. Harmening <jah_at_FreeBSD.org>
Date: Fri, 17 Oct 2025 18:25:55 UTC
The branch main has been updated by jah:

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

commit 8a1d6d6da5cfe0b69c08f20e52817aa9920efe87
Author:     Jason A. Harmening <jah@FreeBSD.org>
AuthorDate: 2025-10-16 15:25:51 +0000
Commit:     Jason A. Harmening <jah@FreeBSD.org>
CommitDate: 2025-10-17 18:24:33 +0000

    VOP_OPENCLOSE.9: note that td may be NULL for VOP_CLOSE
    
    MFC after:      3 days
    Reviewed by:    asomers, olce
    Differential Revision:  https://reviews.freebsd.org/D53137
---
 share/man/man9/VOP_OPENCLOSE.9 | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/share/man/man9/VOP_OPENCLOSE.9 b/share/man/man9/VOP_OPENCLOSE.9
index 9a4f7069962d..672f9faa92f5 100644
--- a/share/man/man9/VOP_OPENCLOSE.9
+++ b/share/man/man9/VOP_OPENCLOSE.9
@@ -26,7 +26,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd December 2, 2009
+.Dd October 17, 2025
 .Dt VOP_OPEN 9
 .Os
 .Sh NAME
@@ -78,6 +78,17 @@ The access mode is a set of flags, including
 .Dv FWRITE ,
 .Dv O_NONBLOCK ,
 .Dv O_APPEND .
+.Pp
+The thread
+.Fa td
+passed to
+.Fn VOP_CLOSE
+may be
+.Ql NULL
+if the last reference to the open file is released from a kernel context, e.g.,
+the destruction of a socket buffer containing the file reference in a
+.Dv SCM_RIGHTS
+message.
 .Sh LOCKS
 .Fn VOP_OPEN
 expects