xref: /freebsd/share/man/man9/getnewvnode.9 (revision 8b916c35c2885867df2351a94a4b22100ad8eade)
121642577SAlfred Perlstein.\"
221642577SAlfred Perlstein.\" Copyright (C) 2001 Chad David <davidc@acns.ab.ca>. All rights reserved.
321642577SAlfred Perlstein.\"
421642577SAlfred Perlstein.\" Redistribution and use in source and binary forms, with or without
521642577SAlfred Perlstein.\" modification, are permitted provided that the following conditions
621642577SAlfred Perlstein.\" are met:
721642577SAlfred Perlstein.\" 1. Redistributions of source code must retain the above copyright
821642577SAlfred Perlstein.\"    notice(s), this list of conditions and the following disclaimer as
921642577SAlfred Perlstein.\"    the first lines of this file unmodified other than the possible
1021642577SAlfred Perlstein.\"    addition of one or more copyright notices.
1121642577SAlfred Perlstein.\" 2. Redistributions in binary form must reproduce the above copyright
1221642577SAlfred Perlstein.\"    notice(s), this list of conditions and the following disclaimer in the
1321642577SAlfred Perlstein.\"    documentation and/or other materials provided with the distribution.
1421642577SAlfred Perlstein.\"
1521642577SAlfred Perlstein.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY
1621642577SAlfred Perlstein.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
1721642577SAlfred Perlstein.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
1821642577SAlfred Perlstein.\" DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) BE LIABLE FOR ANY
1921642577SAlfred Perlstein.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
2021642577SAlfred Perlstein.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
2121642577SAlfred Perlstein.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
2221642577SAlfred Perlstein.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2321642577SAlfred Perlstein.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2421642577SAlfred Perlstein.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
2521642577SAlfred Perlstein.\" DAMAGE.
2621642577SAlfred Perlstein.\"
271692e50fSMateusz Guzik.Dd November 1, 2023
2821642577SAlfred Perlstein.Dt GETNEWVNODE 9
2921642577SAlfred Perlstein.Os
3021642577SAlfred Perlstein.Sh NAME
3121642577SAlfred Perlstein.Nm getnewvnode
3221642577SAlfred Perlstein.Nd "get a new vnode"
3321642577SAlfred Perlstein.Sh SYNOPSIS
3421642577SAlfred Perlstein.In sys/param.h
3521642577SAlfred Perlstein.In sys/vnode.h
3621642577SAlfred Perlstein.In sys/mount.h
3721642577SAlfred Perlstein.Ft int
381692e50fSMateusz Guzik.Fn getnewvnode "const char *tag" "struct mount *mp" "struct vop_vector *vops" "struct vnode **vpp"
3921642577SAlfred Perlstein.Sh DESCRIPTION
4021642577SAlfred PerlsteinThe
4121642577SAlfred Perlstein.Fn getnewvnode
4221642577SAlfred Perlsteinfunction initializes a new vnode, assigning it the vnode operations passed in
4321642577SAlfred Perlstein.Fa vops .
4421642577SAlfred Perlstein.Pp
4521642577SAlfred PerlsteinThe arguments to
4621642577SAlfred Perlstein.Fn getnewvnode
4721642577SAlfred Perlsteinare:
4821642577SAlfred Perlstein.Bl -tag -width ".Fa vops"
4921642577SAlfred Perlstein.It Fa tag
508723b451SNate LawsonThe file system type string.
518723b451SNate LawsonThis field should only be referenced for debugging or for userland utilities.
5221642577SAlfred Perlstein.It Fa mp
5321642577SAlfred PerlsteinThe mount point to add the new vnode to.
5421642577SAlfred Perlstein.It Fa vops
5521642577SAlfred PerlsteinThe vnode operations to assign to the new vnode.
5621642577SAlfred Perlstein.It Fa vpp
5721642577SAlfred PerlsteinPoints to the new vnode upon successful completion.
5821642577SAlfred Perlstein.El
5921642577SAlfred Perlstein.Sh RETURN VALUES
6021642577SAlfred Perlstein.Fn getnewvnode
6121642577SAlfred Perlsteinreturns 0 on success.
621692e50fSMateusz Guzik.Sh BUGS
63*8b916c35SMateusz GuzikIt never returns an error, instead either succeeds or blocks indefinitely.
6421642577SAlfred Perlstein.Sh AUTHORS
65571dba6eSHiten PandyaThis manual page was written by
668a7314fcSBaptiste Daroussin.An Chad David Aq Mt davidc@acns.ab.ca .
67