Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] shmctl - Contrôler la 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 shmctl(int shmid , int cmd , struct shmid_ds * buf );[/i][/b] .ad b [size=18] [b]Description[/b] [/size] [b]shmctl()[/b] permet à l'utilisateur d'obtenir des informations concernant un segment de mémoire partagée, ainsi que de fixer le propriétaire le groupe et les permissions d'accès à ce segment. Cette fonction permet également de détruire un segment. Les informations concernant le segment identifié par [i]shmid[/i] sont renvoyées dans une structure [i]shmid_ds[/i] : .in +4n .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 -4n Le champ [i]shm_perm[/i] a la forme suivante : .in +4n .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 .in -4n Les commandes [i]cmd[/i] suivantes sont disponibles : [b][/b] [b]IPC_STAT[/b] [table][row][col]    [/col][col]permet de récupérer dans le buffer [i]buf[/i] les informations concernant le segment de mémoire partagée. L'apellant doit avoir la permission d'accès en lecture sur le segment.[/col][/row][/table] [b]IPC_SET[/b] [table][row][col]    [/col][col]sert à appliquer les changements que l'utilisateur a apportés dans les champs [i]uid[/i], [i]gid[/i],ou [i]mode[/i] de la structure [i]shm_perms[/i]. Seuls les 9 bits de poids faibles sont utilisés dans [i]mode[/i]. Le membre [i]shm_ctime[/i] est aussi mis à jour. L'appelant doit être le créateur du segment, son propriétaire, ou le Super-User.[/col][/row][/table] [b]IPC_RMID[/b] [table][row][col]    [/col][col]permet de considérer un segment comme prêt pour la destruction. Il sera détruit effectivement après le dernier détachement (quand le membre [i]shm_nattch[/i] de la structure [i]shmid_ds[/i] associée vaudra zéro.) L'appelant doit être le créateur du segment, son propriétaire, ou le Super-User.[/col][/row][/table] Attention, même après le dernier détachement, le contenu du segment n'est pas effacé par le système. Un processus réalisant à nouveau un attachement recupèrera son contenu. Il est à la charge du processus l'utilisateur d'écraser le contenu du segment s'il ne veut pas qu'il persiste. De plus le [b]Super[/b]-User peut autoriser ou interdire le swapping d'un segment avec les commandes suivantes (spécifique Linux) : [b][/b] [b]SHM_LOCK[/b] [table][row][col]    [/col][col]empêche le swapping d'un segment de mémoire partagée. L'appelant doit consulter chaque page concernée après avoir effectué le verrouillage pour s'assurer qu'elle est bien présente en mémoire.[/col][/row][/table] [b]SHM_UNLOCK[/b] [table][row][col]    [/col][col]réautorise le swapping d'un segment. [/col][/row][/table] Les appels [b]IPC_INFO ,[/b] [b]SHM_STAT[/b] et [b]SHM_INFO[/b] sont utilisés par le programme [b]ipcs (8)[/b] afin d'obtenir des informations sur les ressources allouées. Dans le futur, ceci peut changer, ou être accessible via le pseudo système de fichiers proc. [size=18] [b]Valeur renvoyée[/b] [/size] [b]shmctl[/b] renvoie 0 s'il réussit et -1 s'il échoue, auquel cas [i]errno[/i] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]EACCES[/b] [table][row][col]    [/col][col]on demande [b]IPC_STAT[/b] mais [i]shm_perm.modes[/i] ne permet pas la lecture du segment [b]shmid .[/b][/col][/row][/table] [b]EFAULT[/b] [i]cmd[/i] [table][row][col]    [/col][col]à la valeur [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]EINVAL[/b] [table][row][col]    [/col][col][i]shmid[/i] n'est pas un identificateur de segment valide, ou [i]cmd[/i] n'est pas une commande reconnue.[/col][/row][/table] [b]EIDRM[/b] [table][row][col]    [/col][col][i]shmid[/i] pointe sur un segment détruit.[/col][/row][/table] [b]EPERM[/b] [table][row][col]    [/col][col]On réclame [b]IPC_SET[/b] ou [b]IPC_RMID[/b] mais l'appelant n'est ni le propriétaire du segment, ni son créateur, ni le Super-User.[/col][/row][/table] [b]EOVERFLOW[/b] [table][row][col]    [/col][col]on demande [b]IPC_STAT[/b] mais la valeur de GID ou d'UID est trop grande pour être stockée dans la structure pointée par [b]buf .[/b] [/col][/row][/table] [size=18] [b]Notes[/b] [/size] Divers champs de la [i]struct[/i] shmid_ds étaient des shorts sous Linux 2.2 et sont devenus longs sous Linux 2.4. Pour en tirer parti, une recompilation sous GlibC 2.1.91 ou ultérieure doit suffire. (Le noyau distingue les anciens et nouveaux appels par un drapeau IPC_64 dans [b]cmd .)[/b] [size=18] [b]Conformité[/b] [/size] SVr4, SVID. SVr4 mentionne des conditions d'erreur supplémentaires ENOENT, ENOSPC, ENOMEM, EEXIST. Ni SVr4, ni SVID ne documentent la condition d'erreur EIDRM. [size=18] [b]Voir aussi[/b] [/size] [b]shmget (2),[/b] [b]shmop (2)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier