NOME

unlink - apaga um nome e talvez o arquivo ao qual se refere

SINOPSE

#include <unistd.h>

int unlink(const char *pathname);

DESCRIÇÃO

unlink apaga um nome a partir do sistema de arquivos. Se aquele nome tem a última ligação simbólica para uma arquivo e não processa o arquivo aberto, o arquivo é deletado e o espaço dele é feito disponível para ser reutilizado.

Se o nome tem uma última ligação para um arquivo mas qualquer processo tem o arquivo aberto o arquivo ficará existente até o último descritor de arquivo referenciado para ele ser fechado.

Se o nome referenciado para uma ligação simbólica é um ligação removida.

Se o nome referenciado para um socket, fifo ou dispositivo foi removido mas processos que têm o objeto aberto podem continuar usá-lo.

VALORES RETORNADOS

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

ERROS

EACCES

Acesso de escrita para o diretório contendo pathname não é permitido para uid efetivas de processos, ou um dos diretórios em pathname não tem permissão de procura (execução).

EPERM ou EACCES

O diretório contendo pathname tem um bit contrário selecionado (S_ISVTX) e a uid efetiva do processo é nenhuma uid do arquivo para ser apagado não naquele diretório que o contém.

EPERM

O arquivo pathname é um diretório.

EFAULT

pathname aponta para fora do espaço de endereços acessível para você.

ENAMETOOLONG

pathname é muito longo.

ENOENT

Um diretório componente no pathname não existe ou é uma ligação simbólica rompida.

ENOTDIR

Um componente usado com um diretório em pathname não é, de fato, um diretório.

EISDIR

pathname refere-se a um diretório.

ENOMEM

Memória do kernel disponível é insuficiente.

EROFS

pathname refere-se para um arquivo em um sistema de arquivos somente de leitura.

ELOOP

Muitas ligações simbólicas são encontradas na tradução do pathname.

EIO

Um erro de E/S ocorreu.

DE ACORDO COM

SVr4, SVID, POSIX, X/OPEN, 4.3BSD. SVr4 documenta as condições de erros adicionais EBUSY, EINTR, EMULTIHOP, ETXTBUSY, ENOLINK.

PROBLEMAS

Infelicidades no protocolo base do NFS pode causar o inesperado desaparecimento de arquivos que ainda estão sendo usados.

VEJA TAMBÉM

link(2), rename(2), open(2), rmdir(2), mknod(2), mkfifo(3), remove(3), rm(1)

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)