rmdir(2)

NOME
rmdir - apaga um diretório

BIBLIOTECA
Biblioteca C Padrão (libc, -lc)

SINOPSE
#include <unistd.h>

int rmdir(const char *caminho);

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 caminho não foi permitido ou um dos diretórios no prefixo de caminho de caminho não permitiu permissão de busca. (Veja também path_resolution(7).)

EBUSY
    caminho está atualmente em uso pelo sistema ou por algum processo que impede sua remoção. No Linux, isso significa que caminho atualmente é usado como um ponto de montagem ou é o diretório raiz do processo de chamada.

EFAULT
    caminho aponta para fora de seu espaço de endereços acessíveis.

EINVAL
    caminho tem . como último componente.

ELOOP
    Muitos links simbólicos foram encontrados na resolução de caminho.

ENAMETOOLONG
    caminho é muito longo.

ENOENT
    Um componente de diretório em caminho não existe ou é um link simbólico pendurado.

ENOMEM
    A memória do kernel disponível foi insuficiente.

ENOTDIR
    caminho, ou um componente usado como um diretório em caminho, não é, de fato, um diretório.

ENOTEMPTY
    caminho contém entradas além de . e ..; ou, caminho tem .. como seu componente final. POSIX.1 também permite EEXIST para esta condição.

EPERM
    O diretório contendo caminho 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 caminho não suporta a remoção de diretórios.

EROFS
    caminho refere-se a um diretório em um sistema de arquivos somente de leitura.

PADRÕES
POSIX.1-2024.

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 (https://www.gnu.org/licenses/gpl-3.0.html) 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 (debian-l10n-portuguese@lists.debian.org).