.\" 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.
.\"
.\" Translated Sat Jul  6 15:29:23 1996 by Diego Novillo (diego@cs.ualberta.ca)
.\"
.\" Revised Thu May 21 00:57:02 1998 by
.\"    Rafael Godnez (1ragodin@rigel.deusto.es)
.TH IPC 5 "1 Noviembre 1993" "Linux 0.99.13" "Manual del Programador de Linux" 
.SH NOMBRE
ipc \- Mecanismos de comunicacin entre procesos del System V
.SH SINOPSIS
.nf
.B
# include <sys/types.h>
.B
# include <sys/ipc.h>
.B
# include <sys/msg.h>
.B
# include <sys/sem.h>
.B
# include <sys/shm.h>
.SH DESCRIPCIN
Esta pgina del manual hace referencia a la implementacin en Linux de los
mecanismos de comunicacin entre procesos del System V (IPC, InterProcess
Communication): colas de mensajes, conjuntos de semforos y segmentos de
memoria compartida.
En la siguiente descripcin, la palabra
.B recurso
se refiere a la instancia de uno de dichos mecanismos.
.SS Permisos de Acceso a Recursos
Para cada recurso el sistema utiliza una estructura de datos comn de tipo
.BR "struct ipc_perm"
para almacenar informacin necesaria para determinar permisos al ejecutar
una operacin ipc.
La estructura
.BR ipc_perm ,
definida en el fichero de cabecera
.I <sys/ipc.h>
incluye los siguientes miembros:
.sp
.B
	ushort cuid;	
/* id del usuario creador */
.br
.B
	ushort cgid;	
/* id de grupo del usuario creador */
.br
.B
	ushort uid;
/* id del usuario dueo */
.br
.B
	ushort gid;
/* id de grupo del usuario dueo */
.br
.B
	ushort mode;
/* permisos de lectura/escritura */
.PP
El miembro
.B mode
de la estructura
.B ipc_perm
define, con los 9 bits ms bajos, los persmisos de acceso al recurso para
cualquier proceso que realice una llamada ipc al sistema.  Los permisos se
interpretan de la siguiente manera:
.sp
.nf
	0400	Lectura para el usuario.
	0200	Escritura para el usuario.
.sp .5
	0040	Lectura para el grupo.
	0020	Escritura para el grupo.
.sp .5
	0004	Lectura para otros.
	0002	Escritura para otros.
.fi
.PP
Los bits 0100, 0010 y 0001 (bits de ejecucin) no se utilizan.
Adems,
"write" (permiso de escritura)
se interpreta efectivamente como
"alter" (permiso de alteracin)
para un conjunto de semforos.
.PP
El mismo fichero de cabecera del sistema tambin define las siguientes
constantes simblicas:
.TP 14
.B IPC_CREAT
Crea la entrada si la clave no existe.
.TP
.B IPC_EXCL
Falla si la clave existe.
.TP
.B IPC_NOWAIT
Devuelve error si la peticin debe esperar.
.TP
.B IPC_PRIVATE
Clave privada.
.TP
.B IPC_RMID
Elimina el recurso.
.TP
.B IPC_SET
Establece opciones del recurso.
.TP
.B IPC_STAT
Obtiene opciones del recurso.
.PP
Ntese que 
.B IPC_PRIVATE
es de tipo
.B key_t, 
mientras que las otras constantes simblicas son campos sealizadores que
pueden combinarse usando operaciones 'or' en una variable de tipo
.BR int .
.SS Colas de Mensajes
Una cola de mensajes se identifica unvocamente usando un nmero entero
positivo 
.RI "(llamado " msqid )
y tiene una estructura de datos asociada de tipo
.BR "struct msquid_ds" ,
definida en
.IR <sys/msg.h> .
La estructura contiene los siguientes miembros:
.sp
.B
	struct ipc_perm msg_perm;
.br
.B
	ushort msg_qnum; 
/* nmero de mensajes en cola */
.br
.B
	ushort msg_qbytes; 
/* mximo nmero de bytes en cola */
.br
.B
	ushort msg_lspid; 
/* pid ltima llamada a msgsnd */
.br
.B
	ushort msg_lrpid; 
/* pid ltima llamada a msgrcv */
.br
.B
	time_t msg_stime; 
/* hora ltima llamada a msgsnd */
.br
.B
	time_t msg_rtime; 
/* hora ltima llamada a msgrcv */
.br
.B
	time_t msg_ctime; 
