From 3fdcc957db60880f922ff538b2e4687af7d46509 Mon Sep 17 00:00:00 2001 From: rwatson Date: Sat, 18 Jan 2003 03:25:40 +0000 Subject: Caution programmers not to confuse M_DONTWAIT with M_NOWAIT. They are not the same. Suggested by: Hiten Pandya --- share/man/man9/malloc.9 | 11 +++++++++++ share/man/man9/mbuf.9 | 8 ++++++++ 2 files changed, 19 insertions(+) (limited to 'share') diff --git a/share/man/man9/malloc.9 b/share/man/man9/malloc.9 index ff07220..6013897 100644 --- a/share/man/man9/malloc.9 +++ b/share/man/man9/malloc.9 @@ -159,6 +159,17 @@ is defined to be 0, meaning that blocking operation is the default. Also note that .Dv M_NOWAIT is required when running in an interrupt context. +.Pp +Programmers should be careful not to confuse +.Dv M_NOWAIT , +the +.Fn malloc +flag, with +.Dv M_DONTWAIT , +an +.Xr mbuf 9 +allocation flag, which is not a valid argument to +.Fn malloc . .It Dv M_WAITOK Indicates that it is Ok to wait for resources. It is unconveniently defined as 0 so care should be taken never to compare against this value diff --git a/share/man/man9/mbuf.9 b/share/man/man9/mbuf.9 index 6472289..b10e6ea 100644 --- a/share/man/man9/mbuf.9 +++ b/share/man/man9/mbuf.9 @@ -295,6 +295,14 @@ number of ticks. A number of other mbuf-related functions and macros have the same argument because they may at some point need to allocate new mbufs. +.Pp +Programmers should be careful not to confuse the mbuf allocation flag +.Dv M_DONTWAIT +with the +.Xr malloc 9 +allocation flag, +.Dv M_NOWAIT . +They are not the same. .It Fn MGETHDR mbuf how type Allocate an mbuf and initialize it to contain a packet header and internal data. -- cgit v1.1