BEZEICHNUNG¶

ÜBERSICHT¶

#include <sys/stat.h>

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


int fchmod(int dd, mode_t Modus);
#include <fcntl.h>           /* Definition der AT_*-Konstanten */
#include <sys/stat.h>

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

Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

fchmod():

fchmodat():

BESCHREIBUNG¶

• chmod() ändert den Modus der angegebenen Datei, deren Pfadname in Pfadname übergeben wird. Falls sie ein symbolischer Link ist, wird dieser dereferenziert.
• fchmod() ändert den Modus der über den offenen Dateideskriptor dd angegebenen Datei.

Der neue Dateimodus wird in der Bit-Maske Modus angegeben, welche durch ODER-Verknüpfung von null oder mehr der Folgenden erstellt wird:

S_ISUID (04000)

Set-User-ID (setzt die effektive Benutzerkennung des Prozesses bei execve(2))

S_ISGID (02000)

Set-Group-ID (setzt die effektive Gruppenkennung für execve(2); sperrt obligatorisch, wie in fcntl(2) beschrieben; bestimmt die Gruppe der Datei aus dem Elternverzeichnis, wie in chown(2) und mkdir(2) beschrieben

S_ISVTX (01000)

»Sticky Bit« (Schalter für eingeschränktes Löschen, wie in unlink(2) beschrieben)

S_IRUSR (00400)

Leserechte für Eigentümer

S_IWUSR (00200)

Schreibrechte für Eigentümer

S_IXUSR (00100)

Ausführungs-/Schreibrechte für Eigentümer (»suchen« trifft für Verzeichnisse zu und bedeutet, dass auf Einträge innerhalb des Verzeichnisses zugegriffen werden kann)

S_IRGRP (00040)

Leserechte für Gruppe

S_IWGRP (00020)

Schreibrechte für Gruppe

S_IXGRP (00010)

Ausführungs-/Schreibrechte für Gruppe

S_IROTH (00004)

Leserechte für andere

S_IWOTH (00002)

Schreibrechte für andere

S_IXOTH (00001)

Ausführungs-/Schreibrechte für andere

Die effektive UID des aufrufenden Prozesses muss auf den Eigentümer der Datei passen oder der Prozess muss privilegiert sein (Linux: er muss über die Capability (Fähigkeit) CAP_FOWNER verfügen).

Falls der aufrufende Prozess nicht privilegiert ist (Linux: er verfügt nicht über die Capability CAP_FSETID) und die Gruppe der Datei nicht auf die effektive Gruppenkennung des Prozesses oder einer seiner zusätzlichen Gruppenkennungen passt, dann wird das Bit S_ISGID ausgeschaltet werden, ohne dass ein Fehler zurückgegeben wird.

Als Sicherheitsmaßnahme können je nach Dateisystem die Set-User-ID- und Set-Group-ID-Ausführungsbits ausgeschaltet werden, wenn eine Datei geschrieben wird. (Unter Linux geschieht das, wenn der schreibende Prozess nicht über die CAP_FSETID-Capability verfügt.) Bei einigen Dateisystemen kann nur der Superuser das Sticky-Bit setzen, das möglicherweise eine besondere Bedeutung hat. Für das Sticky-Bit, das Set-User-ID-Bit und das Set-Group-ID-Bit für Verzeichnisse siehe inode(7).

Für NFS-Dateisysteme wirkt sich eine Beschränkung der Rechte sofort auf schon geöffnete Dateien aus, weil die Zugriffssteuerung auf dem Server erfolgt, der Client sich aber um die offenen Dateien kümmert. Die Erweiterung der Rechte kann für andere Clients verschoben werden, wenn für sie die Zwischenspeicherung der Attribute aktiviert wurde.

RÜCKGABEWERT¶

FEHLER¶

Die allgemeineren Fehler bei chmod() sind im Folgenden aufgeführt:

EACCES

Eine Komponente des Pfad-Präfix darf nicht durchsucht werden. (Siehe auch path_resolution(7).)

EFAULT

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

EIO

Es ist ein E/A-Fehler (engl. I/O) aufgetreten.

ELOOP

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

ENAMETOOLONG

Pfadname ist zu lang.

ENOENT

Die Datei existiert nicht.

ENOMEM

Es war nicht genügend Kernelspeicher verfügbar.

ENOTDIR

Eine Komponente des Pfad-Präfixes ist kein Verzeichnis.

EPERM

Die effektive UID passt nicht auf den Eigentümer der Datei und der Prozess ist nicht privilegiert (Linux: Er verfügt nicht über die Capability CAP_FOWNER).

EPERM

Die Datei ist als unveränderlich oder nur-anhängbar markiert (siehe ioctl_iflags(2)).

EROFS

Die angegebene Datei befindet sich auf einem nur lesbaren (read-only) Dateisystem.

Die allgemeinen Fehler bei fchmod() sind im Folgenden aufgeführt:

EBADF

Der Dateideskriptor dd ist ungültig.

EIO

Siehe oben.

EPERM

Siehe oben.

EROFS

Siehe oben.

Die gleichen Fehler, die bei chmod() auftreten, können auch bei fchmodat() auftreten. Die folgenden zusätzlichen Fehler können bei fchmodat() auftreten:

EBADF

Verzdd ist kein zulässiger Dateideskriptor.

EINVAL

Unzulässiger Schalter in Schalter angegeben.

ENOTDIR

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

ENOTSUP

Schalter spezifizierte AT_SYMLINK_NOFOLLOW, was nicht unterstützt wird.

VERSIONEN¶

KONFORM ZU¶

fchmodat(): POSIX.1-2008.

ANMERKUNGEN¶

SIEHE AUCH¶

KOLOPHON¶

ÜBERSETZUNG¶

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.