Provided by: manpages-fr-dev_2.64.1-1_all bug

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)