BEZEICHNUNG¶

mkdir, mkdirat - ein Verzeichnis erzeugen

BIBLIOTHEK¶

Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT¶

#include <sys/stat.h>

int mkdir(const char *Pfadname, mode_t Modus);

#include <fcntl.h>           /* Definition der AT_*-Konstanten */
#include <sys/stat.h>

int mkdirat(int Verzdd, const char *Pfadname, mode_t Modus);

mkdirat():

    Seit Glibc 2.10:


        _POSIX_C_SOURCE >= 200809L


    Vor Glibc 2.10:


        _ATFILE_SOURCE

BESCHREIBUNG¶

mkdir() versucht, ein Verzeichnis mit dem Namen Pfadname zu erzeugen.

Das Argument Modus gibt den zu verwendenden Zugriffsmodus an (siehe inode(7)). Es wird wie üblich noch von der umask des Prozesses verändert: Ohne Standard-ACL ist der Zugriffsmodus des erzeugten Verzeichnisses (Modus & ~umask & 0777). Die Berücksichtigung weitere Modus-Bits des erzeugten Verzeichnisses hängen vom Betriebssystem ab. Für Linux gelten die folgenden ANMERKUNGEN.

Das neu erzeugte Verzeichnis trägt die effektive Benutzerkennung des Prozesses. Wenn das das neue Verzeichnis enthaltende Verzeichnis set-group-id gesetzt hat oder wenn das Dateisystem mit der BSD-Gruppensemantik eingehängt wurde (mount -o bsdgroups oder synonym mount -o grpid), erbt das neue Verzeichnis die Gruppeneigentümerschaft des Elternprozesses. Anderenfalls wird die effektive Gruppenkennung des erzeugenden Prozesses Besitzer des Verzeichnisses.

Wenn das Elternverzeichnis set-group-id gesetzt hat, wird das neue Verzeichnis dieses ebenfalls gesetzt haben.

RÜCKGABEWERT¶

mkdir() und mkdirat() geben bei Erfolg 0 zurück. Bei einem Fehler wird -1 zurückgegeben und errno gesetzt, um den Fehler anzuzeigen.

FEHLER¶

EACCES

Das Elternverzeichnis gibt dem Prozess keine Schreibberechtigung oder eines der Verzeichnisse in Pfadname erlaubt keine Suche. (Siehe auch path_resolution(7).)

EBADF

(mkdirat()) Der Pfadname ist relativ, aber Verzdd ist weder AT_FDCWD noch ein gültiger Dateideskriptor.

EDQUOT

Das Kontingent des Benutzers an Datenträgerblöcken oder Inodes auf dem Dateisystem ist ausgeschöpft.

EEXIST

Pfadname existiert bereits (jedoch nicht notwendigerweise als Verzeichnis). Das umfasst auch den Fall, dass Pfadname ein symbolischer Link ist – egal ob er ins Leere weist oder nicht.

EFAULT

Pfadname zeigt aus dem für Sie zugänglichen Adressraum heraus.

EINVAL

Die letzte Komponente (»basename«) von Pfadname des neuen Verzeichnisses ist ungültig (beispielsweise enthält sie Zeichen, die im zugrunde liegenden Dateisystem nicht erlaubt sind).

ELOOP

Bei der Auflösung von Pfadname wurden zu viele symbolische Links gefunden.

EMLINK

Die Anzahl von Links zum »Elternverzeichnis« würde LINK_MAX überschreiten.

ENAMETOOLONG

Pfadname war zu lang.

ENOENT

Eine Verzeichniskomponente von Pfadname existiert nicht oder ist ein toter symbolischer Link.

ENOMEM

Es war nicht genügend Kernelspeicher verfügbar.

ENOSPC

Das Gerät, welches Pfadname enthält, hat keinen Platz für ein neues Verzeichnis.

ENOSPC

Das neue Verzeichnis kann nicht erzeugt werden, da das Plattenkontingent des Benutzers erschöpft ist.

ENOTDIR

Eine als Verzeichnis benutzte Komponente von Pfadname ist kein Verzeichnis.

ENOTDIR

(mkdirat()) Pfadname ist relativ und Verzdd ist ein Dateideskriptor, der sich auf eine Datei bezieht, die kein Verzeichnis ist.

EPERM

Das Gerät, welches Pfadname enthält, erlaubt keine Erstellung von Verzeichnissen.

EROFS

Pfadname bezieht sich auf eine Datei auf einem schreibgeschützten Dateisystem.

VERSIONEN¶

Unter Linux, abgesehen von den Zugriffs-Bits, wird der Modus S_ISVTX ebenfalls anerkannt.

STANDARDS¶

POSIX.1-2008.

GESCHICHTE¶

mkdir()

SVr4, BSD, POSIX.1-2001.

mkdirat()

Linux 2.6.16, Glibc 2.4.

ANMERKUNGEN¶

Es gibt noch viele Ungereimtheiten im NFS zugrunde liegenden Protokoll. Einige davon betreffen mkdir().

SIEHE AUCH¶

mkdir(1), chmod(2), chown(2), mknod(2), mount(2), rmdir(2), stat(2), umask(2), unlink(2), acl(5), path_resolution(7)

ÜBERSETZUNG¶

Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Schulze <joey@infodrom.org>, Ralf Baumert <bau@heineken.chemie.uni-dortmund.de>, Daniel Kobras <kobras@linux.de>, Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>, Helge Kreutzmann <debian@helgefjell.de>, Mario Blättermann <mario.blaettermann@gmail.com> und Dr. Tobias Quathamer <toddy@debian.org> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.