rmdir - apaga um diretório
Biblioteca C Padrão (libc, -lc)
#include <unistd.h>
int rmdir(const char *pathname);
rmdir() apaga um diretório, o qual deve estar
vazio.
Em caso de sucesso, zero é retornado. Em caso de erro, -1
é retornado, e errno é definido para indicar o
erro.
- 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.
POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.
Problemas no protocolo base NFS podem provocar desaparecimentos
inesperados de diretórios que ainda estão em uso.
rm(1), rmdir(1), chdir(2), chmod(2),
mkdir(2), rename(2), unlink(2), unlinkat(2)
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.