rmdir(2) | System Calls Manual | rmdir(2) |
NOME
rmdir - apaga um diretório
BIBLIOTECA
Biblioteca C Padrão (libc, -lc)
SINOPSE
#include <unistd.h>
int rmdir(const char *pathname);
DESCRIÇÃO
rmdir() apaga um diretório, o qual deve estar vazio.
VALOR DE RETORNO
Em caso de sucesso, zero é retornado. Em caso de erro, -1 é retornado, e errno é definido para indicar o erro.
ERROS
- EACCES
- Acesso de escrita para o diretório contendo pathname não foi permitido ou um dos diretórios no prefixo de caminho de pathname não permitiu permissão de busca. (Veja também path_resolution(7).)
- EBUSY
- pathname está atualmente em uso pelo sistema ou por algum processo que impede sua remoção. No Linux, isso significa que pathname atualmente é usado como um ponto de montagem ou é o diretório raiz do processo de chamada.
- EFAULT
- pathname aponta para fora do seu espaço de endereços acessíveis.
- EINVAL
- pathname tem . como último componente.
- ELOOP
- Muitos links simbólicos são encontrados ao resolver pathname.
- ENAMETOOLONG
- pathname é longo demais.
- ENOENT
- Um componente de diretório em pathname não existe ou é um link simbólico pendurado.
- ENOMEM
- A memória do kernel disponível foi insuficiente.
- ENOTDIR
- pathname, ou um componente usado como um diretório em pathname, não é, de fato, um diretório.
- ENOTEMPTY
- pathname contém entradas além de . e ..; ou, pathname tem .. como seu componente final. POSIX.1 também permite EEXIST para esta condição.
- EPERM
- O diretório contendo pathname tem o bit "sticky" selecionado (S_ISVTX) e o ID de usuário efetivo do processo não é nem o ID do usuário do arquivo a ser apagado nem do diretório que o contém, e o processo não possui privilégios (Linux: não tem a capacidade CAP_FOWNER).
- EPERM
- O sistema de arquivos contendo pathname não suporta a remoção de diretórios.
- EROFS
- pathname refere-se a um diretório em um sistema de arquivos somente de leitura.
PADRÕES
POSIX.1-2008.
HISTÓRICO
POSIX.1-2001, SVr4, 4.3BSD.
BUGS
Problemas no protocolo base NFS podem provocar desaparecimentos inesperados de diretórios que ainda estão em uso.
VEJA TAMBÉM
rm(1), rmdir(1), chdir(2), chmod(2), mkdir(2), rename(2), unlink(2), unlinkat(2)
TRADUÇÃO
A tradução para português brasileiro desta página man foi criada por André Luiz Fassone <lonely_wolf@ig.com.br>, Marcelo Pereira da Silva <marcelo@pereira.com> e Rafael Fontenelle <rafaelff@gnome.org>.
Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.
Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.
2 maio 2024 | Linux man-pages 6.8 |