Document recently-implemented m_getm().

This commit is contained in:
Bosko Milekic 2001-02-16 03:23:04 +00:00
parent b654e1067b
commit 328c0bbcf7
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=72528

View File

@ -70,6 +70,8 @@
.Ft struct mbuf *
.Fn m_get "int how" "int type"
.Ft struct mbuf *
.Fn m_getm "struct mbuf *orig" "int len" "int how" "int type"
.Ft struct mbuf *
.Fn m_getclr "int how" "int type"
.Ft struct mbuf *
.Fn m_gethdr "int how" "int type"
@ -333,6 +335,26 @@ The functions are:
A function version of
.Fn MGET
for non-critical paths.
.It Fn m_getm orig len how type
Allocate
.Ar len
bytes worth of mbufs and mbuf clusters if necessary and append the resulting
allocated chain to the
.Ar orig
mbuf chain, if it is non-NULL.
If the allocation fails at any point,
free whatever was allocated and return NULL.
If
.Ar orig
is non-NULL,
it will not be freed.
It is possible to use
.Fn m_getm
to either append
.Ar len
bytes to an existing mbuf or mbuf chain
(for example, one which may be sitting in a pre-allocated ring)
or to simply perform an all-or-nothing mbuf and mbuf cluster allocation.
.It Fn m_gethdr how type
A function version of
.Fn MGETHDR