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)