Dizinler mkdir işlevi ile oluşturulur. (Ayrıca, aynı şeyi yapan mkdir adında bir kabuk komutu vardır.)
int mkdir
(const char *dosyaismi,
mode_t kip)
işlev
mkdir işlevi dosyaismi isimli bir yeni ve boş bir dizin oluşturur.
kip argümanı ile yeni dizin dosyasının izinleri belirtilir. Bunun hakkında daha fazla bilgi için Erişim İzinleri için Kip Bitleri bölümüne bakınız.
0 dönüş değeri işlevin başarılı olduğunu, -1 ise bir hata oluştuğunu gösterir. Dosya ismi hatalarına ek olarak aşağıdaki errno hata durumları bu işlev için tanımlanmıştır:
EACCES
Yeni dizinin ekleneceği dizin için yazma izniniz yok.
EEXIST
dosyaismi isminde bir dosya zaten var.
EMLINK
Yeni dizinin ekleneceği dizin çok fazla girdi içeriyor.
İyi tasarlanmış dosya sistemleri bu hatayı asla döndürmez, çünkü onlar diskinizin tutabileceğinden çok daha fazla girdiye izin verirler. Ancak yine de bu hatayı alabileceğinizi hesaba katmalısınız, çünkü sonuç ağ üzerinden erişilen başka bir makineden gelebilir.
ENOSPC
Yeni dizini oluşturmak için dosya sisteminde yer yok.
EROFS
Yeni dizinin ekleneceği dizin bir salt-okunur bağlı dosya sisteminde ve bu değiştirilemez.
Bu işlevi kullanmak için yazılımınıza sys/stat.h başlık dosyasını dahil etmelisiniz.