Linux x86_64Sistema de arquivos#263
unlinkat
Como unlink (ou rmdir, com AT_REMOVEDIR), mas resolve o caminho relativo a um descritor de diretório.
Descrição
Parte da família *at(); unifica remoção de arquivos e diretórios em uma única syscall selecionada por flag.
man 2Desde o kernel 2.6.16
Assinatura
int unlinkat(int dirfd, const char * pathname, int flags);Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| dirfd | int | Descritor do diretório base, ou AT_FDCWD. |
| pathname | const char * | Caminho, absoluto ou relativo a `dirfd`. |
| flags | int | 0 ou AT_REMOVEDIR (para remover um diretório, como rmdir). |
Registradores (x86_64)
| Registrador | Papel | Argumento |
|---|---|---|
| rax | número da syscall (chamada) / valor de retorno (após SYSCALL) | — |
| rdi | argumento 1 | dirfdint |
| rsi | argumento 2 | pathnameconst char * |
| rdx | argumento 3 | flagsint |
Valor de retorno
0 em sucesso; -1 em erro, com errno definido.
Códigos de erro (errno)
- EACCES(13)
- Permissão negada.
- EBADF(9)
- Descritor de arquivo inválido.
- EBUSY(16)
- Dispositivo ou recurso ocupado.
- ENOENT(2)
- Arquivo ou diretório inexistente.
- ENOTEMPTY(39)
- Diretório não vazio.