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)