.\" -*- coding: UTF-8 -*- .\"Copyright (c) 2010 Novell Inc., written by Robert Schweikert .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH pthread_rwlockattr_setkind_np 3 "31 octobre 2023" "Pages du manuel de Linux 6.06" .SH NOM pthread_rwlockattr_setkind_np, pthread_rwlockattr_getkind_np — Définir ou obtenir le type de verrou en lecture/écriture de l'objet d'attribut verrou de thread .SH BIBLIOTHÈQUE Bibliothèque de threads POSIX (\fIlibpthread\fP, \fI\-lpthread\fP) .SH SYNOPSIS .nf \fB#include \fP .P \fBint pthread_rwlockattr_setkind_np(pthread_rwlockattr_t *\fP\fIattr\fP\fB,\fP \fB int \fP\fIpref\fP\fB);\fP \fBint pthread_rwlockattr_getkind_np(\fP \fB const pthread_rwlockattr_t *restrict \fP\fIattr\fP\fB,\fP \fB int *restrict \fP\fIpref\fP\fB);\fP .P .fi .RS -4 Exigences de macros de test de fonctionnalités pour la glibc (consulter \fBfeature_test_macros\fP(7)) : .RE .P \fBpthread_rwlockattr_setkind_np\fP(), \fBpthread_rwlockattr_getkind_np\fP() : .nf _XOPEN_SOURCE >= 500 || _POSIX_C_SOURCE >= 200809L .fi .SH DESCRIPTION La fonction \fBpthread_rwlockattr_setkind_np\fP() définit, à la valeur indiquée par \fIpref\fP, l'attribut « lock kind » de l'objet d'attribut de thread verrou en lecture/écriture auquel \fIattr\fP fait référence. L'argument \fIpref\fP peut être défini à une des valeurs suivantes : .TP \fBPTHREAD_RWLOCK_PREFER_READER_NP\fP C'est l'option par défaut. Un thread peut posséder plusieurs verrous en lecture ; c'est\-à\-dire que les verrous en écriture sont récursifs. Selon la Single UNIX Specification, il y a un comportement non spécifié quand un lecteur essaye de placer un verrou et qu'il n'y a pas de verrou en écriture, mais que des écrivains sont en attente. Donner la préférence au lecteur, tel que défini par \fBPTHREAD_RWLOCK_PREFER_READER_NP\fP, implique que le lecteur recevra le verrou requis, même si un écrivain est en attente. Tant qu'il y a des lecteurs, l'écrivain ne sera pas alimenté. .TP \fBPTHREAD_RWLOCK_PREFER_WRITER_NP\fP .\" --- .\" Here is the relevant wording: .\" .\" A thread may hold multiple concurrent read locks on rwlock (that is, .\" successfully call the pthread_rwlock_rdlock() function n times). If .\" so, the thread must perform matching unlocks (that is, it must call .\" the pthread_rwlock_unlock() function n times). .\" .\" By making write-priority work correctly, I broke the above requirement, .\" because I had no clue that recursive read locks are permissible. .\" .\" If a thread which holds a read lock tries to acquire another read lock, .\" and now one or more writers is waiting for a write lock, then the algorithm .\" will lead to an obvious deadlock. The reader will be suspended, waiting for .\" the writers to acquire and release the lock, and the writers will be .\" suspended waiting for every existing read lock to be released. .\" --- .\" https://pubs.opengroup.org/onlinepubs/9699919799/functions/pthread_rwlock_rdlock.html .\" https://sourceware.org/legacy-ml/libc-alpha/2000-01/msg00055.html .\" https://sourceware.org/bugzilla/show_bug.cgi?id=7057 Cette option est censée être l'équivalent du verrou en écriture de \fBPTHREAD_RWLOCK_PREFER_READER_NP\fP. Elle est ignorée par la glibc parce que l'exigence de POSIX de la prise en charge des verrous récursifs en lecture pourrait faire que l'option provoque des blocages simples ; il est préférable d'utiliser \fBPTHREAD_RWLOCK_PREFER_WRITER_NONRECURSIVE_NP\fP qui assure que le développeur de l'application n'utilisera pas des verrous récursifs en écriture, évitant ainsi les blocages. .TP \fBPTHREAD_RWLOCK_PREFER_WRITER_NONRECURSIVE_NP\fP Définir le type de verrou à cette valeur évite que l'écrivain ne soit pas alimenté aussi longtemps qu'un verrouillage en lecture n'est pas fait de façon récursive. .P Les fonctions \fBpthread_rwlockattr_getkind_np\fP() renvoient dans le pointeur \fIpref\fP la valeur de l'attribut de type de verrou de l'objet d'attribut verrou en lecture/écriture auquel \fIattr\fP fait référence. .SH "VALEUR RENVOYÉE" En cas de succès, ces fonctions renvoient \fB0\fP. Si des arguments pointeur valables sont fournis, \fBpthread_rwlockattr_getkind_np\fP() réussit toujours. En cas d'erreur, \fBpthread_rwlockattr_setkind_np\fP() renvoie un code d'erreur différent de zéro. .SH ERREURS .TP \fBEINVAL\fP \fIpref\fP spécifie une valeur non admise. .SH STANDARDS GNU ; d'où le suffixe « _np » (non portable) dans leur nom. .SH HISTORIQUE glibc 2.1. .SH "VOIR AUSSI" \fBpthreads\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 , Frédéric Hantrais 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 .