.\" -*- coding: UTF-8 -*- .\" Copyright 1993 Giorgio Ciucci (giorgio@crcc.it) .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified 1996-10-22, Eric S. Raymond .\" Modified 2002-01-08, Michael Kerrisk .\" Modified 2003-04-28, Ernie Petrides .\" Modified 2004-05-27, Michael Kerrisk .\" Modified, 11 Nov 2004, Michael Kerrisk .\" Language and formatting clean-ups .\" Added notes on /proc files .\" 2005-04-08, mtk, Noted kernel version numbers for semtimedop() .\" 2007-07-09, mtk, Added an EXAMPLE code segment. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH semop 2 "3 mai 2023" "Pages du manuel de Linux 6.05.01" .SH NOM semop, semtimedop \- Opérations sur les sémaphores System\ V .SH BIBLIOTHÈQUE Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP) .SH SYNOPSIS .nf \fB#include \fP .PP \fBint semop(int \fP\fIsemid\fP\fB, struct sembuf *\fP\fIsops\fP\fB, size_t \fP\fInsops\fP\fB);\fP \fBint semtimedop(int \fP\fIsemid\fP\fB, struct sembuf *\fP\fIsops\fP\fB, size_t \fP\fInsops\fP\fB,\fP \fB const struct timespec *_Nullable \fP\fItimeout\fP\fB);\fP .fi .PP .RS -4 Exigences de macros de test de fonctionnalités pour la glibc (consulter \fBfeature_test_macros\fP(7))\ : .RE .PP \fBsemtimedop\fP(): .nf _GNU_SOURCE .fi .SH DESCRIPTION Chaque sémaphore dans un ensemble de sémaphores System\ V se voit associer les valeurs suivantes\ : .PP .in +4n .EX unsigned short semval; /* Valeur du sémaphore */ unsigned short semzcnt; /* # Attente pour zéro */ unsigned short semncnt; /* # Attente d'incrément */ pid_t sempid; /* PID du dernier processus modifiant la valeur du sémaphore */ .EE .in .PP La fonction \fBsemop\fP() effectue des opérations sur les membres de l'ensemble de sémaphores identifié par \fIsemid\fP. Chacun des \fInsops\fP éléments dans le tableau pointé par \fIsops\fP indique une opération à effectuer sur un sémaphore en utilisant une structure \fIstruct sembuf\fP contenant les membres suivants\ : .PP .in +4n .EX unsigned short sem_num; /* Numéro du sémaphore */ short sem_op; /* Opération sur le sémaphore */ short sem_flg; /* Options pour l'opération */ .EE .in .PP Les options possibles pour \fIsem_flg\fP sont \fBIPC_NOWAIT\fP et \fBSEM_UNDO\fP. Si une opération indique l'option \fBSEM_UNDO\fP, elle sera annulée lorsque le processus se terminera. .PP L'ensemble des opérations contenues dans \fIsops\fP est effectué \fIdans l'ordre\fP et \fIatomiquement\fP. Les opérations sont toutes réalisées en même temps, et seulement si elles peuvent toutes être effectuées. Le comportement de l'appel système, si toutes les opérations ne sont pas réalisables, dépend de la présence de l'attribut \fBIPC_NOWAIT\fP dans les champs \fIsem_flg\fP décrits plus bas. .PP Chaque opération est effectuée sur le \fIsem_num\fP\-ième sémaphore de l'ensemble. Le premier sémaphore est le numéro\ 0. Pour chaque sémaphore, l'opération est l'une des trois décrites ci\-dessous. .PP Si l'argument \fIsem_op\fP est un entier positif, la fonction ajoute cette valeur à \fIsemval\fP. De plus si \fBSEM_UNDO\fP est demandé, le système soustrait la valeur \fIsem_op\fP à la valeur de mise à jour du sémaphore (\fIsemadj\fP). Cette opération n'est jamais bloquante. Le processus appelant doit avoir l'autorisation de modification sur le jeu de sémaphores. .PP Si \fIsem_op\fP vaut zéro le processus doit avoir l'autorisation de lecture sur l'ensemble de sémaphores. Le processus attend que \fIsemval\fP soit nul\ : si \fIsemval\fP vaut zéro, l'appel système continue immédiatement. Sinon, si l'on a réclamé \fBIPC_NOWAIT\fP dans \fIsem_flg\fP, l'appel système \fBsemop\fP() échoue et \fIerrno\fP contient le code d'erreur \fBEAGAIN\fP (et aucune des opérations de \fIsops\fP n'est réalisée). Sinon, \fIsemzcnt\fP (le décompte de threads en attente jusqu'à ce que cette valeur de sémaphore devienne zéro) est incrémenté d'un et le thread s'endort jusqu'à ce que l'un des événements suivants se produise\ : .IP \- 3 \fIsemval\fP devient égal à\ 0, alors \fIsemzcnt\fP est décrémenté. .IP \- Le jeu de sémaphores est supprimé. L'appel système échoue et \fIerrno\fP contient le code d'erreur \fBEIDRM\fP. .IP \- Le thread reçoit un signal à intercepter, la valeur de \fIsemzcnt\fP est décrémentée et l'appel système échoue avec \fIerrno\fP contenant le code d'erreur \fBEINTR\fP. .PP Si \fIsem_op\fP est inférieur à zéro, le processus appelant doit avoir l'autorisation de modification sur le jeu de sémaphores. Si \fIsemval\fP est supérieur ou égal à la valeur absolue de \fIsem_op\fP, la valeur absolue de \fIsem_op\fP est soustraite de \fIsemval\fP, et si \fBSEM_UNDO\fP est indiqué, le système ajoute la valeur absolue de \fIsem_op\fP à la valeur de mise à jour de sémaphore (\fIsemadj\fP) pour ce sémaphore. Si la valeur absolue de \fIsem_op\fP est plus grande que \fIsemval\fP et si l'on a réclamé \fBIPC_NOWAIT\fP dans \fIsem_flg\fP, l'appel système échoue et \fIerrno\fP contient le code d'erreur \fBEAGAIN\fP (et aucune des opérations de \fIsops\fP n'est réalisée). Sinon, \fIsemncnt\fP (le décompte de threads en attente jusqu'à ce que cette valeur de sémaphore soit incrémenté) est incrémenté de un et le thread s'endort jusqu'à ce que l'un des événements suivants se produise\ : .IP \- 3 \fIsemval\fP devient supérieur ou égal à la valeur absolue de \fIsem_op\fP\ : l'opération est effectuée comme décrit ci\-dessus. .IP \- Le jeu de sémaphores est supprimé. L'appel système échoue et \fIerrno\fP contient le code d'erreur \fBEIDRM\fP. .IP \- Le thread reçoit un signal à intercepter, la valeur de \fIsemncnt\fP est décrémentée et l'appel système échoue avec \fIerrno\fP contenant le code d'erreur \fBEINTR\fP. .PP .\" and .\" .I sem_ctime En cas de succès, le membre \fIsempid\fP de chacun des sémaphores indiqués dans le tableau pointé par \fIsops\fP est rempli avec le PID de l'appelant. Enfin \fIsem_otime\fP est défini à l'heure actuelle. .SS semtimedop() La fonction \fBsemtimedop\fP() se comporte comme \fBsemop\fP() sauf que dans le cas où le thread doit dormir, la durée maximale du sommeil est limitée par la valeur spécifiée dans la structure \fItimespec\fP dont l'adresse est transmise dans le paramètre \fItimeout\fP (cet intervalle de sommeil sera arrondi à la granularité de l'horloge système, et les délais d'ordonnancement du noyau font que cette valeur peut être légèrement dépassée). Si la limite indiquée a été atteinte, l'appel système échoue avec \fIerrno\fP contenant \fBEAGAIN\fP (et aucune opération de \fIsops\fP n'est réalisée). Si le paramètre \fItimeout\fP est NULL, alors \fBsemtimedop\fP() se comporte exactement comme \fBsemop\fP(). .PP Si \fBsemtimedop\fP() est interrompu par un signal, causant l'échec de l'appel avec l'erreur \fBEINTR\fP, les valeurs contenues dans \fItimeout\fP restent inchangées. .SH "VALEUR RENVOYÉE" En cas de réussite, \fBsemop\fP() et \fBsemtimedop\fP() renvoient\ \fB0\fP. En cas d'échec, ils renvoient\ \fB\-1\fP et \fIerrno\fP contient le code d'erreur. .SH ERREURS .TP \fBE2BIG\fP l'argument \fInsops\fP est supérieur à \fBSEMOPM\fP, le nombre maximal d'opérations autorisées par appel système. .TP \fBEACCES\fP Le processus appelant n'a pas les permissions nécessaires pour effectuer les opérations sur les sémaphores spécifiés et n'a pas la capacité \fBCAP_IPC_OWNER\fP dans l'espace de noms utilisateur qui régit son espace de noms IPC. .TP \fBEAGAIN\fP Une opération ne pouvait pas être effectuée immédiatement et \fBIPC_NOWAIT\fP a été indiqué dans l'argument \fIsem_flg\fP, ou la durée limite indiquée dans \fItimeout\fP a expiré. .TP \fBEFAULT\fP \fIsops\fP ou \fItimeout\fP pointent en dehors de l'espace d'adressage accessible. .TP \fBEFBIG\fP La valeur de \fIsem_num\fP est inférieure à\ 0 ou supérieure ou égale au nombre de sémaphores dans l'ensemble. .TP \fBEIDRM\fP Le jeu de sémaphores a été supprimé. .TP \fBEINTR\fP Un signal a été reçu pendant l'attente\ ; consultez \fBsignal\fP(7). .TP \fBEINVAL\fP L'ensemble de sémaphores n'existe pas ou \fIsemid\fP est inférieur à zéro, ou \fInsops\fP n'est pas strictement positive. .TP \fBENOMEM\fP L'argument \fIsem_flg\fP de certaines opérations demande \fBSEM_UNDO\fP et le système n'a pas assez de mémoire pour allouer les structures nécessaires. .TP \fBERANGE\fP \fIsem_op+semval\fP est supérieur à \fBSEMVMX\fP (la valeur maximale de \fIsemval\fP autorisée par l'implémentation) pour l'une des opérations. .SH STANDARDS POSIX.1\-2008. .SH VERSIONS .\" SVr4 documents additional error conditions EINVAL, EFBIG, ENOSPC. Linux\ 2.5.52 (rétroportage dans Linux\ 2.4.22), glibc\ 2.3.3. POSIX.1\-2001, SVr4. .SH NOTES Les structures \fIsem_undo\fP d'un processus ne sont pas héritées par ses enfants lors d'un \fBfork\fP(2), mais elles le sont lors d'un appel système \fBexecve\fP(2). .PP \fBsemop\fP() n'est jamais relancé automatiquement après avoir été interrompu par un gestionnaire de signal quelque soit l'attribut \fBSA_RESTART\fP durant l'installation du gestionnaire. .PP Une valeur de mise à jour de sémaphore (\fIsemadj\fP) est un entier propre à un processus et sémaphore, qui représente le compte négatif des opérations utilisant l'attribut \fBSEM_UNDO\fP. Chaque processus dispose d'une liste de valeurs \fIsemadj\fP \[em] une valeur pour chaque sémaphore où \fBSEM_UNDO\fP a été utilisé. Quand un processus se termine, chacune des valeurs \fIsemadj\fP de ses sémaphores est ajoutée au sémaphore correspondant, annulant ainsi l'effet des opérations du processus sur le sémaphore (voir la section BOGUES ci\-dessous). Quand la valeur d'un sémaphore est définie directement par une requête \fBSETVAL\fP ou \fBSETALL\fP de \fBsemctl\fP(2), la valeur \fIsemadj\fP correspondante est effacée dans tous les processus. L'option \fBCLONE_SYSVSEM\fP de \fBclone\fP(2) permet à plusieurs processus de partager une liste de \fIsemadj\fP. Consultez \fBclone\fP(2) pour plus d'informations. .PP Les valeurs \fIsemval\fP, \fIsempid\fP, \fIsemzcnt\fP et \fIsemnct\fP pour un sémaphore peuvent être retrouvées avec des appels \fBsemctl\fP(2) spécifiques. .SS "Limites des sémaphores" Les limites suivantes de ressources concernent l'appel système \fBsemop\fP()\ : .TP \fBSEMOPM\fP .\" commit e843e7d2c88b7db107a86bd2c7145dc715c058f4 .\" This /proc file is not available in Linux 2.2 and earlier -- MTK .\" See comment in Linux 3.19 source file include/uapi/linux/sem.h Nombre maximal d'opérations pour un appel à \fBsemop\fP. Avant Linux\ 3.19, la valeur par défaut pour cette limite était de\ 32. Depuis Linux\ 3.19, cette valeur est de\ 500. Sous Linux, cette limite peut être lue et modifiée via le troisième champ du fichier \fI/proc/sys/kernel/sem\fP. \fINote\fP\ : cette limite ne devrait pas être augmentée au\-delà de 1000 à cause du risque que \fBsemop\fP() échoue en raison de la fragmentation de la mémoire du noyau pendant l'allocation de mémoire pour copier le tableau \fIsops\fP. .TP \fBSEMVMX\fP Valeur maximale pour \fIsemval\fP\ : dépendante de l'implémentation (32767). .PP L'implémentation n'a pas de limites intrinsèques pour la valeur maximale d'effacement en sortie (\fBSEMAEM\fP), le nombre de structures d'annulation sur le système (\fBSEMMNU\fP) et le nombre maximal de structures d'annulation pour un processus. .SH BOGUES Quand un processus se termine, l'ensemble des structures \fIsemadj\fP qui lui sont associées servent à annuler les effets de toutes les opérations sur les sémaphores réalisées avec l'attribut \fBSEM_UNDO\fP. Cela pose un problème\ : si l'une (ou plusieurs) des modifications sur les sémaphores demande une descente du compteur d'un sémaphore au\-dessous de zéro, que doit faire l'implémentation\ ? Une approche possible consiste à bloquer jusqu'à ce que la modification du sémaphore soit possible. C'est néanmoins peu désirable, car la terminaison du processus peut alors bloquer pendant une période arbitrairement longue. Une autre possibilité est d'ignorer la modification du sémaphore (comme un échec lorsque \fBIPC_NOWAIT\fP est spécifié durant une opération). Linux adopte une troisième approche\ : décroître la valeur du sémaphore autant que possible (jusqu'à zéro) et permettre au processus de se terminer immédiatement. .PP .\" The bug report: .\" http://marc.theaimsgroup.com/?l=linux-kernel&m=110260821123863&w=2 .\" the fix: .\" http://marc.theaimsgroup.com/?l=linux-kernel&m=110261701025794&w=2 Dans Linux\ 2.6.x (x <=\ 10) un bogue peut, dans certaines circonstances, empêcher un thread, attendant que la valeur d'un sémaphore s'annule, d'être réveillé quand cette valeur atteint\ 0. Ce bogue est corrigé dans le Linux\ 2.6.11. .SH EXEMPLES Le bout de code suivant utilise \fBsemop\fP() pour attendre de façon atomique que la valeur du sémaphore\ 0 vaille zéro, puis incrémente la valeur du sémaphore de un. .PP .in +4n .EX struct sembuf sops[2]; int semid; \& /* Le code pour configurer \fIsemid\fP est omis */ \& sops[0].sem_num = 0; /* Agir sur le sémaphore 0 */ sops[0].sem_op = 0; /* Attendre que la valeur soit égale à 0 */ sops[0].sem_flg = 0; \& sops[1].sem_num = 0; /* Agir sur le sémaphore 0 */ sops[1].sem_op = 1; /* Incrémenter la valeur de un */ sops[1].sem_flg = 0; \& if (semop(semid, sops, 2) == \-1) { perror("semop"); exit(EXIT_FAILURE); } .EE .in .PP Un autre exemple de l'usage de \fBsemop\fP() peut être trouvé dans \fBshmop\fP(2). .SH "VOIR AUSSI" \fBclone\fP(2), \fBsemctl\fP(2), \fBsemget\fP(2), \fBsigaction\fP(2), \fBcapabilities\fP(7), \fBsem_overview\fP(7), \fBsysvipc\fP(7), \fBtime\fP(7) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot , Thomas Vincent et Jean-Pierre Giraud . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .