Manpages

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 [AT] blv.br> (tradução) Fábio Henrique F. Silva <fabiohfs [AT] mail.com> (revisão)