From c4ac1bc4e4ee464a6a384616d3b49ab3c7b2f7ef Mon Sep 17 00:00:00 2001
From: Michael Kerrisk <mtk.manpages@gmail.com>
Date: Fri, 12 May 2006 19:35:05 +0000
Subject: [PATCH] Added section describing relationship between library
 interfaces and system calls. Added SEE ALSO referring to new mq_getsetattr.2.

---
 man7/mq_overview.7 | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/man7/mq_overview.7 b/man7/mq_overview.7
index 5678aec9e..ba59c70b5 100644
--- a/man7/mq_overview.7
+++ b/man7/mq_overview.7
@@ -84,6 +84,28 @@ On Linux,
 returns 32768, but POSIX.1-2001 only requires
 an implementation to support priorities in the range 0 to 31;
 some implementations only provide this range.
+.SS Library interfaces and system calls
+In most cases the
+.B mq_*()
+library interfaces listed above are implemented
+on top of underlying system calls of the same name.
+Deviations from this scheme are indicated in the following table:
+.in +0.25i
+.TS
+lB lB
+l l.
+Library interface	System call
+mq_close(3)	close(2)
+mq_getattr(3)	mq_getsetattr(2)
+mq_open(3)	mq_open(2)
+mq_receive(3)	mq_timedreceive(2)
+mq_send(3)	mq_timedsend(2)
+mq_setattr(3)	mq_getsetattr(2)
+mq_timedreceive(3)	mq_timedreceive(2)
+mq_timedsend(3)	mq_timedsend(2)
+mq_unlink(3)	mq_unlink(2)
+.TE
+.in -0.25i
 .SH LINUX SPECIFIC DETAILS
 .SS Versions
 POSIX message queues have been supported on Linux since kernel 2.6.6.