diff options
author | alfred <alfred@FreeBSD.org> | 2003-01-18 19:51:52 +0000 |
---|---|---|
committer | alfred <alfred@FreeBSD.org> | 2003-01-18 19:51:52 +0000 |
commit | 1cdda66e6834c2a73abc46ec14f5fc872bb63541 (patch) | |
tree | 3bc9f8057d90bb3efa168ae9786b96d282f2f0d1 /share/man/man9/vnode.9 | |
parent | a18d0c206fb2bbd4eea394e1fd13aada1e17a155 (diff) | |
download | FreeBSD-src-1cdda66e6834c2a73abc46ec14f5fc872bb63541.zip FreeBSD-src-1cdda66e6834c2a73abc46ec14f5fc872bb63541.tar.gz |
Document lock order reversals possible when calling allocation functions
with vnode interlocks held.
Emphasize that users need to be careful with malloc flags versus mbuf
flags.
Remove stale portion in vnode.9 about v_tag. We don't have it anylonger.
Submitted by: Hiten Pandya <hiten@unixdaemons.com>
Diffstat (limited to 'share/man/man9/vnode.9')
-rw-r--r-- | share/man/man9/vnode.9 | 26 |
1 files changed, 12 insertions, 14 deletions
diff --git a/share/man/man9/vnode.9 b/share/man/man9/vnode.9 index dc163f2..023e6f3 100644 --- a/share/man/man9/vnode.9 +++ b/share/man/man9/vnode.9 @@ -45,18 +45,6 @@ enum vtype { VNON, VREG, VDIR, VBLK, VCHR, VLNK, VSOCK, VFIFO, VBAD }; /* - * Vnode tag types. - * These are for the benefit of external programs only (e.g., pstat) - * and should NEVER be inspected by the kernel. - */ -enum vtagtype { - VT_NON, VT_UFS, VT_NFS, VT_UNUSED, VT_PC, VT_LFS, VT_LOFS, VT_FDESC, - VT_PORTAL, VT_NULL, VT_UMAP, VT_KERNFS, VT_PROCFS, VT_AFS, VT_ISOFS, - VT_UNION, VT_MSDOSFS, VT_DEVFS, VT_TFS, VT_VFS, VT_CODA, VT_NTFS, - VT_HPFS, VT_NWFS, VT_PSEUDOFS -}; - -/* * Each underlying file system allocates its own private area and hangs * it from v_data. If non-null, this area is freed in getnewvnode(). */ @@ -105,7 +93,7 @@ struct vnode { struct vm_object *v_object; /* Place to store VM object */ struct simplelock v_interlock; /* lock on usecount and flag */ struct lock *v_vnlock; /* used for non-locking fs's */ - enum vtagtype v_tag; /* type of underlying data */ + const char *v_tag; /* type of underlying data */ void *v_data; /* private data for fs */ LIST_HEAD(, namecache) v_cache_src; /* Cache entries from us */ TAILQ_HEAD(, namecache) v_cache_dst; /* Cache entries to us */ @@ -241,7 +229,7 @@ A FIFO (named pipe). Advisory locking won't work on this. .It Dv VBAD An old style bad sector map .El -.Sh NOTES +.Sh IMPLEMENTATION NOTES VFIFO uses the "struct fileops" from .Pa /sys/kern/sys_pipe.c . VSOCK uses the "struct fileops" from @@ -252,7 +240,17 @@ Everything else uses the one from The VFIFO/VSOCK code, which is why "struct fileops" is used at all, is an artifact of an incomplete integration of the VFS code into the kernel. +.Pp +Calls to +.Xr malloc 9 +or +.Xr free 9 +when holding a +.Nm +interlock, will cause a LOR (Lock Order Reversal) due to the +interwining of VM Objects and Vnodes. .Sh SEE ALSO +.Xr malloc 9 .Xr VFS 9 .Sh AUTHORS This man page was written by |