NOMBRE

       flockfile, ftrylockfile, funlockfile - bloqueo sobre el objeto FILE de stdio

SINOPSIS

       #include <stdio.h>

       void flockfile(FILE *filehandle);
       int ftrylockfile(FILE *filehandle);
       void funlockfile(FILE *filehandle);

DESCRIPCIÓN

       Las funciones stdio son hilo-seguro. Ésto se consigue asignando a cada objeto FILE una cuenta de bloqueos
       (lockcount) y (si la cuenta es distinta de cero) un hilo que actúa de propietario.  Por cada llamada a la
       biblioteca,  estas funciones esperan hasta que el objeto FILE deje de estar bloqueado por algún otro hilo
       diferente, después lo bloquean, realizan la petición de E/S solicitada, y desbloquean el objeto de nuevo.

       (Nota: este bloqueo no tiene nada que ver  con  el  bloqueo  realizado  por  funciones  como  flock(2)  y
       lockf(3).)

       Todo  ésto  es  invisible  al  programador  de C, pero puede haber dos razones para querer un control más
       detallado. Por una parte, una serie de acciones de E/S de un hilo pueden ir juntas,  y  no  deberían  ser
       interrumpidas por la E/S de ningún otro hilo.  Por otra parte, la sobrecarga del bloqueo debería evitarse
       para lograr una mayor eficiencia.

       Para  este propósito, un hilo puede bloquear explícitamente el objeto FILE, realizar su serie de acciones
       de E/S, y después desbloquearlo. Ésto impide que otros hilos lo interrumpan. Si la razón para hacer  esto
       es lograr una mayor eficiencia, se debe realizar la E/S con las versiones no-bloqueantes de las funciones
       stdio: con getc_unlocked() y putc_unlocked() en lugar de getc() y putc().

       La  función  flockfile()  espera  a  que  *filehandle deje de estar bloqueado por otro hilo, hace al hilo
       actual propietario de *filehandle, e incrementa la cuenta de bloqueos.

       La función funlockfile() decrementa la cuenta de bloqueos.

       La función ftrylockfile() es una versión no-bloqueante de flockfile(). No hace nada en  el  caso  de  que
       otro  hilo sea el propietario de *filehandle, en otro caso obtiene la propiedad e incrementa la cuenta de
       bloqueos.

VALOR DEVUELTO

       La función ftrylockfile() devuelve cero cuando tiene éxito (obtuvo el bloqueo), y un  valor  distinto  de
       cero en caso de fallo.

ERRORES

       Ninguno.

DISPONIBILIDAD

       Estas  funciones  están disponibles cuando _POSIX_THREAD_SAFE_FUNCTIONS está definida. Están presentes en
       libc desde libc 5.1.1 y en glibc desde glibc 2.0.

CONFORME A

       POSIX.1

VÉASE TAMBIÉN

       unlocked_stdio(3)

                                                 18 octubre 2001                                     LOCKFILE(3)