NOME
mkdir − cria um diretório
SINOPSE
#include
<sys/stat.h>
#include <sys/types.h>
int mkdir(const char *pathname, mode_t mode);
DESCRIÇÂO
mkdir tenta criar um diretório com o nome pathname.
mode especifica as permisssões de uso. Ela é modificada pelo processo umask na sua forma usual: a permissão de criação do arquivp é (mode & ~umask).
O novo diretório criado será propriedada da uid efetiva do processo. Se o diretório contendo o arquivo tem o bit set group id selecionado, ou se o arquivo de sistema é montado com semântica de grupo BSD, o novo diretório herdará a propriedade de grupo a partir desde paí; de outra forma ele será propriedade da gid efetiva do processo.
Se o diretório pai tem o bit set group id selecionado então determina a criação do novo diretório.
VALORES RETORNADOS
mkdir retorna zero em caso de sucesso, ou -1 se um error ocorreu (neste caso, errno é selecionado apropriadamente).
ERROS
|
EPERM |
O sistema de arquivos contendo pathname não suporta a criação de diretórios. | ||
|
EEXIST |
pathname já existe (não necessariamente como um diretório). Isto incluí o caso aonde pathname é uma ligação simbólica, quebrada ou não. | ||
|
EFAULT |
pathname aponta para fora do espaço de endereços acessível. | ||
|
EACCES |
O diretório pai não permite permissões de escrita para o processo, ou um dos diretórios em pathname não permite permissão de busca (execução). |
ENAMETOOLONG
pathname é longo demais.
|
ENOENT |
Um conponente de diretório em pathname não existe ou é uma ligação simbólica pendurada. |
ENOTDIR
Um componente usado como um diretório em pathname não é, na realidade, um diretório.
|
ENOMEM |
Memória do kernel insuficiente esta disponível. | ||
|
EROFS |
pathname refere-se a um arquivo em um sistema de arquivos somente de leitura. | ||
|
ELOOP |
Muitas ligações simbólicas são encontradas no pathname. | ||
|
ENOSPC |
O dispositivo contendo pathname não tem espaço, para novos diretórios. | ||
|
ENOSPC |
O novo diretório não pode ser criado por que o espaço de disco do usuário acabou. |
DE ACORDO COM
SVr4, POSIX, BSD, SYSV, X/OPEN. Na documentação adicional da SVr4 EIO, EMULTIHOP e condições de erro ENOLINK; POSIX.1 omite ELOOP.
Como existem muitas coisa obscuras no protocola NFS. Algunas delas afetam mkdir.
VEJA TAMBÉM
mkdir(1), chmod(2), mknod(2), mount(2), rmdir(2), stat(2), umask(2), unlink(2)
TRADUZIDO POR LDP-BR em 21/08/2000.
André L. Fassone Canova <lonelywolf [AT] blv.br> (tradução) xxxxxxxxxxxxxxxxxxxxxxxxx <xxx [AT] xxxxxx.xx> (revisão)