Tue Jun 14 07:49:09 2011 UTC ()
Mark up NULL.


(wiz)
diff -r1.53 -r1.54 src/share/man/man9/vnode.9
cvs diff -r1.53 -r1.54 src/share/man/man9/vnode.9 (expand / switch to unified diff)

--- src/share/man/man9/vnode.9 2011/06/14 00:56:02 1.53
+++ src/share/man/man9/vnode.9 2011/06/14 07:49:09 1.54
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: vnode.9,v 1.53 2011/06/14 00:56:02 rmind Exp $ 1.\" $NetBSD: vnode.9,v 1.54 2011/06/14 07:49:09 wiz Exp $
2.\" 2.\"
3.\" Copyright (c) 2001, 2005, 2006 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2001, 2005, 2006 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Gregory McGarry. 7.\" by Gregory McGarry.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -588,31 +588,35 @@ An error is returned if the file system  @@ -588,31 +588,35 @@ An error is returned if the file system
588.Pp 588.Pp
589The argument 589The argument
590.Fa tag 590.Fa tag
591is the vnode tag assigned to 591is the vnode tag assigned to
592.Fa *vpp-\*[Gt]v_tag . 592.Fa *vpp-\*[Gt]v_tag .
593The argument 593The argument
594.Fa vops 594.Fa vops
595is the vnode operations vector of the file system requesting the new 595is the vnode operations vector of the file system requesting the new
596vnode. 596vnode.
597If a vnode is successfully retrieved zero is returned, otherwise an 597If a vnode is successfully retrieved zero is returned, otherwise an
598appropriate error code is returned. 598appropriate error code is returned.
599If 599If
600.Fa slock 600.Fa slock
601is not NULL, it specifies the lock to share for 601is not
 602.Dv NULL ,
 603it specifies the lock to share for
602.Em v_interlock . 604.Em v_interlock .
603The reference will be held on the lock and sharing noted. 605The reference will be held on the lock and sharing noted.
604Reference will be released and lock unshared when the vnode gets recycled. 606Reference will be released and lock unshared when the vnode gets recycled.
605If NULL (regular case), vnode will use its own interlock. 607If
 608.Dv NULL
 609(regular case), vnode will use its own interlock.
606.It Fn ungetnewvnode "vp" 610.It Fn ungetnewvnode "vp"
607Undo the operation of 611Undo the operation of
608.Fn getnewvnode . 612.Fn getnewvnode .
609The argument 613The argument
610.Fa vp 614.Fa vp
611is the vnode to return to the freelist. 615is the vnode to return to the freelist.
612This function is needed for 616This function is needed for
613.Xr VFS_VGET 9 617.Xr VFS_VGET 9
614which may need to push back a vnode in case of a locking race 618which may need to push back a vnode in case of a locking race
615condition. 619condition.
616.It Fn vrecycle "vp" "inter_lkp" "l" 620.It Fn vrecycle "vp" "inter_lkp" "l"
617Recycle the unused vnode 621Recycle the unused vnode
618.Fa vp 622.Fa vp
@@ -622,27 +626,29 @@ is a null operation if the reference cou @@ -622,27 +626,29 @@ is a null operation if the reference cou
622.It Fn vgone "vp" 626.It Fn vgone "vp"
623Eliminate all activity associated with the unlocked vnode 627Eliminate all activity associated with the unlocked vnode
624.Fa vp 628.Fa vp
625in preparation for recycling. 629in preparation for recycling.
626.It Fn vgonel "vp" "p" 630.It Fn vgonel "vp" "p"
627Eliminate all activity associated with the locked vnode 631Eliminate all activity associated with the locked vnode
628.Fa vp 632.Fa vp
629in preparation for recycling. 633in preparation for recycling.
630.It Fn vflush "mp" "skipvp" "flags" 634.It Fn vflush "mp" "skipvp" "flags"
631Remove any vnodes in the vnode table belonging to mount point 635Remove any vnodes in the vnode table belonging to mount point
632.Fa mp . 636.Fa mp .
633If 637If
634.Fa skipvp 638.Fa skipvp
635is not NULL it is exempt from being flushed. 639is not
 640.Dv NULL
 641it is exempt from being flushed.
636The argument 642The argument
637.Fa flags 643.Fa flags
638is a set of flags modifying the operation of 644is a set of flags modifying the operation of
639.Fn vflush . 645.Fn vflush .
640If FORCECLOSE is not specified, there should not be any active vnodes and 646If FORCECLOSE is not specified, there should not be any active vnodes and
641the error 647the error
642.Er EBUSY 648.Er EBUSY
643is returned if any are found (this is a user error, not a system error). 649is returned if any are found (this is a user error, not a system error).
644If FORCECLOSE is specified, active vnodes that are found are detached. 650If FORCECLOSE is specified, active vnodes that are found are detached.
645If WRITECLOSE is set, only flush out regular file vnodes open for 651If WRITECLOSE is set, only flush out regular file vnodes open for
646writing. 652writing.
647SKIPSYSTEM causes any vnodes marked V_SYSTEM to be skipped. 653SKIPSYSTEM causes any vnodes marked V_SYSTEM to be skipped.
648.It Fn vaccess "type" "file_mode" "uid" "gid" "acc_mode" "cred" 654.It Fn vaccess "type" "file_mode" "uid" "gid" "acc_mode" "cred"