git: 1692e50f2573 - main - vfs: bring getnewvnode manpage closer to reality

From: Mateusz Guzik <mjg_at_FreeBSD.org>
Date: Wed, 01 Nov 2023 08:21:20 UTC
The branch main has been updated by mjg:

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

commit 1692e50f25730bfa0c579396bc2f79973717b30b
Author:     Mateusz Guzik <mjg@FreeBSD.org>
AuthorDate: 2023-11-01 08:20:12 +0000
Commit:     Mateusz Guzik <mjg@FreeBSD.org>
CommitDate: 2023-11-01 08:21:10 +0000

    vfs: bring getnewvnode manpage closer to reality
---
 share/man/man9/getnewvnode.9 | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/share/man/man9/getnewvnode.9 b/share/man/man9/getnewvnode.9
index 9c0219af1bba..89f8bfc0aa6e 100644
--- a/share/man/man9/getnewvnode.9
+++ b/share/man/man9/getnewvnode.9
@@ -24,7 +24,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
 .\" DAMAGE.
 .\"
-.Dd November 21, 2001
+.Dd November 1, 2023
 .Dt GETNEWVNODE 9
 .Os
 .Sh NAME
@@ -35,14 +35,12 @@
 .In sys/vnode.h
 .In sys/mount.h
 .Ft int
-.Fn getnewvnode "const char *tag" "struct mount *mp" "vop_t **vops" "struct vnode **vpp"
+.Fn getnewvnode "const char *tag" "struct mount *mp" "struct vop_vector *vops" "struct vnode **vpp"
 .Sh DESCRIPTION
 The
 .Fn getnewvnode
 function initializes a new vnode, assigning it the vnode operations passed in
 .Fa vops .
-The vnode is either freshly allocated, or taken from the head of the
-free list depending on the number of vnodes already in the system.
 .Pp
 The arguments to
 .Fn getnewvnode
@@ -61,7 +59,8 @@ Points to the new vnode upon successful completion.
 .Sh RETURN VALUES
 .Fn getnewvnode
 returns 0 on success.
-There are currently no failure conditions - that do not result in a panic.
+.Sh BUGS
+It never return an error, instead either succeeds or blocks indefinitely.
 .Sh AUTHORS
 This manual page was written by
 .An Chad David Aq Mt davidc@acns.ab.ca .