NOMBRE

       lockf - aplica, comprueba o elimina un bloqueo POSIX sobre un fichero abierto

SINOPSIS

       #include <sys/file.h>

       int lockf(int fd, int cmd, off_t len);

DESCRIPCIÓN

       Aplica,  comprueba  o  elimina un bloqueo POSIX sobre una sección de un fichero abierto.  El fichero está
       especificado por fd, un descriptor de fichero abierto para escritura, la acción por  cmd,  y  la  sección
       consiste  en  las  posiciones  de  byte  pos..pos+len-1,  si len es positivo, y pos-len..pos-1, si len es
       negativo, donde pos es la posición actual del fichero. Si len es cero, la sección se  extiende  desde  la
       posición actual del fichero al infinito, abarcando las posiciones actual y futura de «fin de fichero». En
       todos los casos, la sección se puede extender más alla del «fin de fichero» actual.

       En Linux, esta llamada es tan solo una interfaz para fcntl(2).  (En general, la relación  entre  lockf  y
       fcntl es indefinida.)

       Las operaciones válidas son:

       F_LOCK Establece un bloqueo exclusivo en la sección especificada del fichero.  Si (parte de) esta sección
              ya está bloqueada, la llamada se bloquea hasta que el bloqueo  anterior  sea  liberado.   Si  esta
              sección se solapa con una sección previamente bloqueada, ambas se fusionan.  Los bloqueos sobre el
              fichero son liberados tan pronto  como  el  proceso  que  mantiene  los  bloqueos  cierre  algunos
              descriptores de fichero para el fichero.  Un proceso hijo no hereda estos bloqueos.

       F_TLOCK
              Igual que F_LOCK pero la llamada nunca se bloquea y devuelve un error en su lugar si el fichero ya
              está bloqueado.

       F_ULOCK
              Desbloquea la sección indicada del fichero.  Ésto puede provocar  que  una  sección  bloqueada  se
              divida en dos secciones bloqueadas.

       F_TEST Comprueba el bloqueo: devuelve 0 si la sección especificada está desbloqueada o bloqueada por este
              proceso; devuelve -1 y asigna a errno el valor EACCES si otro proceso mantiene un bloqueo.

VALOR DEVUELTO

       En caso de éxito, se devuelve cero. En caso de error, se devuelve -1 y se modifica errno apropiadamente.

ERRORES

       EAGAIN El fichero está bloqueado y se especificó F_TLOCK o F_TEST, o se prohibe la  operación  porque  el
              fichero ha sido ubicado en memoria por otro proceso.

       EBADF  fd no es un descriptor de fichero abierto.

       EDEADLK
              La orden fue T_LOCK y esta operación de bloqueo causaría una situación de interbloqueo.

       EINVAL Se especificó una operación inválida en fd.

       ENOLCK Demasiados bloqueos de segmento abiertos, la tabla de bloqueos está llena.

CONFORME A

       SYSV, POSIX 1003.1-2001

VÉASE TAMBIÉN

       fcntl(2), flock(2)
       Pueden encontrarse también los ficheros locks.txt y mandatory.txt en /usr/src/linux/Documentation.