fchownat()¶

Der Systemaufruf fchownat() funktioniert genauso wie chown, außer den hier beschriebenen Unterschieden.

Falls der in Pfadname übergebene Pfadname relativ ist wird er als relativ zu dem im Dateideskriptor dirfd referenzierten Verzeichnis interpretiert (statt relativ zum aktuellen Arbeitsverzeichnis des aufrufenden Prozesses, wie es bei chown() für einen relativen Pfadnamen erfolgt).

Falls Pfadname relativ ist und dirfd den besonderen Wert AT_FDCWD annimmt wird Pfadname als relativ zum aktuellen Arbeitsverzeichnis des aufrufenden Prozesses interpretiert (wie chown()).

Falls Pfadname absolut ist, wird Verzdd ignoriert.

Das Schalter-Argument ist eine Bitmaske, die durch bitweises ODER null oder mehr der folgenden Werte enthält:

AT_EMPTY_PATH (seit Linux 2.6.39)

Falls Pfadname eine leere Zeichenkette ist, wird mit der Datei gearbeitet, auf die dirfd verweist (dies kann mit dem O_PATH-Schalter von open(2) ermittelt werden). In diesem Fall kann sich dirfd auf jeden Dateityp beziehen, nicht nur einem Verzeichnis. Falls dirfd AT_FDCWD ist, erfolgt der Aufruf im aktuellen Arbeitsverzeichnis. Dieser Schalter ist Linux-spezifisch; definieren Sie _GNU_SOURCE, um dessen Definition zu ermitteln.

AT_SYMLINK_NOFOLLOW

Wenn pathanme ein symbolischer Link ist, wird er nicht dereferenziert: es wird stattdessen mit dem Link selbst gearbeitet, wie bei lchown(). In der Voreinstellung dereferenziert fchownat() symbolische Links, wie chown().

Lesen Sie openat(2) für eine Beschreibung der Notwendigkeit von fchownat().

Eigentümerschaft neuer Dateien¶

Wenn eine neue Datei erzeugt wird (zum Beispiel durch open(2) oder mkdir(2)), wird der Eigentümer der gleiche wie die Dateisystem-Benutzer-ID des erzeugenden Prozesses. Die Gruppe der Datei hängt von einer Reihe von Faktoren ab, einschließlich der Art des Dateisystems, den beim Einhängen des Dateisystems verwendeten Optionen und der (Nicht-) Aktivierung des Set-Group-ID-Modusbits für das Elternverzeichnis. Falls das Dateisystem die Optionen -o grpid (oder synonym -o bsdgroups) und -o 0grpid (oder synonym -o sysvgroups) von mount(8) unterstützt, dann sind die Vorschriften wie folgt:

• Falls das Dateisystem mit -o grpid eingehängt wurde, wird die Gruppe der neuen Datei vom Elternverzeichnis übernommen.
• Falls das Dateisystem mit -o nogrpid eingehängt wurde und das Set-Group-ID-Bit wurde für das Elternverzeichnis deaktiviert, wird die Gruppe einer neuen Datei auf die Dateisystem-GID des Prozesses gesetzt.
• Falls das Dateisystem mit -o nogrpid eingehängt wurde und das Set-Group-ID-Bit wurde für das Elternverzeichnis aktiviert, wird die Gruppe einer neuen Datei vom Elternverzeichnis übernommen.

Unter Linux 4.12 werden die Einhängeoptionen -o grpid und -o nogrpid von ext2, ext3, ext4 und XFS unterstützt. Dateisysteme, die diese Optionen nicht unterstützen, folgen den -o nogrpid-Regeln.

Anmerkungen zur Glibc¶

Mit älteren Kernels, in denen fchownat() nicht verfügbar ist, weicht die Glibc-Wrapper-Funktion auf chown() und lchown() aus. Wenn Pfadname ein relativer Pfadname ist, dann konstruiert die Glibc einen Pfadnamen, der auf jenem symbolischen Link in /proc/self/fd, der dem Argument dirfd entspricht.

NFS¶

Die Semantik von chown() wird auf NFS-Dateisystemen mit aktiviertem UID-Mapping bewusst verletzt. Außerdem wird bei allen Systemaufrufen, die auf den Dateiinhalt zugreifen, die Semantik verletzt, da chown() einen sofortigen Entzug des Zugriffs bei bereits geöffneten Dateien bewirken kann. Zwischenspeicherung (Caching) seitens des Clients kann zu einer Verzögerung zwischen dem Zeitpunkt der Änderung der Besitzverhältnisse, um einem Benutzer Zugriff zu ermöglichen, und dem Zeitpunkt, zu dem er auf anderen Clients tatsächlich zugreifen kann, führen.

Geschichtliche Details¶

Die ursprünglichen Linux-Systemaufrufe chown(), fchown() und lchown() unterstützten nur 16-Bit-Benutzer- und Gruppenkennungen. Anschließend fügte Linux 2.4 chown32(), fchown32() und lchown32() zur Unterstützung von 32-Bit-Kennungen hinzu. Die Glibc-Wrapper-Funktionen chown(), fchown() und lchown() gehen transparent mit den Variationen zwischen den Kernel-Versionen um.

In Linux-Versionen vor 2.1.81 (außer 2.1.46) folgte chown() nicht symbolischen Links. Seit Linux 2.1.81 folgt chown() symbolischen Links und es gibt einen neuen Systemaufruf lchown(), der symbolischen Links nicht folgt. Ab Linux 2.1.86 hat dieser neue Aufruf (der die gleiche Semantik wie das alte chown() hat) die gleiche Systemaufruf-Nummer (syscall number) und chown() erhielt die neu eingeführte Nummer.

Programmquelltext¶

#include <pwd.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
int
main(int argc, char *argv[])
{


    uid_t uid;


    struct passwd *pwd;


    char *endptr;


    if (argc != 3 || argv[1][0] == '\0') {


        fprintf(stderr, "%s <Eigentümer> <Datei>\n", argv[0]);


        exit(EXIT_FAILURE);


    }


    uid = strtol(argv[1], &endptr, 10); /* eine numerische Zeichenkette


                                           erlauben */


    if (*endptr != '\0') {         /* String war nicht rein numerisch */


        pwd = getpwnam(argv[1]);   /* versuchen, UID für den Benutzernamen


                                      zu bestimmen */


        if (pwd == NULL) {


            perror("getpwnam");


            exit(EXIT_FAILURE);


        }


        uid = pwd->pw_uid;


    }


    if (chown(argv[2], uid, -1) == -1) {


        perror("chown");


        exit(EXIT_FAILURE);


    }


    exit(EXIT_SUCCESS);
}