NOMBRE

       flock - impone o elimina un candado de recomendación en un fichero abierto.

SINOPSIS

       #include <sys/file.h>

       int flock(int fd, int operation);

DESCRIPCIÓN

       Impone  o  elimina  un  candado  de recomendación (advisory lock) sobre el fichero abierto
       especificado por fd.  El parámetro operation puede tener uno de los siguientes valores:

              LOCK_SH   Pone un candado compartido.  Más de un proceso  puede  tener  un  candado
                        compartido para un fichero en un momento dado.

              LOCK_EX   Pone  un  candado exclusivo.  Solamente un proceso puede tener un candado
                        exclusivo para un fichero en un momento dado.

              LOCK_UN   Elimina un candado existente mantenido por este proceso.

       Una llamada a flock() puede bloquearse si otro proceso mantiene un  candado  incompatible.
       Para  hacer  una  solicitud  no  bloqueante, incluya LOCK_NB (mediante operaciones OR) con
       cualquiera de las operaciones de arriba.

       Un fichero no puede tener simultaneamente candados compartido y exclusivo.

       Los candados creados por flock() se asocian con un fichero, o, más concretamente, con  una
       entrada  de  la tabla de ficheros abiertos. Esto significa que los descriptores de fichero
       duplicados (creados con, por ejemplo, fork(2) o dup(2)) hacen referencia al mismo candado,
       y  este  candado  puede ser modificado o liberado usando cualquiera de estos descriptores.
       Además, el candado es bloqueado bien por una operación LOCK_UN explícita sobre  cualquiera
       de estos descriptores duplicados, o cuando todos estos descriptores han sido cerrados.

       Un  proceso  puede  tener  solamente  un tipo de candado (compartido o exclusivo) sobre un
       fichero.  Las llamadas posteriores a flock() sobre un fichero ya bloqueado convertirán  un
       candado existente al nuevo modo de bloqueo.

       Los candados creados con flock() se preservan tras un execve(2).

       Un  candado  compartido o exclusivo puede ponerse sobre un fichero sin importar el modo en
       el que fue abierto dicho fichero.

VALOR DEVUELTO

       En caso de éxito, cero, En caso de error, -1 , y se pone en errno un código apropiado.

ERRORES

       EWOULDBLOCK
              El fichero está encadenado  y la bandera LOCK_NB ha sido elegida.  TP EBADF  fd  no
              es un descriptor de fichero abierto.

       EINTR  Mientras  se  esperaba  por adquirir un candado, la llamada fue interrumpida por la
              notificación de una señal atrapada por un manejador.

       EINVAL operation no es válido.

       ENOLCK El núcleo se quedó sin memoria para almacenar registros de candados.

CONFORME A

       4.4BSD (la llamada al sistema flock(2) apareció por primera vez en 4.2BSD).   Una  versión
       de  flock(2),  posiblemente implementada en términos de fcntl(2), aparece en la mayoría de
       Unix's.

OBSERVACIONES

       flock(2) no impone candados en ficheros sobre NFS. Use fcntl(2) en  su  lugar:  funcionará
       sobre  NFS,  dada  una versión suficientemente reciente de Linux y un servidor que soporte
       candados.

       Desde la versión 2.0 del núcleo, flock(2) está implementada como una llamada al sistema en
       lugar  de  ser  emulada  en  la  biblioteca C de GNU como una llamada a fcntl(2).  Esto da
       verdadera semántica BSD: no hay interacción entre  los  tipos  de  candado  colocados  por
       flock(2) y fcntl(2), y flock(2) no detecta interbloqueo.

       flock(2)  coloca  candados de recomendación solamente; con los permisos adecuados sobre un
       fichero, un proceso es libre de ignorar el  uso  de  flock(2)  y  realizar  E/S  sobre  el
       fichero.

       Los  candados  de  flock(2)  y  fcntl(2)  tienen  semánticas diferentes con respecto a los
       procesos creados con fork y con respecto a dup(2).

VÉASE TAMBIÉN

       open(2), close(2), dup(2), execve(2), fcntl(2), fork(2), lockf(3)

       También están locks.txt y mandatory.txt en /usr/src/linux/Documentation.