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@blv.com.br>  (tradução)  xxxxxxxxxxxxxxxxxxxxxxxxx
       <xxx@xxxxxx.xxx.xx> (revisão)