Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] msgget - Obtenir un identificateur de file de messages. [size=18] [b]Résumé[/b] [/size] .nf .B #include <sys/types.h> .B #include <sys/ipc.h> .B #include <sys/msg.h> .fi [b][i]int msgget ( key_t key ,[/i][/b] [b][i]int msgflg );[/i][/b] [size=18] [b]Description[/b] [/size] Cette fonction renvoie l'identificateur de la file de messages associée à la clé [i]key.[/i] Une nouvelle file de messages est créée si [i]key[/i] a la valeur [b]IPC_PRIVATE[/b] ou si aucune file de message n'est associée à [b]key ,[/b] et si la valeur [b]IPC_CREAT[/b] a été introduite dans [i]msgflg[/i] (c'est à dire [b][i]msgflg & IPC_CREAT[/i][/b] non nul). La présence des champs [b]IPC_CREAT[/b] et [b]IPC_EXCL[/b] dans [i]msgflg[/i] joue le même rôle, par rapport à l'existence de la file de messages, que la présence des champs [b]O_CREAT[/b] et [b]O_EXCL[/b] dans l'argument [i]mode[/i] de l'appel système [b]open (2) :[/b] La fonction [b]msgget[/b] échouera si [i]msgflg[/i] indique à la fois [b]IPC_CREAT[/b] et [b]IPC_EXCL[/b] et si une file de messages existe déjà associée à [b]key.[/b] Lors de la création, les 9 bits de poids faibles de l'argument [i]msgflg[/i] définissent les permissions d'accès à la file de message (pour le propriétaire, le groupe, et les autres) avec le même format et la même signification que les permissions d'accès dans les appels [b]open (2)[/b] ou [b]creat (2)[/b] (bien que la permission d'exécution ne soit pas utilisée). Pendant la création, l'appel système initialise la structure système [b]msqid_ds[/b] de la file de messages comme suit : [b]msg_perm.cuid[/b] [table][row][col]    [/col][col]et [b]msg_perm.uid[/b] sont remplis avec l'UID effectif du processus appelant.[/col][/row][/table] [b]msg_perm.cgid[/b] [table][row][col]    [/col][col]et [b]msg_perm.gid[/b] sont remplis avec le GID effectif du processus appelant.[/col][/row][/table] [table][row][col]    [/col][col]Les 9 bits de poids faibles de [b]msgflg[/b] sont copiés dans les 9 bits de poids faibles de [b]msg_perm.mode .[/b][/col][/row][/table] [b]msg_qnum ,[/b] [b]msg_lspid ,[/b] [b]msg_lrpid ,[/b] [b]msg_stime[/b] [table][row][col]    [/col][col]et [b]msg_rtime[/b] sont fixés à 0.[/col][/row][/table] [b]msg_ctime[/b] [table][row][col]    [/col][col]est rempli avec l'heure actuelle.[/col][/row][/table] [b]msg_qbytes[/b] [table][row][col]    [/col][col]est rempli avec la limite système [b]MSGMNB .[/b][/col][/row][/table] Si la file de message existe déjà, les permissions d'accès sont contrôlées, et une vérification est faite pour voir si la file est prête à être détruite. [size=18] [b]Valeur renvoyée[/b] [/size] [b]msgget[/b] renvoie l'identificateur de la file de messages (un entier positif), s'il réussit. En cas d'échec -1 est renvoyé et [b]errno[/b] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]EACCES[/b] [table][row][col]    [/col][col]Une file de messages existe associée à la clé [b]key ,[/b] mais le processus appelant n'a pas de permissions sur cette file.[/col][/row][/table] [b]EEXIST[/b] [table][row][col]    [/col][col]Une file de messages existe associée à la clé [b]key[/b] et [i]msgflg[/i] réclame à la fois [b]IPC_CREAT[/b] et [b]IPC_EXCL .[/b][/col][/row][/table] [b]ENOENT[/b] [table][row][col]    [/col][col]Aucune file de messages n'existe associée à la clé [i]key[/i] et [i]msgflg[/i] ne contient pas [b]IPC_CREAT .[/b][/col][/row][/table] [b]ENOMEM[/b] [table][row][col]    [/col][col]Pas assez de mémoire pour les nouvelles structures de données.[/col][/row][/table] [b]ENOSPC[/b] [table][row][col]    [/col][col]Le nombre maximum de files de messages sur le système [b]( MSGMNI )[/b] est atteint.[/col][/row][/table] [size=18] [b]Notes[/b] [/size] [b]IPC_PRIVATE[/b] n'est pas destiné au champ [i]msgflg[/i] mais est du type [b]key_t.[/b] Si cette valeur spéciale est fournie à la place de [b]key ,[/b] l'appel système ignorera tout sauf les 9 bits de poids faibles de [i]msgflg[/i] et créera une nouvelle file de messages. La limite système concernant les files de messages et affectant [b]msgget[/b] est [b]MSGMNI[/b] [table][row][col]    [/col][col]Nombre maximum de files de messages sur le système.[/col][/row][/table] [size=18] [b]Bugs[/b] [/size] L'utilisation de [b]IPC_PRIVATE[/b] n'empêche pas les autres processus d'avoir accès à la file de messages allouée. Le nom IPC_PRIVATE a été mal choisi, ICP_NEW aurait été mieux. [size=18] [b]Conformité[/b] [/size] SVr4, SVID. SVr4 ne documente pas le code d'erreur EIDRM. Jusqu'à la version 2.3.20, Linux renvoyait EIDRM pour un [b]msgget[/b] sur une file de messages prête à être supprimée. [size=18] [b]Voir aussi[/b] [/size] [b]ftok (3),[/b] [b]ipc (5),[/b] [b]msgctl (2),[/b] [b]msgsnd (2),[/b] [b]msgrcv (2) [/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier