| msgctl.2 (50476) | msgctl.2 (57686) |
|---|---|
| 1.\" $NetBSD: msgctl.2,v 1.1 1995/10/16 23:49:15 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: --- 15 unchanged lines hidden (view full) --- 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.\" | 1.\" $NetBSD: msgctl.2,v 1.1 1995/10/16 23:49:15 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: --- 15 unchanged lines hidden (view full) --- 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.\" |
| 32.\" $FreeBSD: head/lib/libc/gen/msgctl.3 50476 1999-08-28 00:22:10Z peter $ | 32.\" $FreeBSD: head/lib/libc/gen/msgctl.3 57686 2000-03-02 09:14:21Z sheldonh $ |
| 33.\"/ 34.Dd November 24, 1997 35.Dt MSGCTL 3 36.Os FreeBSD 37.Sh NAME 38.Nm msgctl 39.Nd message control operations 40.Sh SYNOPSIS --- 85 unchanged lines hidden (view full) --- 126This operation can only be executed by the super-user, or a process that 127has an effective user id equal to either 128.Va msg_perm.cuid 129or 130.Va msg_perm.uid 131in the data structure associated with the message queue. 132The value of 133.Va msg_qbytes | 33.\"/ 34.Dd November 24, 1997 35.Dt MSGCTL 3 36.Os FreeBSD 37.Sh NAME 38.Nm msgctl 39.Nd message control operations 40.Sh SYNOPSIS --- 85 unchanged lines hidden (view full) --- 126This operation can only be executed by the super-user, or a process that 127has an effective user id equal to either 128.Va msg_perm.cuid 129or 130.Va msg_perm.uid 131in the data structure associated with the message queue. 132The value of 133.Va msg_qbytes |
| 134can only be increased by the super-user. Values for | 134can only be increased by the super-user. 135Values for |
| 135.Va msg_qbytes 136that exceed the system limit (MSGMNB from 137.Aq Pa sys/msg.h ) 138are silently truncated to that limit. 139 140.It Dv IPC_RMID 141Remove the message queue specified by 142.Fa msqid | 136.Va msg_qbytes 137that exceed the system limit (MSGMNB from 138.Aq Pa sys/msg.h ) 139are silently truncated to that limit. 140 141.It Dv IPC_RMID 142Remove the message queue specified by 143.Fa msqid |
| 143and destroy the data associated with it. Only the super-user or a process | 144and destroy the data associated with it. 145Only the super-user or a process |
| 144with an effective uid equal to the 145.Va msg_perm.cuid 146or 147.Va msg_perm.uid 148values in the data structure associated with the queue can do this. 149.El 150 151The permission to read from or write to a message queue (see --- 10 unchanged lines hidden (view full) --- 162field or the 163.Va msg_perm.uid 164field, and the 165effective gid can match either 166.Va msg_perm.cgid 167or 168.Va msg_perm.gid . 169.Sh RETURN VALUES | 146with an effective uid equal to the 147.Va msg_perm.cuid 148or 149.Va msg_perm.uid 150values in the data structure associated with the queue can do this. 151.El 152 153The permission to read from or write to a message queue (see --- 10 unchanged lines hidden (view full) --- 164field or the 165.Va msg_perm.uid 166field, and the 167effective gid can match either 168.Va msg_perm.cgid 169or 170.Va msg_perm.gid . 171.Sh RETURN VALUES |
| 170Upon successful completion, a value of 0 is returned. Otherwise, -1 is | 172Upon successful completion, a value of 0 is returned. 173Otherwise, -1 is |
| 171returned and the global variable 172.Va errno 173is set to indicate the error. 174.Sh ERRORS 175.Fn msgctl 176will fail if: 177.Bl -tag -width Er 178.It Bq Er EPERM --- 32 unchanged lines hidden --- | 174returned and the global variable 175.Va errno 176is set to indicate the error. 177.Sh ERRORS 178.Fn msgctl 179will fail if: 180.Bl -tag -width Er 181.It Bq Er EPERM --- 32 unchanged lines hidden --- |