Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] shm_open, shm_unlink - Créer/ouvrir et supprimer des objets de mémoire partagés POSIX. [size=18] [b]Résumé[/b] [/size] [b]#include <sys/types.h>[/b] [b][/b] [b]#include <sys/mman.h>[/b] [b][i]int shm_open(const char * nom , int oflag , mode_t mode );[/i][/b] [b][i]int shm_unlink(const char * nom );[/i][/b] [size=18] [b]Description[/b] [/size] La fonction [b]shm_open[/b] 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 [b]mmap (2)[/b] pour projeter la même région mémoire. La fonction [b]shm_unlink[/b] réalise l'opération complémentaire en supprimant l'objet créé précédement par [b]shm_open .[/b]     Le fonctionnement de [b]shm_open[/b] est analogue à celui de [b]open (2).[/b] On indique le [i]nom[/i] d'un segment mémoire à créer ou ouvrir. Pour un fonctionnement portable, le [i]nom[/i] doit commencer par un slash (/) et ne pas en contenir d'autres.     [i]oflag[/i] est un masque de bit associant l'une des deux constantes [b]O_RDONLY [/b] ou [b]O_RWDR[/b] et un ou plusieurs des attributs décrits ci-après. [b]O_RDONLY[/b] [table][row][col]    [/col][col]Ouvrir l'objet en lecture seule. Un tel objet ne pourra être projeté en mémoire avec [b]mmap (2)[/b] qu'avec l'accès ([b]PROT_READ[/b]).[/col][/row][/table] [b]O_RDWR[/b] [table][row][col]    [/col][col]Ouvrir l'objet en lecture et écriture.[/col][/row][/table] [b]O_CREAT[/b] [table][row][col]    [/col][col]Créer l'objet de mémoire partagée s'il n'existe pas. L'utilisateur et le groupe propriétaires de l'objet sont fixés comme avec l'appel [b]open (2),[/b] et les bits de permission sont fixés en fonction des 9 bits de poids faible de [b]mode ,[/b] hormis les bits qui sont fixé dans le masque de création du processus (voir [b]umask (2))[/b] et qui sont effacés. Un jeu de constantes utilisables pour définir le [i]mode[/i] est décrit dans [b]open (2).[/b] Un nouvel objet de mémoire partagé a une taille initiale nulle - on la fixe en utilisant. [b]ftruncate (2).[/b] Les octets d'un objet mémoire partagé nouvellement créé sont automatiquement initialisés à zéro.[/col][/row][/table] [b]O_EXCL[/b] [table][row][col]    [/col][col]Si [b]O_CREAT[/b] était précisé et si un objet de mémoire partagée avec le même [i]nom[/i] 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.[/col][/row][/table] [b]O_TRUNC[/b] [table][row][col]    [/col][col]Si l'objet de mémoire partagée existait, tronquer sa taille à zéro.[/col][/row][/table]     Si elle réussit, la fonction [b]shm_open[/b] 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 [b]FD_CLOEXEC[/b] (voir [b]fcntl (2))[/b] sera activé sur le descripteur de fichier. Le descripteur est utilisé normalement pour les appels ultérieurs à [b]ftruncate (2)[/b] (pour un objet nouvellement créé) et [b]mmap (2).[/b] Après un appel à [b]mmap (2)[/b] le descripteur peut être fermé sans affecter la projection mémoire. Le fonctionnement de [b]shm_unlink[/b] est analogue à celui de [b]unlink (2) :[/b] 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 à [b]shm_unlink ,[/b] les tentatives d'appeler [b]shm_open [/b] avec le même [i]nom[/i] échoueront (sauf si [b]O_CREAT[/b] est spécifié, auquel cas un nouvel objet distinc est créé). [size=18] [b]Valeur renvoyée[/b] [/size] S'il réussit, l'appel [b]shm_open[/b] renvoir un descripteur de fichier non-négatif. S'il échoue, [b]shm_open[/b] renvoie -1. [b]shm_unlink[/b] renvoie 0 s'il réussit ou -1 en cas d'erreur. [size=18] [b]Erreurs[/b] [/size] Lors d'un échec, [i]errno[/i] indique la cause de l'erreur. Les codes possibles dans [i]errno[/i] sont les suivants : [b]EACCES[/b] [b]shm_open[/b] [table][row][col]    [/col][col]refusé pour le [i]nom[/i] dans le [b]mode[/b] indiqué, ou [b]O_TRUNC[/b] a été réclamé et l'appelant n'a pas les permissions d'écriture sur l'objet.[/col][/row][/table] [b]EACCES[/b] [table][row][col]    [/col][col]Interdicton d'utiliser [b]shm_unlink[/b] sur l'objet de mémoire partagée.[/col][/row][/table] [b]EEXIST[/b] [b]O_CREAT[/b] [table][row][col]    [/col][col]et [b]O_EXCL [/b] étaient réclamés dans [b]shm_open[/b] et un objet de mémoire partagée du même [i]nom[/i] existait déjà.[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]L'argument [i]nom[/i] dans le [b]shm_open[/b] était invalide.[/col][/row][/table] [b]EMFILE[/b] [table][row][col]    [/col][col]Le provessus a déjà ouvert son nombre maximal de fichiers.[/col][/row][/table] [b]ENAMETOOLONG[/b] [table][row][col]    [/col][col]La longueur du [i]nom[/i] dépasse [b]PATH_MAX .[/b][/col][/row][/table] [b]ENFILE[/b] [table][row][col]    [/col][col]La limite du nombre total de fichiers ouverts sur le système a été atteinte.[/col][/row][/table] [b]ENOENT[/b] [table][row][col]    [/col][col]Tentative d'ouvrir avec [b]shm_open[/b] un [i]non [/i] qui n'existe pas, sans attribut [b]O_CREAT .[/b][/col][/row][/table] [b]ENOENT[/b] [table][row][col]    [/col][col]Tentative d'utiliser [b]shm_unlink[/b] sur un [i]nom [/i] qui n'existe pas.[/col][/row][/table] [size=18] [b]Notes[/b] [/size] Ces fonctions sont fournies depuis la GlibC 2.2. Les programmes qui les invoquent doivent fournir l'argument [b]-lrt[/b] lors de la compilation avec [b]cc[/b] afin d'avoir l'édition des liens avec la bibliothèque nécessaire (temps-réel).     POSIX ne précise pas le comportement de la combinaison [b]O_RDONLY[/b] et [b]O_TRUNC .[/b] Sous Linux, la troncature aura lieu- cela n'est pas nécessairement le cas sous d'autres 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 [b]/dev/shm .[/b] [size=18] [b]Conformité[/b] [/size] POSIX 1003.1 (2001). [size=18] [b]Voir aussi[/b] [/size] [b]mmap (2),[/b] [b]open (2),[/b] [b]close (2),[/b] [b]ftruncate (2),[/b] [b]fstat (2),[/b] [b]fchown (2),[/b] [b]fchmod (2),[/b] [b]umask (2),[/b] [b]fcntl (2)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 2003.
Fichier