Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] shmget - Allouer un segment de mémoire partagée. [size=18] [b]Résumé[/b] [/size] .ad l [b]#include <sys/ipc.h>[/b] [b]#include <sys/shm.h>[/b] [b][i]int shmget(key_t clé , int size , int shmflg );[/i][/b] .ad b [size=18] [b]Description[/b] [/size] [b]shmget()[/b] renvoie l'identificateur du segment de mémoire partagée associé à la valeur de l'argument [b]clé .[/b] Un nouveau segment mémoire, de taille [i]size[/i] arrondie au multiple supérieur de [b]PAGE_SIZE ,[/b] est créé si [i]clé[/i] a la valeur [b]IPC_PRIVATE[/b] ou si aucun segment de mémoire partagée n'est associé à [b]clé ,[/b] et [b]IPC_CREAT[/b] est présent dans [i]shmflg.[/i] [i]shmflg[/i] est composé de : [b]IPC_CREAT[/b] [table][row][col]    [/col][col]pour créer un nouveau segment. Sinon [b]shmget()[/b] recherchera le segment associé à [i]clé[/i], vérifiera que l'appelant a la permission de recevoir l'identifiant [i]shmid[/i] associé au segment, et contrôlera que le segment n'est pas détruit.[/col][/row][/table] [b]IPC_EXCL[/b] [table][row][col]    [/col][col]est utilisé avec [b]IPC_CREAT[/b] pour garantir l'échec si le segment existe déjà.[/col][/row][/table] [b]mode d'accès (les 9 bits de poids faibles)[/b] [table][row][col]    [/col][col]indiquant les permissions pour le propriétaire, le groupe et les autres. Actuellement la permission d'exécution n'est pas utilisée par le système.[/col][/row][/table] Si un nouveau segment est créé, les permissions d'accès de [i]shmflg[/i] sont copiées dans le membre [i]shm_perm[/i] de la structure [i]shmid_ds[/i] décrivant le segment. Cette structure est définie ainsi : .in +0.5i .nf struct shmid_ds { struct ipc_perm shm_perm; /* Permissions d'accès / int shm_segsz; / Taille segment en octets / time_t shm_atime; / Heure dernier attachement / time_t shm_dtime; / Heure dernier détachement / time_t shm_ctime; / Heure dernier changement / unsigned short shm_cpid; / PID du créateur / unsigned short shm_lpid; / PID du dernier opérateur / short shm_nattch; / Nombre d'attachements / }; .fi .in -0.5i .in +0.5i .nf struct ipc_perm { key_t key; ushort uid; / UID et GID effectifs du propriétaire / ushort gid; ushort cuid; / UID et GID effectif du créateur / ushort cgid; ushort mode; / Mode d'accès sur 9 bits de poids faible / ushort seq; / Numéro de séquence */ }; .fi De plus, durant la création, le système initialise la structure [b]shmid_ds[/b] associée au segment comme suit : [b]shm_perm.cuid[/b] [table][row][col]    [/col][col]et [b]shm_perm.uid[/b] contiennent l'UID effectif de l'appelant.[/col][/row][/table] [b]shm_perm.cgid[/b] [table][row][col]    [/col][col]et [b]shm_perm.gid[/b] contiennent le GID effectif de l'appelant.[/col][/row][/table] [table][row][col]    [/col][col]Les 9 bits de poids faibles de [b]shm_perm.mode[/b] contiennent les 9 bits de poids faibles de [b]shmflg .[/b][/col][/row][/table] [b]shm_segsz[/b] [table][row][col]    [/col][col]prend la valeur [b]size.[/b][/col][/row][/table] [b]shm_lpid ,[/b] [b]shm_nattch ,[/b] [b]shm_atime[/b] [table][row][col]    [/col][col]et [b]shm_dtime[/b] sont mis à [b]0.[/b][/col][/row][/table] [b]shm_ctime[/b] [table][row][col]    [/col][col]contient l'heure actuelle[/col][/row][/table] Si le segment de mémoire existe déjà, les permissions d'accès sont vérifiées, et un contrôle à lieu pour voir s'il est marqué pour destruction. [size=18] [b]Autres appels systÈmes[/b] [/size] [b]fork()[/b] [table][row][col]    [/col][col]Après un [b]fork()[/b] le fils hérite des segments de mémoire partagée.[/col][/row][/table] [b]exec()[/b] [table][row][col]    [/col][col]Après un [b]exec()[/b] tous les segments de mémoire partagée sont détachés (pas détruits).[/col][/row][/table] [b]exit()[/b] [table][row][col]    [/col][col]Lors d'un [b]exit()[/b] tous les segments de mémoire partagée sont détachés (pas détruits).[/col][/row][/table] [size=18] [b]Valeur renvoyée[/b] [/size] Un identificateur de segment [b]shmid [/b] valide est renvoyé en cas de réussite, sinon -1 est renvoyé et [i]errno[/i] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]EINVAL[/b] [table][row][col]    [/col][col][b]SHMMIN[/b] > [i]size[/i] ou [i]size[/i] > [b]SHMMAX[/b], ou [i]size[/i] plus grand que la taille du segment.[/col][/row][/table] [b]EEXIST[/b] [table][row][col]    [/col][col]On a indiqué [b]IPC_CREAT \| IPC_EXCL[/b] et le segment existe déjà.[/col][/row][/table] [b]ENOSPC[/b] [table][row][col]    [/col][col]Tous les ID de mémoire partagée sont utilisés, ou l'allocation d'un segment partagé de taille [i]size[/i] dépasserait les limites de mémoire partagée du système.[/col][/row][/table] [b]ENOENT[/b] [table][row][col]    [/col][col]Aucun segment n'est associé à [i]clé[/i], et [b]IPC_CREAT[/b] n'etait pas indiqué.[/col][/row][/table] [b]EACCES[/b] [table][row][col]    [/col][col]L'appelant n'a pas les autorisations d'accès au segment.[/col][/row][/table] [b]ENOMEM[/b] [table][row][col]    [/col][col]Pas assez de mémoire.[/col][/row][/table] [size=18] [b]Notes[/b] [/size] [b]IPC_PRIVATE[/b] n'est pas une option mais une valeur de type [b]key_t .[/b] Si cette valeur spéciale est utilisée comme [b]clé ,[/b] l'appel système ignore tout sauf les 9 bits de poids faibles de [i]shmflg[/i] et tente de créer un nouveau segment. Les limites suivantes influent sur l'appel système [b]shmget :[/b] [b]SHMALL[/b] [table][row][col]    [/col][col]Nombre maximal de pages de mémoire partagée sur le système.[/col][/row][/table] [b]SHMMAX[/b] [table][row][col]    [/col][col]Taille maximale d'un segment partagé (actuellement 4 Mo).[/col][/row][/table] [b]SHMMIN[/b] [table][row][col]    [/col][col]Taille minimale d'un segment partagé. (actuellement 1 octet, bien que [b]PAGE_SIZE[/b] soit la valeur effectivement utilisée).[/col][/row][/table] [b]SHMMNI[/b] [table][row][col]    [/col][col]Nombre maximal de segments de mémoire partagée sur le système (actuellement 4096, mais 128 avant Linux 2.3.99).[/col][/row][/table] Il n'y a pas de limite pour le nombre de segments partagés par processus (sauf SHMMNI). [size=18] [b]Bugs[/b] [/size] Le choix du nom IPC_PRIVATE est plutôt malheureux, il aurait mieux valu utiliser IPC_NEW. [size=18] [b]Conformité[/b] [/size] SVr4, SVID. SVr4 mentionne une condition d'erreur supplémentaire EEXIST. Jusqu'au noyau 2.3.30, Linux renvoyait l'erreur EIDRM pour un [b]shmget[/b] sur un segment de mémoire marqué pour destruction. [size=18] [b]Voir aussi[/b] [/size] [b]ftok (3),[/b] [b]ipc (5),[/b] [b]shmctl (2),[/b] [b]shmat (2),[/b] [b]shmdt (2).[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier