Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] semctl - Opérations de contrôle sur les sémaphores. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <sys/types.h>[/b] [b]#include <sys/ipc.h>[/b] [b]#include <sys/sem.h>[/b] [b][i]int semctl (int semid , int semno , int cmd , ...);[/i][/b] .fi [size=18] [b]Description[/b] [/size] Cette fonction effectue l'opération de contrôle indiquée par [i]cmd[/i] sur l'ensemble de sémaphores (ou sur le [b]semno-ième[/b] sémaphore de l'ensemble) identifié par [b]semid ,[/b] (les sémaphores sont numérotés à partir de zéro). Cette fonction prend trois ou quatre arguments. Lorsqu'il y en a quatre, l'appel est [b][i]semctl ( semid , semno , cmd , arg );[/i][/b] où l'argument [i]arg[/i] est de type [b]union semun[/b] défini ainsi : .nf #if defined(__GNU_LIBRARY__) && !defined(_SEM_SEMUN_UNDEFINED) /* l'union semun est définie par l'inclusion de <sys/sem.h> / #else / d'après X/OPEN il faut la définir nous-mêmes / union semun { int val; / valeur pour SETVAL / struct semid_ds buf; /* buffer pour IPC_STAT, IPC_SET / unsigned short array; /* table pour GETALL, SETALL / / Spécificité Linux : / struct seminfo __buf; /* buffer pour IPC_INFO / }; #endif .fi Les valeurs autorisées pour l'opération [i]cmd[/i] sont : [b]IPC_STAT[/b] [table][row][col]    [/col][col]copier dans la structure pointée par [b][i]arg .buf[/i][/b] la structure de données concernant l'ensemble de sémaphores. L'argument [i]semno[/i] est alors ignoré. Le processus appelant doit avoir des privilèges de lecture sur le jeu de sémaphores[/col][/row][/table] [b]IPC_SET[/b] [table][row][col]    [/col][col]Fixer la valeur de certains champs de la structure [b]semid_ds[/b] pointée par [b][i]arg .buf[/i][/b] dans la structure de contrôle de l'ensemble de sémaphores, en mettant à jour son membre [b]sem_ctime.[/b] Les champs de la structure [b]struct semid_ds[/b] fournie dans [b][i]arg .buf[/i][/b] et copiés dans la structure de l'ensemble sont : .nf .ft B sem_perm.uid sem_perm.gid sem_perm.mode / 9 bits poids faibles*/ .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 du jeu de sémaphores. L'argument [i]semno[/i] est ignoré.[/col][/row][/table] [b]IPC_RMID[/b] [table][row][col]    [/col][col]Supprimer immédiatement l'ensemble de sémaphores en réveillant tous les processus 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 du jeu de sémaphores. L'argument [i]semno[/i] est ignoré.[/col][/row][/table] [b]GETALL[/b] [table][row][col]    [/col][col]Renvoyer la valeur [b]semval[/b] de chaque sémaphore de l'ensemble dans le tableau [b][i]arg .array .[/i][/b] L'argument [i]semno[/i] est ignoré. Le processus appelant doit avoir des privilèges de lecture sur le jeu de sémaphores.[/col][/row][/table] [b]GETNCNT[/b] [table][row][col]    [/col][col]Renvoyer la valeur de [b]semncnt[/b] pour le [b]semno-ième[/b] sémaphore de l'ensemble (i.e. le nombre de processus en attente d'une incrémentation du champ [b]semval[/b] du [b]semno-ième[/b] sémaphore). Le processus appelant doit avoir des privilèges de lecture sur le jeu de sémaphores.[/col][/row][/table] [b]GETPID[/b] [table][row][col]    [/col][col]Renvoyer la valeur de [b]sempid[/b] pour le [b]semno-ième[/b] sémaphore de l'ensemble (i.e. le PID du processus ayant exécute le dernier appel système [b]semop[/b] sur le [b]semno-ième[/b] sémaphore). Le processus appelant doit avoir des privilèges de lecture sur le jeu de sémaphores.[/col][/row][/table] [b]GETVAL[/b] [table][row][col]    [/col][col]Renvoyer la valeur du champ [b]semval[/b] du [b]semno-ième[/b] sémaphore de l'ensemble Le processus appelant doit avoir des privilèges de lecture sur le jeu de sémaphores.[/col][/row][/table] [b]GETZCNT[/b] [table][row][col]    [/col][col]Renvoyer la valeur du champ [b]semzcnt[/b] du [b]semno-ième[/b] sémaphore de l'ensemble. (i.e. le nombre de processus attendant que le champ [b]semval[/b] du [b]semno-ième[/b] sémaphore revienne à 0). Le processus appelant doit avoir des privilèges de lecture sur le jeu de sémaphores.[/col][/row][/table] [b]SETALL[/b] [table][row][col]    [/col][col]Positionner le champ [b]semval[/b] de tous les sémaphores de l'ensemble en utilisant le tableau [b][i]arg .array[/i][/b] et en mettant à jour le champ [b]sem_ctime[/b] de la structure [b]semid_ds[/b] de contrôle du jeu de sémaphores. Les processus en attente sont réveillés si [b]semval[/b] devient 0 ou augmente. L'argument [i]semno[/i] est ignoré. Le processus appelant doit avoir des privilèges d'écriture sur le jeu de sémaphores.[/col][/row][/table] [b]SETVAL[/b] [table][row][col]    [/col][col]Placer la valeur [b][i]arg .val[/i][/b] dans le champ [b]semval[/b] du [b]semno-ième[/b] sémaphore de l'ensemble en mettant à jour le champ [b]sem_ctime[/b] dans la structure [b]semid_ds[/b] associée au jeu de sémaphores. Le processus appelant doit avoir des privilèges d'écriture sur le jeu de sémaphores Les processus en attente sont réveillés si [b]semval[/b] devient 0 ou augmente.[/col][/row][/table] [size=18] [b]Valeur renvoyée[/b] [/size] En cas d'échec, l'appel-système renvoie [b]-1[/b] et [b]errno[/b] contient le code d'erreur. Autrement, l'appel-système renvoie une valeur non-négative dépendant de l'argument [i]cmd :[/i] [b]GETNCNT[/b] [table][row][col]    [/col][col]la valeur de [b]semncnt .[/b][/col][/row][/table] [b]GETPID[/b] [table][row][col]    [/col][col]La valeur [b]sempid .[/b][/col][/row][/table] [b]GETVAL[/b] [table][row][col]    [/col][col]La valeur [b]semval .[/b][/col][/row][/table] [b]GETZCNT[/b] [table][row][col]    [/col][col]La valeur [b]semzcnt .[/b][/col][/row][/table]     Toutes les autres commandes [i]cmd[/i] renvoient zéro en cas de réussite. [size=18] [b]Erreurs[/b] [/size] [b]EACCES[/b] Le processus appelant n'a pas les privilèges nécessaires pour exécuter la commande [b]cmd .[/b] [b]EFAULT[/b] [b][i]arg .buf[/i][/b] [table][row][col]    [/col][col]ou [b][i]arg .array[/i][/b] pointent en dehors de l'espace d'adressage accessible.[/col][/row][/table] [b]EIDRM[/b] [table][row][col]    [/col][col]L'ensemble de sémaphores a été supprimé.[/col][/row][/table] [b]EINVAL[/b] [i]cmd[/i] [table][row][col]    [/col][col]ou [b]semid [/b] a une valeur illégale.[/col][/row][/table] [b]EPERM[/b] [table][row][col]    [/col][col]L'argument [i]cmd[/i] réclame les commandes [b]IPC_SET[/b] ou [b]IPC_RMID[/b] mais l'UID effectif du processus appelant n'a pas les privilèges adéquats.[/col][/row][/table] [b]ERANGE[/b] [table][row][col]    [/col][col]l'argument [i]cmd[/i] réclame les commandes [b]SETALL[/b] ou [b]SETVAL[/b] et la valeur de [b]semval[/b] (pour l'ensemble ou pour certains sémaphores) est inférieure à 0 ou supérieur à la valeur [b]SEMVMX .[/b][/col][/row][/table] [size=18] [b]Notes[/b] [/size] Les appels-système [b]IPC_INFO ,[/b] [b]SEM_STAT[/b] et [b]SEM_INFO[/b] sont utilisés par le programme [b]ipcs (8)[/b] pour fournir des informations sur les ressources allouées. Ceci peut changer dans le futur, en utilisant l'interface d'un système de fichiers proc.     Divers champs de la [i]struct[/i] semid_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] La limite suivante influe sur l'appel-système [b]semctl :[/b] [b]SEMVMX[/b] [table][row][col]    [/col][col]Valeur maximale pour [b]semval[/b] dépendant de l'implémentation (généralement 32767).[/col][/row][/table]     Pour améliorer la portabilité, il vaut mieux invoquer toujours [b]semctl[/b] avec quatre arguments. Sous Linux, la fonction [b]semctl[/b] n'est pas un véritable appel-système, mais est implémentée au moyen de l'appel-système commun [b]ipc (2).[/b] [size=18] [b]Conformité[/b] [/size] SVr4, SVID. SVr4 documente des conditions d'erreurs supplémentaires EINVAL et EOVERFLOW. [size=18] [b]Voir aussi[/b] [/size] [b]ipc (2),[/b] [b]semget (2),[/b] [b]semop (2),[/b] [b]ipc (5)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier