Provided by: manpages-fr-dev_3.65d1p1-1_all bug

NOM

       shmat, shmdt - Opérations sur la mémoire partagée System V

SYNOPSIS

       #include <sys/types.h>
       #include <sys/shm.h>

       void *shmat(int shmid, const void *shmaddr, int shmflg);

       int shmdt(const void *shmaddr);

DESCRIPTION

       La fonction shmat() attache le segment de mémoire partagée System V identifié par shmid au
       segment de données du processus appelant. L'adresse d'attachement est indiquée par shmaddr
       avec les critères suivants :

       Si  shmaddr  vaut  NULL,  le  système essaye de trouver une adresse libre pour attacher le
       segment.

       Si shmaddr n'est pas NULL et si SHM_RND est indiqué dans shmflg, l'attachement  a  lieu  à
       l'adresse  shmaddr  arrondie  au  multiple  inférieur  de  SHMLBA. Sinon shmaddr doit être
       alignée sur une frontière de page, où l'attachement a lieu.

       Si SHM_RDONLY est indiqué dans shmflg, le segment est attaché en lecture seulement, et  le
       processus  doit  disposer de la permission de lecture dessus. Sinon le segment est attaché
       en lecture et écriture et le processus doit disposer des deux permissions d'accès. Il  n'y
       a pas de notion d'écriture seule pour les segments de mémoire partagée.

       L'option (spécifique à Linux) SHM_REMAP peut être ajoutée dans shmflg pour indiquer que la
       projection  du  segment  doit  remplacer  une  projection  précédente  dans   l'intervalle
       commençant  en  shmaddr  et  s'étendant  sur la taille du segment. (Normalement une erreur
       EINVAL se produirait si une projection existait déjà dans l'intervalle indiqué.)  Dans  ce
       cas, shmaddr ne doit pas être NULL.

       La valeur brk(2) du processus appelant n'est pas altérée par l'attachement. Le segment est
       automatiquement détaché quand le processus se termine. Le même segment peut être attaché à
       la  fois  en  lecture  seule  et  en  lecture/écriture.  Il peut également être attaché en
       plusieurs endroits de l'espace d'adressage du processus.

       Quand shmat() réussit, les membres de la structure shmid_ds associée au segment de mémoire
       partagée (consultez shmctl(2)) sont mis à jour ainsi :

              shm_atime correspond à l'heure actuelle.

              shm_lpid contient le PID de l'appelant.

              shm_nattch est incrémenté de 1.

       La  fonction shmdt() détache le segment de mémoire partagée situé à l'adresse indiquée par
       shmaddr. Le segment doit être effectivement attaché, et l'adresse shmaddr doit être  celle
       renvoyée précédemment par shmat().

       Quand shmdt() réussit, les membres de la structure shmid_ds associée au segment de mémoire
       partagée sont mis à jour ainsi :

              shm_dtime correspond à l'heure actuelle.

              shm_lpid contient le PID de l'appelant.

              shm_nattch est décrémenté de 1. S'il devient nul, et si le segment est marqué  pour
              destruction, il est effectivement détruit.

       Après un fork(2) le fils hérite des segments de mémoire partagée.

       Après un execve(2) tous les segments de mémoire partagée sont détachés (pas détruits).

       Lors d'un _exit(2) tous les segments de mémoire partagée sont détachés (pas détruits).

VALEUR RENVOYÉE

       S'il  réussit,  shmat() renvoie l'adresse d'attachement du segment de mémoire partagée. En
       cas d'échec (void *) -1 est renvoyé, et errno contient le code d'erreur.

       shmdt() renvoie zéro s'il réussit et -1 s'il échoue et écrit la  cause  de  l'erreur  dans
       errno.

ERREURS

       Quand shmat() échoue, errno prend l'une des valeurs suivantes :

       EACCES L'appelant  n'a  pas les permissions d'accès nécessaires pour l'attachement, et n'a
              pas la capacité CAP_IPC_OWNER.

       EIDRM  shmid pointe sur un segment détruit.

       EINVAL shmid est invalide, shmaddr est mal alignée (c'est-à-dire pas alignée sur une  page
              et SHM_RND n'a pas été précisé) ou invalide, échec lors de l'attachement à shmaddr,
              ou SHM_REMAP a été réclamé et shmaddr est NULL.

       ENOMEM Pas assez de mémoire pour le système.

       Quand shmdt() échoue, errno prend l'une des valeurs suivantes :

       EINVAL Aucun segment de mémoire partagée  n'est  attaché  à  l'adresse  shmaddr,  ou  bien
              shmaddr n'est pas un multiple de la taille de page.

CONFORMITÉ

       SVr4, POSIX.1-2001.

       Dans  SVID  3  (ou  peut  être  auparavant) le type de l'argument shmaddr a été modifié de
       char * en const void *, et le type  de  retour  de  shmat()  de  char *  en  void *.  (Les
       bibliothèques  Linux  libc4  et  libc5  avaient le prototype char *, la glibc 2 celui avec
       void *).

NOTES

       Utiliser shmat() avec shmaddr égale à NULL est la manière conseillée, portable, d'attacher
       un  segment  de mémoire partagée. Soyez conscients que le segment attaché de cette manière
       peut l'être à des adresses différentes dans les différents processus. Ainsi, tout pointeur
       contenu  dans  la  mémoire partagée doit être relatif (typiquement par rapport au début du
       segment) et pas absolu.

       Sous Linux, il est possible d'attacher un segment de mémoire partagée qui est déjà  marqué
       pour effacement. Cependant, ce comportement n'est pas décrit par POSIX.1-2001, et beaucoup
       d'autres implémentations ne le permettent pas.

       Les paramètres système suivants influent sur shmat() :

       SHMLBA Multiple pour l'adresse de début de segment. Doit être aligné sur une frontière  de
              page. Pour l'implémentation actuelle, SHMLBA à la même valeur que PAGE_SIZE.

       L'implémentation  n'a  pas  de  limite  intrinsèque  pour le nombre maximal de segments de
       mémoire partagée par processus (SHMSEG).

VOIR AUSSI

       brk(2), mmap(2), shmctl(2), shmget(2), capabilities(7), shm_overview(7), svipc(7)

COLOPHON

       Cette page fait partie de la publication 3.65 du projet man-pages Linux.  Une  description
       du  projet  et  des  instructions  pour  signaler  des  anomalies  peuvent être trouvées à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis   2010,   cette   traduction   est   maintenue   à   l'aide   de    l'outil    po4a
       <http://po4a.alioth.debian.org/>  par l'équipe de traduction francophone au sein du projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe   Blaess   <http://www.blaess.fr/christophe/>   (1996-2003),    Alain    Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Julien  Cristau  et  l'équipe  francophone  de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>   ou   par   un  rapport  de  bogue  sur  le  paquet
       manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de  ce  document  en  utilisant  la
       commande « man -L C <section> <page_de_man> ».