.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (C) 2001 Andries Brouwer <aeb@cwi.nl>.
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH flockfile 3 "20 ​​Julio 2023" "Páginas de manual de Linux 6.05.01" 
.SH NOMBRE
flockfile, ftrylockfile, funlockfile \- bloqueo sobre el objeto FILE de stdio
.SH BIBLIOTECA
Biblioteca Estándar C (\fIlibc\fP, \fI\-lc\fP)
.SH SINOPSIS
.nf
\fB#include <stdio.h>\fP
.PP
\fBvoid flockfile(FILE *\fP\fIfilehandle\fP\fB);\fP
\fBint ftrylockfile(FILE *\fP\fIfilehandle\fP\fB);\fP
\fBvoid funlockfile(FILE *\fP\fIfilehandle\fP\fB);\fP
.fi
.PP
.RS -4
Requisitos de Macros de Prueba de Características para glibc (véase
\fBfeature_test_macros\fP(7)):
.RE
.PP
A continuación se muestran todas las funciones:
.nf
    /* Since glibc 2.24: */ _POSIX_C_SOURCE >= 199309L
        || /* glibc <= 2.23: */ _POSIX_C_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.SH DESCRIPCIÓN
Las funciones stdio son hilo\-seguro. Ésto se consigue asignando a cada
objeto \fIFILE\fP 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 \fIFILE\fP 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.
.PP
(Nota: este bloqueo no tiene nada que ver con el bloqueo realizadopor
funciones como \fBflock\fP(2) y \fBlockf\fP(3).)
.PP
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.
.PP
Para este propósito, un hilo puede bloquear explícitamente el objeto
\fIFILE\fP, 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 \fBgetc_unlocked\fP(3) y
\fBputc_unlocked\fP(3) en lugar de \fBgetc\fP(3) y \fBputc\fP(3).
.PP
La función \fBflockfile\fP() espera a que \fI*filehandle\fP deje de estar
bloqueado por otro hilo, hace al hilo actual propietario de \fI*filehandle\fP,
e incrementa la cuenta de bloqueos.
.PP
La función \fBfunlockfile\fP() decrementa la cuenta de bloqueos.
.PP
La función \fBftrylockfile\fP() es una versión no\-bloqueante de
\fBflockfile\fP(). No hace nada en el caso de que otro hilo sea el propietario
de \fI*filehandle\fP, en otro caso obtiene la propiedad e incrementa la cuenta
de bloqueos.
.SH "VALOR DEVUELTO"
La función \fBftrylockfile\fP() devuelve cero cuando tiene éxito (obtuvo el
bloqueo), y un valor distinto de cero en caso de fallo.
.SH ERRORES
Ninguno.
.SH ATRIBUTOS
Para obtener una explicación de los términos usados en esta sección, véase
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interfaz	Atributo	Valor
T{
.na
.nh
\fBflockfile\fP(),
\fBftrylockfile\fP(),
\fBfunlockfile\fP()
T}	Seguridad del hilo	Multi\-hilo seguro
.TE
.sp 1
.SH ESTÁNDARES
POSIX.1\-2008.
.SH HISTORIAL
POSIX.1\-2001.
.PP
Estas funciones están disponibles cuando \fB_POSIX_THREAD_SAFE_FUNCTIONS\fP
está definida.
.SH "VÉASE TAMBIÉN"
\fBunlocked_stdio\fP(3)
.PP
.SH TRADUCCIÓN
La traducción al español de esta página del manual fue creada por
Miguel Pérez Ibars <mpi79470@alu.um.es>
.
.PP
Esta traducción es documentación libre; lea la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
o posterior con respecto a las condiciones de copyright.
No existe NINGUNA RESPONSABILIDAD.
.PP
Si encuentra algún error en la traducción de esta página del manual, envíe un
correo electrónico a
.MT debian-l10n-spanish@lists.debian.org
.ME .