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 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.