/* hora del ltimo cambio */
.TP 11
.B msg_perm
.B ipc_perm
estructura que especifica los permisos de acceso a la cola de mensajes.
.TP
.B msg_qnum
Nmero actual de mensajes en la cola de mensajes.
.TP
.B msg_qbytes
Mximo nmero de bytes permitidos en el texto del mensaje en la cola de
mensajes.
.TP
.B msg_lspid
ID del proceso que ejecut la ltima llamada a
.BR msgsnd .
.TP
.B msg_lrpid
ID del proceso que ejecut la ltima llamada a
.BR msgrcv .
.TP
.B msg_stime
Hora de la ltima llamada a
.BR msgsnd .
.TP
.B msg_rtime
Hora de la ltima llamada a
.BR msgrcv .
.TP
.B msg_ctime
Hora de la ltima llamada que cambi un miembro de la estructura
.BR msqid_ds .
.SS Conjuntos de Semforos
Un conjunto de semforos se identifica unvocamente usando un nmero entero
positivo 
.RI "(llamado " semid )
y tiene asociada la siguiente estructura de datos de tipo
.BR "struct semid_ds" ,
definida en
.IR <sys/sem.h> .
La estructura contiene los siguientes campos:
.sp
.B
	struct ipc_perm sem_perm;
.br
.B
	time_t sem_otime; 
/* hora de la ltima operacin */
.br
.B
	time_t sem_ctime; 
/* hora del ltimo cambio */
.br
.B
	ushort sem_nsems; 
/* cantidad de semforos en el conjunto */
.TP 11
.B sem_perm
.B ipc_perm
estructura que especifica los permisos de acceso al conjunto de semforos.
.TP
.B sem_otime
Hora de la ltima llamada a
.B semop.
.TP
.B sem_ctime
Hora de la ltima llamada a
.B semctl
que cambi un miembro de la estructura anterior o un miembro de algn
semforo del conjunto.
.TP
.B sem_nsems
Cantidad de semforos en el conjunto.
Cada semforo en el conjunto se accede usando un entero positivo en el
rango
.B 0
a
.BR sem_nsems\-1 .
.PP
Un semforo es una estructura de datos de tipo
.B "struct sem"
que contiene los siguientes miembros:
.TP 21
.B
	ushort semval; 
/* valor del semforo */
.TP
.B
	short sempid; 
/* pid para la ltima operacin */
.TP
.B
	ushort semncnt; 
/* cantidad de semval esperando a ser incrementados */
.TP
.B
	ushort semzcnt; 
/* cantidad de semforos esperando cuyo semval = 0 */
.PP
.TP 11
.B semval
Valor del semforo: un entero no negativo.
.TP
.B sempid
ID del ltimo proceso que realiz una operacin de semforo sobre este
semforo.
.TP
.B semncnt
Cantidad de procesos suspendidos esperando que 
.B semval
aumente.
.TP
.B semznt
Cantidad de procesos suspendidos esperando que
.B semval
se haga cero.
.SS Segmentos de Memoria Compartida
Un segmento de memoria compartida se identifica unvocamente mediante un
nmero entero positivo
.RI "(llamado " shmid )
y tiene una estructura de datos asociada de tipo
.BR "struct shmid_ds" ,
definida en
.IR <sys/shm.h> .
La estructura contiene los siguiente miembros:
.sp
.B
	struct ipc_perm shm_perm;
.br
.B
	int shm_segsz;		
/* Tamao del segmento */
.br
.B
	ushort shm_cpid;	
/* pid del creador */
.br
.B
	ushort shm_lpid;	
/* pid de la ltima operacin */
.br
.B
	short shm_nattch;	
/* cantidad actual de conexiones */
.br
.B
	time_t shm_atime;	
/* hora de la ltima conexion */
.br
.B
	time_t shm_dtime;	
/* hora ltima desconexin */
.br
.B
	time_t shm_ctime;	
/* hora del ltimo cambio */
.TP 11
.B shm_perm
.B ipc_perm
estructura que especifica los permisos de acceso al segmento de memoria
compartida.
.TP
.B shm_segsz
Tamao en bytes del segmento de memoria compartida.
.TP
.B shm_cpid
ID del proceso que creo el segmento de memoria compartida.
.TP
.B shm_lpid
ID del ltimo proceso que ejecut una llamada del sistema
.B shmat
o
.BR shmdt .
.TP
.B shm_nattch
Cantidad de conexiones activas actualmente para este segmento de memoria
compartida.
.TP
.B shm_atime
Hora de la ltima llamada a
.BR shmat .
.TP
.B shm_dtime
Hora de la ltima llamada a 
.BR shmdt .
.TP
.B shm_ctime
Hora de la ltima llamada a 
.B shmctl
que cambi
.BR shmid_ds .
.SH "VASE TAMBIN"
.BR ftok (3),
.BR msgctl (2),
.BR msgget (2),
.BR msgrcv (2),
.BR msgsnd (2),
.BR semctl (2),
.BR semget (2),
.BR semop (2),
.BR shmat (2),
.BR shmctl (2),
.BR shmget (2),
.B shmdt (2).