.\" -*- nroff -*-
.\"
.\" This manpage is Copyright (C) 1992 Drew Eckhardt;
.\"                               1993 Michael Haardt
.\"                               1993,1994 Ian Jackson.
.\" You may distribute it under the terms of the GNU General
.\" Public Licence. It comes with NO WARRANTY.
.\"
.TH MKDIR 2 "29/03/1994" "Linux 1.0" "Manual do Programador Linux "
.SH NOME
mkdir \- cria um diretório
.SH SINOPSE
.nf
.B #include <sys/stat.h>
.B #include <sys/types.h>
.\" .B #include <unistd.h>
.sp
.BI "int mkdir(const char *" pathname ", mode_t " mode );
.fi
.SH DESCRIÇÂO
.B mkdir
tenta criar um diretório com o nome
.IR pathname .

.I mode
especifica as permisssões de uso. Ela é modificada pelo processo
.BR umask
na sua forma usual: a permissão de criação do arquivp é
.BR "(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.

.SH "VALORES RETORNADOS"
.BR mkdir
retorna zero em caso de sucesso, ou -1 se um error ocorreu (neste caso,
.I errno
é selecionado apropriadamente).
.SH ERROS
.TP
.B EPERM
O sistema de arquivos contendo
.IR pathname
não suporta a criação de diretórios.
.TP
.B EEXIST
.I pathname
já existe (não necessariamente como um diretório).
Isto incluí o caso aonde
.I pathname
é uma ligação simbólica, quebrada ou não.
.TP
.B EFAULT
.IR pathname " aponta para fora do espaço de endereços acessível."
.TP
.B EACCES
O diretório pai não permite permissões de escrita para o processo,
ou um dos diretórios em
.IR pathname
não permite permissão de busca (execução).
.TP
.B ENAMETOOLONG
.IR pathname " é longo demais."
.TP
.B ENOENT
Um conponente de diretório em
.I pathname
não existe ou é uma ligação simbólica pendurada.
.TP
.B ENOTDIR
Um componente usado como um diretório em
.I pathname
não é, na realidade, um diretório.
.TP
.B ENOMEM
Memória do kernel insuficiente esta disponível.
.TP
.B EROFS
.I pathname
refere-se a um arquivo em um sistema de arquivos somente de leitura.
.TP
.B ELOOP
Muitas ligações simbólicas são encontradas no 
.IR pathname .
.TP
.B ENOSPC
O dispositivo contendo
.I pathname
não tem espaço, para novos diretórios.
.TP
.B ENOSPC
O novo diretório não pode ser criado por que o espaço de disco do usuário
acabou.
.SH "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.
.PP
Como existem muitas coisa obscuras no protocola NFS. Algunas
delas afetam
.BR mkdir .
.SH "VEJA TAMBÉM"
.BR mkdir (1),
.BR chmod (2),
.BR mknod (2),
.BR mount (2),
.BR rmdir (2),
.BR stat (2),
.BR umask (2),
.BR unlink (2)
.SH TRADUZIDO POR LDP-BR em 21/08/2000.
\&\fR\&\f(CWAndré L. Fassone Canova <lonelywolf@blv.com.br> (tradução)\fR
\&\fR\&\f(CWxxxxxxxxxxxxxxxxxxxxxxxxx <xxx@xxxxxx.xxx.xx> (revisão)\fR