Scroll to navigation

UNLINK(2) Manual do Programador Linux UNLINK(2)

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)
21/08/1997 Linux 2.0.30