1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
|
.\" Copyright 1993 Giorgio Ciucci (giorgio@crcc.it)
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date. The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein. The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified Tue Oct 22 08:11:14 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>
.TH MSGCTL 2 "1 de Noviembre de 1993" "Linux 0.99.13" "Manual del Programador de Linux"
.SH NOMBRE
msgctl \- operaciones para el control de mensajes
.SH SINTAXIS
.nf
.B
# include <sys/types.h>
.B
# include <sys/ipc.h>
.B
# include <sys/msg.h>
.fi
.sp
.BI "int msgctl ( int " msqid ",
.BI "int " cmd ,
.BI "struct msqid_ds *" buf " )"
.SH DESCRIPCIN
La funcion ejecuta la operacion especificada por
.I cmd
en la cola de mensajes con el identificador
.IR msqid .
Valores legales para
.I cmd
son:
.TP 12
.B IPC_STAT
Copia informacion desde la estructura de datos mensaje
en la estructura apuntada por
.IR buf .
El usuario debe tener permiso de lectura en la cola de mensajes.
.TP
.B IPC_SET
Escribe los valores de algunos miembros de la estructura
.B msqid_ds
apuntada por
.I buf
a la estructura de datos cola de mensajes, actualizando su componente
.B msg_ctime
Los componentes considerados de la estructura del usuario
.B "struct msqid_ds"
apuntados por
.I buf
son
.nf
.sp
.ft B
msg_perm.uid
msg_perm.gid
msg_perm.mode \fR/* solo los 9 bits mas bajos */\fP
msg_qbytes
.fi
.ft R
.sp
El identificador de usuario del proceso debe ser al menos super\-usuario,
creador o propietario de la cola de mensajes.
Solo de super\-usuario puede superar el valor
.B msg_qbytes
por encima del valor del sistema
.BR MSGMNB.
.TP
.B IPC_RMID
Elimina la cola de mensajes y sus estructuras de datos despertando a
todos los procesos en espera de lectura o escritura (con un valor de error
retornado y
.B errno
fijado a
.BR EIDRM ).
El identificador de usuario del proceso invocador debe ser al menos
super\-usuario, creador o propietario de la cola de mensajes.
.SH "VALOR DEVUELTO"
Si ha funcionado, el valor devuelto sera
.BR 0 ,
en otro caso
.B \-1
con
.B errno
indicando el error
.SH ERRORES
Ante un error
.B errno
sera fijado a uno de los siguientes valores:
.TP 11
.B EACCES
El argumento
.I cmd
es igual a
.B IPC_STAT
pero el proceso invocador no tiene permisos de lectura sobre la cola de mensajes
.IR msqid.
.TP
.B EFAULT
El argumento
.I cmd
tiene el valor
.B IPC_SET
o
.B IPC_STAT
pero la direccion apuntada por
.I buf
no es accesible.
.TP
.B EIDRM
La cola de mensajes ha sido eliminada.
.TP
.B EINVAL
Valor incorrecto de
.I cmd
o
.IR msqid .
.TP
.B EPERM
El argumento
.I cmd
tiene el valor
.B IPC_SET
o
.B IPC_RMID
pero el identificador de usuario efectivo del proceso no tiene suficientes
privilegios para ejecutar el comando.
Este tambien es el caso para un proceso no perteneciente al super\-usuario
intentando incrementar el valor de
.B msg_qbytes
por encima del valor espeficicado por el parametro del sistema
.BR MSGMNB .
.SH NOTAS
Las llamadas
.BR IPC_INFO ,
.BR MSG_STAT
y
.B MSG_INFO
son utilizadas por el programa
.BR ipcs (8)
a fin de proveer informacion de los recursos asignados.
En el futuro esto puede ser modificado segun las necesitades o trasladado al
interfaz /proc.
.SH "COMPATIBLE CON"
SVr4, SVID. SVID no documenta el error EIDRM.
.SH "VER TAMBIN"
.BR ipc (5),
.BR msgget (2),
.BR msgsnd (2),
.BR msgrcv (2).
|
