summaryrefslogtreecommitdiffstats
path: root/share/man/man9/malloc.9
diff options
context:
space:
mode:
authoralfred <alfred@FreeBSD.org>2003-01-18 19:51:52 +0000
committeralfred <alfred@FreeBSD.org>2003-01-18 19:51:52 +0000
commit1cdda66e6834c2a73abc46ec14f5fc872bb63541 (patch)
tree3bc9f8057d90bb3efa168ae9786b96d282f2f0d1 /share/man/man9/malloc.9
parenta18d0c206fb2bbd4eea394e1fd13aada1e17a155 (diff)
downloadFreeBSD-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/malloc.9')
-rw-r--r--share/man/man9/malloc.916
1 files changed, 16 insertions, 0 deletions
diff --git a/share/man/man9/malloc.9 b/share/man/man9/malloc.9
index 6013897..edfccb3 100644
--- a/share/man/man9/malloc.9
+++ b/share/man/man9/malloc.9
@@ -240,8 +240,24 @@ of two for requests up to the size of a page of memory.
For larger requests, one or more pages is allocated.
While it should not be relied upon, this information may be useful for
optimizing the efficiency of memory use.
+.Pp
+Malloc flags documented above should
+.Em NOT
+be used with
+.Xr mbuf 9
+routines as it will cause undesired results.
+.Pp
+Any calls to
+.Fn malloc
+or
+.Fn free
+when holding a
+.Xr vnode 9
+interlock, will cause a LOR (Lock Order Reversal) due to the
+interwining of VM Objects and Vnodes.
.Sh SEE ALSO
.Xr vmstat 8
+.Xr vnode 9
.Sh DIAGNOSTICS
A kernel compiled with the
.Dv DIAGNOSTIC
OpenPOWER on IntegriCloud