NOM

       shm_open, shm_unlink - Créer ou ouvrir et supprimer des objets de mémoire partagés POSIX

SYNOPSIS

       #include <sys/mman.h>
       #include <sys/stat.h>        /* Pour les constantes des modes */
       #include <fcntl.h>           /* Pour les constantes O_* */

       int shm_open(const char *nom, int oflag, mode_t mode);

       int shm_unlink(const char *nom);

       Effectuez l'édition des liens avec l'option -lrt.

DESCRIPTION

       La fonction shm_open() crée et ouvre un nouvel objet de mémoire partagé POSIX, ou ouvre un
       objet existant. Il s'agit d'un descripteur utilisable par d'autres processus avec  mmap(2)
       pour  projeter  la  même  région  mémoire.  La  fonction  shm_unlink() réalise l'opération
       complémentaire en supprimant l'objet créé précédemment par shm_open().

       Le fonctionnement de shm_open() est analogue à  celui  de  open(2).  nom  indique  l'objet
       mémoire  partagé  à  créer  ou  ouvrir.  Pour un fonctionnement portable, un objet mémoire
       partagé doit être identifié par  un  nom  au  format  /un_nom ;  c'est-à-dire  une  chaîne
       terminée  par un caractère nul d'au plus NAME_MAX (c'est-à-dire 255) caractère, commençant
       par une barre oblique (« / »), suivi d'un caractère ou plus, ces derniers n'étant pas  des
       barres obliques.

       oflag est un masque de bit associant l'une des deux constantes O_RDONLY ou O_RDWR et un ou
       plusieurs des attributs décrits ci-après.

       O_RDONLY   Ouvrir l'objet en lecture seule. Un tel objet ne pourra être projeté en mémoire
                  avec mmap(2) qu'avec l'accès (PROT_READ).

       O_RDWR     Ouvrir l'objet en lecture et écriture.

       O_CREAT    Créer l'objet de mémoire partagée s'il n'existe pas. L'utilisateur et le groupe
                  propriétaires de l'objet proviennent des IDs effectifs du  processus  appelant,
                  et  les  bits de permission sont définis en fonction des 9 bits de poids faible
                  de mode, hormis les bits qui  sont  définis  dans  le  masque  de  création  du
                  processus  (consultez  umask(2))  et  qui  sont  effacés.  Un jeu de constantes
                  utilisables pour définir le mode  est  décrit  dans  open(2)  (les  définitions
                  symboliques de ces constantes peuvent être obtenues en incluant <sys/stat.h>).

                  Un nouvel objet de mémoire partagé a une taille initiale nulle — elle peut être
                  définie avec ftruncate(2). Les octets d'un objet mémoire  partagé  nouvellement
                  créé sont automatiquement initialisés à zéro.

       O_EXCL     Si  O_CREAT  était  précisé et si un objet de mémoire partagée avec le même nom
                  existait déjà, renvoyer une  erreur.  La  vérification  et  l'existence  et  la
                  création éventuelle sont réalisées de manière atomique.

       O_TRUNC    Si l'objet de mémoire partagée existait, tronquer sa taille à zéro.

       Les définitions des valeurs de ces attributs peuvent être obtenues en incluant <fcntl.h>.

       Si  elle  réussit, la fonction shm_open() renvoie un nouveau descripteur décrivant l'objet
       de mémoire partagée. Le descripteur est assuré d'être le plus petit numéro disponible dans
       la  table  des  descripteurs du processus. L'attribut FD_CLOEXEC (consultez fcntl(2)) sera
       activé sur le descripteur de fichier.

       Le descripteur est utilisé normalement pour les appels ultérieurs à ftruncate(2) (pour  un
       objet  nouvellement  créé)  et  mmap(2). Après un appel à mmap(2) le descripteur peut être
       fermé sans affecter la projection mémoire.

       Le fonctionnement de shm_unlink() est analogue à celui de unlink(2) : il supprime  le  nom
       d'un  objet  de  mémoire  partagée,  et, une fois que tous les processus ont supprimé leur
       projection en mémoire, libère et détruit le contenu de la portion  de  mémoire.  Après  un
       appel  réussi  à  shm_unlink(),  les  tentatives  d'appeler  shm_open()  avec  le même nom
       échoueront (sauf si O_CREAT est spécifié, auquel cas un nouvel objet distinct est créé).

VALEUR RENVOYÉE

       S'il réussit, l'appel shm_open() renvoie un  descripteur  de  fichier  non  négatif.  S'il
       échoue, shm_open() renvoie -1. shm_unlink() renvoie 0 s'il réussit ou -1 en cas d'erreur.

ERREURS

       Lors  d'un  échec, errno indique la cause de l'erreur. Les codes possibles dans errno sont
       les suivants :

       EACCES Interdiction d'utiliser shm_unlink() sur l'objet de mémoire partagée.

       EACCES shm_open() refusée pour le nom dans le mode indiqué, ou O_TRUNC a  été  réclamé  et
              l'appelant n'a pas les permissions d'écriture sur l'objet.

       EEXIST O_CREAT  et O_EXCL étaient réclamés dans shm_open() et un objet de mémoire partagée
              du même nom existait déjà.

       EINVAL L'argument nom de shm_open() était invalide.

       EMFILE Le processus a déjà ouvert le nombre maximal de fichiers.

       ENAMETOOLONG
              La longueur du nom dépasse PATH_MAX.

       ENFILE La limite du nombre total de fichiers ouverts sur le système a été atteinte.

       ENOENT Tentative d'ouvrir avec shm_open() un nom qui n'existe pas, sans attribut O_CREAT.

       ENOENT Tentative d'utiliser shm_unlink() sur un nom qui n'existe pas.

VERSIONS

       Ces fonctions sont fournies depuis la glibc 2.2.

CONFORMITÉ

       POSIX.1-2001.

       POSIX.1-2001 indique que le groupe propriétaire d'un objet nouvellement créé utilise  soit
       l'ID  de  groupe  du  processus  appelant, soit un « ID de groupe par défaut défini par le
       système ».

NOTES

       POSIX ne précise pas le comportement de la combinaison O_RDONLY et O_TRUNC. Sous Linux, la
       troncature aura lieu — cela n'est pas nécessairement le cas sous d'autres systèmes UNIX.

       L'implémentation sous Linux 2.4 des objets de mémoire partagée POSIX utilise un système de
       fichiers dédiés, monté en principe sous /dev/shm.

VOIR AUSSI

       close(2),  fchmod(2),  fchown(2),  fcntl(2),  fstat(2),  ftruncate(2),  mmap(2),  open(2),
       umask(2), shm_overview(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). Nicolas  François  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> ».