Provided by:
manpages-fr-dev_2.64.1-1_all 
NOM
flockfile, ftrylockfile, funlockfile - Verrouiller un flux FILE pour
stdio
SYNOPSIS
#include <stdio.h>
void flockfile(FILE *filehandle);
int ftrylockfile(FILE *filehandle);
void funlockfile(FILE *filehandle);
Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
All of the functions described on this page: _POSIX_C_SOURCE ||
_XOPEN_SOURCE || _BSD_SOURCE || _SVID_SOURCE
DESCRIPTION
The stdio functions are thread-safe. This is achieved by assigning to
each FILE object a lockcount and (if the lockcount is non-zero) an
owning thread. For each library call, these functions wait until the
FILE object is no longer locked by a different thread, then lock it, do
the requested I/O, and unlock the object again.
(Remarque : ce verrouillage n’a rien à voir avec le verrouillage de
fichier réalisé par des fonctions comme flock(2) et lockf(3).)
Tout ceci est invisible au programmeur en C, mais il existe deux
raisons de souhaiter un contrôle plus fin. D’une part, un thread peut
réaliser une série d’entrées/sorties interdépendantes, ces opérations
ne devant pas être interrompues par les entrées/sorties d’autres
threads. D’autre part, on peut désirer supprimer la surcharge induite
par ce verrouillage afin d’obtenir de meilleures performances.
To this end, a thread can explicitly lock the FILE object, then do its
series of I/O actions, then unlock. This prevents other threads from
coming in between. If the reason for doing this was to achieve greater
efficiency, one does the I/O with the non-locking versions of the stdio
functions: with getc_unlocked(3) and putc_unlocked(3) instead of
getc(3) and putc(3).
La fonction flockfile() attend jusqu’à ce que *filehandle ne soit plus
verrouillé par un autre thread, puis affecte *filehandle au thread
actuel, et incrémente le « compteur de verrouillage ».
La fonction funlockfile() décrémente le « compteur de verrouillage ».
La fonction ftrylockfile() est une version non bloquante de
flockfile(). Elle ne fait rien lorsqu’un autre thread est propriétaire
de *filehandle, sinon, elle se l’approprie et incrémente le « compteur
de verrouillage ».
VALEUR RENVOYÉE
La fonction ftrylockfile() renvoie zéro en cas de succès (le verrou a
été obtenu), et une valeur non nulle en cas d’échec.
ERREURS
Aucune.
CONFORMITÉ À
POSIX.1-2001.
DISPONIBILITÉ
Ces fonctions sont disponibles lorsque _POSIX_THREAD_SAFE_FUNCTIONS est
défini. Elles sont présentes dans la libc depuis la version 5.1.1 et
dans la glibc depuis la version 2.0.
VOIR AUSSI
unlocked_stdio(3)
TRADUCTION
Cette page de manuel a été traduite par Stéphan Rafin <stephan DOT
rafin AT laposte DOT net> en 2002, puis a été mise à jour par Alain
Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à
disposition sur http://manpagesfr.free.fr/.
Les mises à jour et corrections de la version présente dans Debian sont
directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
francophone de traduction de Debian.
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document
en utilisant la commande « man -L C <section> <page_de_man> ».
2007-07-26 LOCKFILE(3)