.\" 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 Sun Nov 28 17:06:19 1993, Rik Faith (faith@cs.unc.edu)
.\"          with material from Luigi P. Bai (lpb@softint.com)
.\" Portions Copyright 1993 Luigi P. Bai
.\" Modified Tue Oct 22 22:04:23 1996 by Eric S. Raymond <esr@thyrsus.com>
.\" Translated into Spanish Wed Jan 28 1998 by Gerardo Aburruzaga Garca
.\" <gerardo.aburruzaga@uca.es> 
.\"
.TH SHMOP 2 "28 Enero 1998" "Linux 0.99.13" "Manual del Programador Linux" 
.SH NOMBRE
shmop \- operaciones cno memoria compartida
.SH SINOPSIS
.nf
.B
# include <sys/types.h>
.B
# include <sys/ipc.h>
.B
# include <sys/shm.h>
.fi
.sp
.BI "char *shmat ( int " shmid ,
.BI "char *" shmaddr ,
.BI "int " shmflg " )"
.sp
.BI "int shmdt ( char *" shmaddr ")"
.SH DESCRIPCIN
La funcin
.B shmat
pega el segmento de memoria compartida identificada por
.B shmid
al segmento de datos del proceso que llama a la funcin.
La direccin del pegado se especifica en
.I shmaddr
segn uno de los criterios siguientes:
.IP
Si
.I shmaddr
es
.BR 0 ,
el sistema intenta encontrar una regin no asociada en el rango de 1 a
1,5 GB comenzando por el valor superior y bajando desde l.
.IP
Si
.I shmaddr
no es
.B 0
y
.B SHM_RND
est activado en
.IR shmflg ,
el pegado ocurre en la direccin igual al redondeo por abajo de
.I shmaddr
a un mltiplo de
.BR SHMLBA .
De otro modo,
.I shmaddr
debe ser una direccin alineada de una pgina en la cual ocurra el pegado.
.PP
Si
.B SHM_RDONLY
est activado en
.IR shmflg ,
el segmento se pega para lectura y el proceso debe tener permiso de
lectura en el segmento.
De otro modo el segmento se pega para lectura y escritura y debe tener
permisos de lectura y escritura en el segmento. No existe la nocin de
segmentos de memoria compartida de escritura exclusiva.
.PP
El valor de
.B brk
del proceso que llama a la funcin no se altera por el pegado.
El segmento se despegar automticamente cuendo el proceso se acabe.
El mismo segmento puede ser pegaado como de lectura y de
lectura-escritura, y ms de una vez, en el espacio de direcciones del proceso.
.PP
Tras una llamada exitosa a
.B shmat
el sistema actualiza los miembros de la estructura
.B shmid_ds
asociada al segmento de memoria compartida como sigue:
.IP
.B shm_atime
toma el valor de la hora actual.
.IP
.B shm_lpid
toma el valor del PID del proceso llamador.
.IP
.B shm_nattch
se incrementa en uno.
.PP
Observe que el pegado tiene xito tambin si el segmento de memoria
compartida se marca como para ser borrado.
.PP
La funcin
.B shmdt
despega del segmento de datos del proceso que la llama el segmento de
memoria compartida localizado en la direccin especificada por
.IR shmaddr .
El segmento de memoria compartida despegado debe ser uno de entre los
pegados actualmente (al espacio de direcciones del proceso) con
.I shmaddr
igual al valor devuelto por su llamada de pegado
.BR shat .
.PP
Tras una llamada exitosa a
.B shmdt
el sistema actualiza los miembros de la estructura
.B shmid_ds
asociada al segmento de memoria compartida como sigue:
.IP
.B shm_dtime
toma el valor de la hora actual.
.IP
.B shm_lpid
toma el valor del PID del proceso llamador.
.IP
.B shm_nattch
se decrementa en uno.
Si llega a 0 y el segmento est marcado para ser borrado, el segmento
se borra.
.PP
La regin ocupada en el espacio de usuario del proceso llamador es desasociada.
.PP
.SH "LLAMADAS AL SISTEMA"
.TP
.B fork()
Despus de un
.B fork()
el hijo hereda los segmentos de memoria compartidos pegados.
.TP
.B exec()
Tras un
.B exec()
todos los segmentos de memoria compartida pegados son despegados (pero
no destruidos).
.TP
.B exit()
Tras
.B exit()
todos los segmentos de memoria compartida pegados son despegados (no
destruidos). 
.PP
.SH "VALOR DEVUELTO"
En caso de fallo ambas funciones devuelven 
.B \-1
con
.B errno
indicando el error; 
en otro caso
.B shmat
devuelve la direccin del segmento de memoria compartido pegado, y
.B shmdt
devuelve
.BR 0 .
.SH ERRORES
Cuando
.B shmat
falla, al regresar,
.B errno
tendr uno de entre los siguientes valores:
.TP 11
.B EACCES
El proceso llamador no tiene permisos de acceso para el tipo de pegado
pedido.
.TP
.B EINVAL
Valor de
.I shmid
invlido, no alineado (i.e., sin alineamiento de pgina y
\fBSHM_RND\fP no se especific), o valor de
.I shmaddr
invlido, o pegado fallido en
.BR brk .
.TP
.B ENOMEM
No se pudo reservar memoria para el descriptor o para las tablas de pgina.
.PP
La funcin
.B shmdt
puede fallar slo si no hay segmento de memoria compartida pegada en
.IR shmaddr ,
en cuyo caso al regresar
.B errno
tendr el valor
.BR EINVAL .
.SH NOTAS
Al ejecutar una llamada al sistema
.BR fork (2),
el hijo hereda todos los segmentos de memoria compartida pegados.
.PP
Los segmentos de memoria compartida pegados a un proceso que ejecuta
una llamada al sistema
.BR execve (2)
no sern pegados en el proceso resultante.
.PP
El siguiente es un parmetro del sistema que afecta a la llamada al sistema
.BR shmat :
.TP 11
.B SHMLBA
Direccin del lmite inferior del segmento. Debe estar alineado a pgina.
Para la implementacin actual el valor de
.B SHMBLA
es
.BR PAGE_SIZE .
.PP
La implementacin no tiene un lmite intrnseco para el nmero mximo
de segmentos de memoria compartida por proceso 
.RB ( SHMSEG )
.SH "CONFORME CON"
SVr4, SVID.  SVr4 documenta una condicin de error adicional EMFILE.
.SH "VASE TAMBIN"
.BR ipc (5),
.BR shmctl (2),
.BR shmget (2).