msgrcv.2 (108087) | msgrcv.2 (131504) |
---|---|
1.\" $NetBSD: msgrcv.2,v 1.1 1995/10/16 23:49:20 jtc Exp $ 2.\" 3.\" Copyright (c) 1995 Frank van der Linden 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: --- 14 unchanged lines hidden (view full) --- 23.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 24.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 25.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 26.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 27.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 28.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 29.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 30.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | 1.\" $NetBSD: msgrcv.2,v 1.1 1995/10/16 23:49:20 jtc Exp $ 2.\" 3.\" Copyright (c) 1995 Frank van der Linden 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: --- 14 unchanged lines hidden (view full) --- 23.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 24.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 25.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 26.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 27.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 28.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 29.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 30.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
31.\" $FreeBSD: head/lib/libc/gen/msgrcv.3 108087 2002-12-19 09:40:28Z ru $ | 31.\" $FreeBSD: head/lib/libc/gen/msgrcv.3 131504 2004-07-02 23:52:20Z ru $ |
32.\" 33.\"/ 34.Dd November 24, 1997 35.Dt MSGRCV 3 36.Os 37.Sh NAME 38.Nm msgrcv 39.Nd receive a message from a message queue --- 27 unchanged lines hidden (view full) --- 67The value of 68.Fa msgtyp 69has one of the following meanings: 70.Bl -bullet 71.It 72The 73.Fa msgtyp 74argument | 32.\" 33.\"/ 34.Dd November 24, 1997 35.Dt MSGRCV 3 36.Os 37.Sh NAME 38.Nm msgrcv 39.Nd receive a message from a message queue --- 27 unchanged lines hidden (view full) --- 67The value of 68.Fa msgtyp 69has one of the following meanings: 70.Bl -bullet 71.It 72The 73.Fa msgtyp 74argument |
75is greater than 0. The first message of type | 75is greater than 0. 76The first message of type |
76.Fa msgtyp 77will be received. 78.It 79The 80.Fa msgtyp 81argument | 77.Fa msgtyp 78will be received. 79.It 80The 81.Fa msgtyp 82argument |
82is equal to 0. The first message on the queue will be received. | 83is equal to 0. 84The first message on the queue will be received. |
83.It 84The 85.Fa msgtyp 86argument | 85.It 86The 87.Fa msgtyp 88argument |
87is less than 0. The first message of the lowest message type that is | 89is less than 0. 90The first message of the lowest message type that is |
88less than or equal to the absolute value of 89.Fa msgtyp 90will be received. 91.El 92.Pp 93The 94.Fa msgsz 95argument --- 32 unchanged lines hidden (view full) --- 128.It 129A message of the requested type becomes available on the message queue. 130.It 131The message queue is removed, in which case -1 will be returned, and 132.Va errno 133set to 134.Er EINVAL . 135.It | 91less than or equal to the absolute value of 92.Fa msgtyp 93will be received. 94.El 95.Pp 96The 97.Fa msgsz 98argument --- 32 unchanged lines hidden (view full) --- 131.It 132A message of the requested type becomes available on the message queue. 133.It 134The message queue is removed, in which case -1 will be returned, and 135.Va errno 136set to 137.Er EINVAL . 138.It |
136A signal is received and caught. -1 is returned, and | 139A signal is received and caught. 140-1 is returned, and |
137.Va errno 138set to 139.Er EINTR . 140.El 141.Pp 142If a message is successfully received, the data structure associated with 143.Fa msqid 144is updated as follows: --- 74 unchanged lines hidden --- | 141.Va errno 142set to 143.Er EINTR . 144.El 145.Pp 146If a message is successfully received, the data structure associated with 147.Fa msqid 148is updated as follows: --- 74 unchanged lines hidden --- |