Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] msgctl - Contrôler les 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 msgctl ( int msqid ,[/i][/b] [b][i]int cmd ,[/i][/b] [b][i]struct msqid_ds * buf );[/i][/b] [size=18] [b]Description[/b] [/size] Cette fonction permet d'effectuer l'opération indiquée par [i]cmd[/i] sur la file de messages ayant l'identificateur [b]msqid.[/b] Les valeurs possibles de [i]cmd[/i] sont : [b]IPC_STAT[/b] [table][row][col]    [/col][col]Copier les informations depuis la structure représentant la file de messages dans la structure pointée par [b]buf .[/b] L'appelant doit avoir des privilèges d'accès en lecture sur la file de messages.[/col][/row][/table] [b]IPC_SET[/b] [table][row][col]    [/col][col]Écrire la valeurs de certains champs de la structure [b]msqid_ds[/b] pointée par [i]buf[/i] dans la structure représentant la file de messages, en mettant à jour le champ [b]msg_ctime .[/b] Les champs suivant de la structure peuvent être mis à jour : .nf .ft B msg_perm.uid msg_perm.gid msg_perm.mode /* 9 bits poids faibles */ msg_qbytes .fi .ft R L'UID effectif du processus appelant doit être soit celui du Super-User soit celui du créateur ou du propriétaire de la file de messages. Seul le Super-User peut augmenter la valeur de [b]msg_qbytes[/b] au-dessus de la constante système [b]MSGMNB.[/b][/col][/row][/table] [b]IPC_RMID[/b] [table][row][col]    [/col][col]Effacer immédiatement la file de messages et ses structures de données, en réveillant tous les processus écrivains et lecteurs en attente. Ils obtiendront un code d'erreur, et [b]errno[/b] aura la valeur [b]EIDRM.[/b] L'UID effectif du processus appelant doit être soit celui du Super-User soit celui du créateur ou du propriétaire de la file de messages.[/col][/row][/table] [size=18] [b]Valeur renvoyée[/b] [/size] [b]msgctl[/b] renvoie 0 s'il réussit, ou -1 s'il échoue, auquel cas [b]errno[/b] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]EACCES[/b] [table][row][col]    [/col][col]L'argument [i]cmd[/i] réclame l'opération [b]IPC_STAT[/b] mais le processus appelant n'a pas d'accès en lecture sur la file de messages [b]msqid.[/b][/col][/row][/table] [b]EFAULT[/b] [table][row][col]    [/col][col]L'argument [i]cmd[/i] réclame l'opération [b]IPC_SET[/b] ou [b]IPC_STAT[/b] mais [i]buf[/i] pointe en dehors de l'espace d'adressage accessible.[/col][/row][/table] [b]EIDRM[/b] [table][row][col]    [/col][col]La file de messages a déjà été supprimée.[/col][/row][/table] [b]EINVAL[/b] [i]cmd[/i] [table][row][col]    [/col][col]ou [b]msqid [/b] ont une valeur illégale.[/col][/row][/table] [b]EPERM[/b] [table][row][col]    [/col][col]L'argument [i]cmd[/i] réclame l'opération [b]IPC_SET[/b] ou [b]IPC_RMID[/b] mais l'UID effectif du processus appelant n'a pas assez de privilèges pour réaliser la commande. C'est aussi le cas d'un processus non Super-User tentant d'augmenter [b]msg_qbytes[/b] au-dessus de la valeur [b]MSGMNB .[/b][/col][/row][/table] [size=18] [b]Notes[/b] [/size] Les appels [b]IPC_INFO ,[/b] [b]MSG_STAT[/b] et [b]MSG_INFO[/b] sont utilisés par le programme [b]ipcs (8)[/b] pour fournir des informations sur les ressources allouées dans le futur, ceci peut être modifié si besoin, ou remplacé par une interface avec le système de fichiers proc.     Divers champs de la structure [i]struct[/i] msqid_ds étaient des shorts sous Linux 2.2 et sont devenus longs sous Linux 2.4. Pour en profiter, une recompilation avec la GlibC 2.1.91 ou ultérieure devrait suffire. (Le noyau distingue les appels anciens et nouveaux par un drapeau IPC_64 dans [b]cmd ).[/b] [size=18] [b]Conformité[/b] [/size] SVr4, SVID. SVID ne documente pas la condition d'erreur EIDRM. [size=18] [b]Voir aussi[/b] [/size] [b]ipc (5),[/b] [b]msgget (2),[/b] [b]msgsnd (2),[/b] [b]msgrcv (2).[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier