NOME

       close - fecha um descritor de arquivo

SINOPSE

       #include <unistd.h>

       int close(int fd);

DESCRIÇÃO

       close  fecha  um  descritor  de arquivos. Assim que ele não se refira a quaisquer arquivos
       poderá ser reusado. Qualquer bloqueio aplicado ao arquivo e de propriedade do  processo  é
       removido (independente do descritor de arquivo que foi usado para aplicar o bloqueio).

       Se  fd é a última cópia de um descritor de arquivos em particular os recursos associados a
       ele serão liberados; se um descritor tem a última referência para um arquivo  o  qual  foi
       removido usando e unlink(2) o arquivo é apaguado.

VALORES RETORNADOS

       close Em caso de sucesso, 0 é retornado, caso contrário -1 é retornado.

ERROS

       EBADF  fd não é um descritor de arquivo aberto válido.

DE ACORDO COM

       SVr4, SVID, POSIX, X/OPEN, BSD 4.3.  SVr4 documenta a condição de erro adicional ENOLINK.

NOTAS

       Não  checar  os  valores  retornados  do  fechamento  é  comum,  mas apesar disto, erro de
       programação grave. Implementações de sistemas de arquivos que usam técnicas como  ''write-
       behind'', para aumentar a performance, pode implicar no sucesso de write(2) , ainda que os
       dados não tenham sido gravados. O estado de erro pode ser  relatado  em  uma  operação  de
       escrita  posterior,  mas  é garantido ser relatado no fechamento do arquivo. Não checar os
       valores retornados ao fechar o arquivo pode implicar na perda silenciosa  de  dados.  Isto
       pode, especialmente, ser observado com NFS e cotas de disco.

       Um fechamento bem sucedido não garante que os dados tenham sido armazenados com sucesso no
       disco, já que o kernel adia escritas. Isto não é comum para um  sistema  de  arquivos  que
       esvazia  os  buffers  quando  o  fluxo é fechado. Se você precisa estar certo que os dados
       foram fisicamente armazenados use fsync(2) ou sync(2).

VEJA TAMBÉM

       open(2), fcntl(2), shutdown(2), unlink(2), fclose(3)

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

       André L.  Fassone  Canova  <lonelywolf@blv.com.br>  (tradução)  Fábio  Henrique  F.  Silva
       <fabiohfs@mail.com> (revisão)

                                            14/04/1996                                   CLOSE(2)