svn commit: r280269 - stable/9/share/man/man9

[Mark Johnston]

Author: markj
Date: Thu Mar 19 23:06:45 2015
New Revision: 280269
URL: https://svnweb.freebsd.org/changeset/base/280269

Log:
  MFC r279896:
  Document m_collapse().

Modified:
  stable/9/share/man/man9/mbuf.9
Directory Properties:
  stable/9/share/man/man9/   (props changed)

Modified: stable/9/share/man/man9/mbuf.9
==============================================================================
--- stable/9/share/man/man9/mbuf.9	Thu Mar 19 17:42:38 2015	(r280268)
+++ stable/9/share/man/man9/mbuf.9	Thu Mar 19 23:06:45 2015	(r280269)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd November 13, 2012
+.Dd March 11, 2015
 .Dt MBUF 9
 .Os
 .\"
@@ -136,6 +136,8 @@
 .Ft struct mbuf *
 .Fn m_defrag "struct mbuf *m0" "int how"
 .Ft struct mbuf *
+.Fn m_collapse "struct mbuf *m0" "int how" "int maxfrags"
+.Ft struct mbuf *
 .Fn m_unshare "struct mbuf *m0" "int how"
 .\"
 .Sh DESCRIPTION
@@ -975,6 +977,20 @@ depending on the caller's preference.
 This function is especially useful in network drivers, where
 certain long mbuf chains must be shortened before being added
 to TX descriptor lists.
+.It Fn m_collapse m0 how maxfrags
+Defragment an mbuf chain, returning a chain of at most
+.Fa maxfrags
+mbufs and clusters.
+If allocation fails or the chain cannot be collapsed as requested,
+.Dv NULL
+will be returned, with the original chain possibly modified.
+As with
+.Fn m_defrag ,
+.Fa how
+should be one of
+.Dv M_WAITOK
+or
+.Dv M_NOWAIT .
 .It Fn m_unshare m0 how
 Create a version of the specified mbuf chain whose
 contents can be safely modified without affecting other users.