xref: /freebsd/share/man/man9/getnewvnode.9 (revision 571dba6ec9f25ecf7582dc2192daf1ceea70065f)
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.\"
2721642577SAlfred Perlstein.\" $FreeBSD$
2821642577SAlfred Perlstein.\"
2921642577SAlfred Perlstein.Dd November 21, 2001
3021642577SAlfred Perlstein.Dt GETNEWVNODE 9
3121642577SAlfred Perlstein.Os
3221642577SAlfred Perlstein.Sh NAME
3321642577SAlfred Perlstein.Nm getnewvnode
3421642577SAlfred Perlstein.Nd "get a new vnode"
3521642577SAlfred Perlstein.Sh SYNOPSIS
3621642577SAlfred Perlstein.In sys/param.h
3721642577SAlfred Perlstein.In sys/vnode.h
3821642577SAlfred Perlstein.In sys/mount.h
3921642577SAlfred Perlstein.Ft int
408c330803SNate Lawson.Fn getnewvnode "const char *tag" "struct mount *mp" "vop_t **vops" "struct vnode **vpp"
4121642577SAlfred Perlstein.Sh DESCRIPTION
4221642577SAlfred PerlsteinThe
4321642577SAlfred Perlstein.Fn getnewvnode
4421642577SAlfred Perlsteinfunction initializes a new vnode, assigning it the vnode operations passed in
4521642577SAlfred Perlstein.Fa vops .
4621642577SAlfred PerlsteinThe vnode is either freshly allocated, or taken from the head of the
4721642577SAlfred Perlsteinfree list depending on the number of vnodes already in the system.
4821642577SAlfred Perlstein.Pp
4921642577SAlfred PerlsteinThe arguments to
5021642577SAlfred Perlstein.Fn getnewvnode
5121642577SAlfred Perlsteinare:
5221642577SAlfred Perlstein.Bl -tag -width ".Fa vops"
5321642577SAlfred Perlstein.It Fa tag
548723b451SNate LawsonThe file system type string.
558723b451SNate LawsonThis field should only be referenced for debugging or for userland utilities.
5621642577SAlfred Perlstein.It Fa mp
5721642577SAlfred PerlsteinThe mount point to add the new vnode to.
5821642577SAlfred Perlstein.It Fa vops
5921642577SAlfred PerlsteinThe vnode operations to assign to the new vnode.
6021642577SAlfred Perlstein.It Fa vpp
6121642577SAlfred PerlsteinPoints to the new vnode upon successful completion.
6221642577SAlfred Perlstein.El
6321642577SAlfred Perlstein.Sh RETURN VALUES
6421642577SAlfred Perlstein.Fn getnewvnode
6521642577SAlfred Perlsteinreturns 0 on success.
6621642577SAlfred PerlsteinThere are currently no failure conditions - that do not result in a panic.
6721642577SAlfred Perlstein.Sh AUTHORS
68571dba6eSHiten PandyaThis manual page was written by
6921642577SAlfred Perlstein.An Chad David Aq davidc@acns.ab.ca .
70