Retire ml_requeue(9) and mq_requeue(9).

As Kenjiro Cho pointed out it is very hard to cancel a dequeue operation
for some queueing disciplines when such it keeps some internal states.

As you can see, APIs can also Live Fast & Die Young.

ok dlg@

1 files changed, 1 insertions, 15 deletions

diff --git a/share/man/man9/ml_init.9 b/share/man/man9/ml_init.9
index 6f843aeedd9..626da25450e 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.9 2015/11/21 00:32:46 dlg Exp $
+.\"     $OpenBSD: ml_init.9,v 1.10 2015/11/21 11:46:24 mpi Exp $
 .\"
 .\"  Copyright (c) 2015 David Gwynne <dlg@openbsd.org>
 .\"
@@ -21,7 +21,6 @@
 .Nm ml_init ,
 .Nm ml_enqueue ,
 .Nm ml_dequeue ,
-.Nm ml_requeue ,
 .Nm ml_enlist ,
 .Nm ml_dechain ,
 .Nm ml_len ,
@@ -40,8 +39,6 @@
 .Ft struct mbuf *
 .Fn ml_dequeue "struct mbuf_list *ml"
 .Ft void
-.Fn ml_requeue "struct mbuf_list *ml" "struct mbuf *m"
-.Ft void
 .Fn ml_enlist "struct mbuf_list *ml" "struct mbuf_list *src"
 .Ft struct mbuf *
 .Fn ml_dechain "struct mbuf_list *ml"
@@ -76,10 +73,6 @@ Insertion of a new mbuf at the end of the list.
 .It
 Removal of an mbuf from the head of the list.
 .It
-Reinsertion of an mbuf at the head of the list.
-.It
-Removal of the entire chain of mbufs on the list.
-.El
 .Bl -tag -width Ds
 .It Fn ml_init "struct mbuf_list *ml"
 Initialise the
@@ -97,12 +90,6 @@ mbuf list.
 Dequeue an mbuf from the front of the
 .Fa ml
 mbuf list.
-.It Fn ml_requeue "struct mbuf_list *ml" "struct mbuf *m"
-Enqueue mbuf
-.Fa m
-at the head of the
-.Fa ml
-mbuf list.
 .It Fn ml_enlist "struct mbuf_list *ml" "struct mbuf_list *src"
 Enqueue all the mbufs on the
 .Fa src
@@ -164,7 +151,6 @@ Note that it is unsafe to modify the list while iterating over it.
 .Fn ml_init ,
 .Fn ml_enqueue ,
 .Fn ml_dequeue ,
-.Fn ml_requeue ,
 .Fn ml_enlist ,
 .Fn ml_dechain ,
 .Fn ml_len ,