NOM¶

SYNOPSIS¶

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

int shm_unlink(const char *nom);

Éditer les liens avec -lrt.

DESCRIPTION¶

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.

The operation of shm_unlink() is analogous to unlink(2): it removes a shared memory object name, and, once all processes have unmapped the object, de-allocates and destroys the contents of the associated memory region. After a successful shm_unlink(), attempts to shm_open() an object with the same name fail (unless O_CREAT was specified, in which case a new, distinct object is created).

VALEUR RENVOYÉE¶

ERREURS¶

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

La limite du nombre de descripteurs de fichiers par processus a été atteinte.

ENAMETOOLONG

La longueur du nom dépasse PATH_MAX.

ENFILE

La limite du nombre total de fichiers ouverts pour le système entier 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¶

ATTRIBUTS¶

CONFORMITɶ

POSIX.1-2001 says that the group ownership of a newly created shared memory object is set to either the calling process's effective group ID or "a system default group ID". POSIX.1-2008 says that the group ownership may be set to either the calling process's effective group ID or, if the object is visible in the filesystem, the group ID of the parent directory.

NOTES¶

The POSIX shared memory object implementation on Linux makes use of a dedicated tmpfs(5) filesystem that is normally mounted under /dev/shm.

VOIR AUSSI¶

COLOPHON¶

TRADUCTION¶

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à <debian-l10n-french@lists.debian.org>.