NOME

       flock - aplica ou remove uma trava consultiva em um arquivo aberto

SINOPSE

       #include <sys/file.h>

       int flock(int fd, int operation)

DESCRIÇÃO

       Aplica ou remove uma trava consultiva em um arquivo aberto. O arquivo especificado por fd.
       As opereções válidas são fornecidas abaixo:

              LOCK_SH   Trava compartilhada. Mais que um processo  pode  influênciar  influenciar
                        uma trava compartilhada para um arquivo fornecido em um dado tempo.

              LOCK_EX   Trava  exclusiva. Somente um processo pode influênciar um trava exclusiva
                        para um arquivo fornecido em um dado tempo.

              LOCK_UN   Destrava.

              LOCK_NB   Não bloqueia quando travado. Pode ser expecificado (por ou'ing) junto com
                        uma das outra operações.

       Um arquivo não pode simultâneamente ter ambos tipos de trava: compartilhada e exclusiva.

       Um arquivo é travado (quer dizer, o inode), não é o descritor de arquivos. Assim, dup(2) e
       fork(2) não cria multiplas instâncias de uma trava.

VALORES RETORNADOS

       Em caso de sucesso,  zero  é  retornado.  Caso  contrário,  -1  é  retornado,  e  errno  é
       selecionado adequadamente.

ERROS

       EWOULDBLOCK
              O arquivo esta travado e o sinalizador LOCK_NB foi selecionado.

DE ACORDO COM

       4.4BSD (a chamada flock(2) apareceu primeiramente no BSD 4.2).

NOTAS

       flock(2) não trava arquivos via NFS. Use fcntl(2) : que pode trabalhar via NFS, fornecendo
       uma versão suficientemente recente do Linux e  um  servidor  que  suporta  travamentos  de
       arquivos.

       flock(2)  e  fcntl(2)  tem semânticas diferentes com respeito para processos ramificados e
       dup(2).

VEJA TAMBÉM

       open(2), close(2), dup(2), execve(2), fcntl(2), fork(2), lockf(3).  Além disso locks.txt e
       mandatory.txt em /usr/src/linux/Documentation.

TRADUZIDO POR LDP-BR em 21/08/2000.

       André  L.  Fassone  Canova  <lonelywolf@blv.com.br>  (tradução)  xxxxxxxxxxxxxxxxxxxxxxxxx
       <xxx@xxxxxx.xxx.xx> (revisão)