document ml_hdatalen and mq_hdatalen

2 files changed, 24 insertions, 4 deletions

diff --git a/share/man/man9/ml_init.9 b/share/man/man9/ml_init.9
index c9a0ec95761..d0e92563ed4 100644
--- a/share/man/man9/ml_init.9
+++ b/share/man/man9/ml_init.9
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: ml_init.9,v 1.13 2016/04/15 05:05:21 dlg Exp $
+.\"     $OpenBSD: ml_init.9,v 1.14 2020/01/22 22:57:42 dlg Exp $
 .\"
 .\"  Copyright (c) 2015 David Gwynne <dlg@openbsd.org>
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: April 15 2016 $
+.Dd $Mdocdate: January 22 2020 $
 .Dt ML_INIT 9
 .Os
 .Sh NAME
@@ -25,6 +25,7 @@
 .Nm ml_dechain ,
 .Nm ml_len ,
 .Nm ml_empty ,
+.Nm ml_hdatalen ,
 .Nm ml_purge ,
 .Nm MBUF_LIST_INITIALIZER ,
 .Nm MBUF_LIST_FIRST ,
@@ -48,6 +49,8 @@
 .Ft int
 .Fn ml_empty "struct mbuf_list *ml"
 .Ft unsigned int
+.Fn ml_hdatalen "struct mbuf_list *ml"
+.Ft unsigned int
 .Fn ml_purge "struct mbuf_list *ml"
 .Ft struct mbuf_list
 .Fn MBUF_LIST_INITIALIZER
@@ -103,6 +106,10 @@ mbuf list.
 Return if the
 .Fa ml
 mbuf list is empty.
+.It Fn ml_hdatalen "struct mbuf_list *ml"
+Return the number of bytes in the packet at the head of the
+.Fa ml
+mbuf list.
 .It Fn ml_purge "struct mbuf_list *ml"
 Free all the mbufs on the
 .Fa ml
@@ -158,6 +165,9 @@ returns the number of mbufs on the list.
 .Fn ml_empty
 return a non-zero value if the list is empty, otherwise 0.
 .Pp
+.Fn ml_hdatalen
+returns the size of a packet on the list, or 0 if the list is empty;
+.Pp
 .Fn ml_purge
 returns the number of mbufs that were freed.
 .Pp
diff --git a/share/man/man9/mq_init.9 b/share/man/man9/mq_init.9
index 58acf26b344..b9ac22c524b 100644
--- a/share/man/man9/mq_init.9
+++ b/share/man/man9/mq_init.9
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: mq_init.9,v 1.9 2018/02/09 02:26:33 patrick Exp $
+.\"     $OpenBSD: mq_init.9,v 1.10 2020/01/22 22:57:42 dlg Exp $
 .\"
 .\"  Copyright (c) 2015 David Gwynne <dlg@openbsd.org>
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: February 9 2018 $
+.Dd $Mdocdate: January 22 2020 $
 .Dt MQ_INIT 9
 .Os
 .Sh NAME
@@ -27,6 +27,7 @@
 .Nm mq_len ,
 .Nm mq_empty ,
 .Nm mq_full ,
+.Nm mq_hdatalen ,
 .Nm mq_purge ,
 .Nm mq_drops ,
 .Nm mq_set_maxlen ,
@@ -53,6 +54,8 @@
 .Ft int
 .Fn mq_full "struct mbuf_queue *mq"
 .Ft unsigned int
+.Fn mq_hdatalen "struct mbuf_queue *mq"
+.Ft unsigned int
 .Fn mq_purge "struct mbuf_queue *mq"
 .Ft unsigned int
 .Fn mq_drops "struct mbuf_queue *mq"
@@ -142,6 +145,10 @@ mbuf queue is empty.
 Return if the
 .Fa mq
 mbuf queue is full.
+.It Fn mq_hdatalen "struct mbuf_queue *mq"
+Return the number of bytes in the packet at the head of the
+.Fa mq
+mbuf queue.
 .It Fn mq_purge "struct mbuf_queue *mq"
 Free all the mbufs on the
 .Fa mq
@@ -209,6 +216,9 @@ length.
 returns the number of mbufs that were dropped from the list if the
 length of the queue exceeded its maximum length.
 .Pp
+.Fn mq_hdatalen
+returns the size of a packet on the queue, or 0 if the queue is empty;
+.Pp
 .Fn mq_purge
 returns the number of mbufs that were freed.
 .Pp