getxattr(2)

BEZEICHNUNG
getxattr, lgetxattr, fgetxattr - Den Wert eines erweiterten Attributs abfragen

BIBLIOTHEK
Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT
#include <sys/xattr.h>

ssize_t getxattr(size_t größe;
                 const char *pfad, const char *name,
                 void wert[größe], size_t größe);
ssize_t lgetxattr(size_t größe;
                 const char *pfad, const char *name,
                 void wert[größe], size_t größe);
ssize_t fgetxattr(size_t größe;
                 int fd, const char *name,
                 void wert[größe], size_t größe);

BESCHREIBUNG
Erweiterte Attribute sind Name:Wert-Paare, die Inodes (Dateien, Verzeichnissen, symbolischen Links usw.) zugeordnet sind. Sie sind eine Erweiterung der normalen Attribute, die allen Inodes im System (d.h. allen stat(2)-Daten) zugeordnet sind. Eine vollständige Übersicht über das Konzept der erweiterten Attribute kann in xattr(7) gefunden werden.

getxattr() fragt den Wert des durch name identifizierten erweiterten Attributs ab, der dem angegebenen pfad im Dateisystem zugeordnet ist. Der Attributwert wird in einem Puffer abgelegt, auf den wert zeigt. größe legt die Größe dieses Puffers fest. Der Rückgabewert des Aufrufs ist die Anzahl der in wert abgelegten Byte.

lgetxattr() ist zu getxattr() identisch, außer im Falle eines symbolischen Links, bei dem der Link selber abgefragt wird, nicht die Datei, auf die er sich bezieht.

fgetxattr() ist identisch zu getxattr(), nur wird anstelle von pfad die offene Datei abgefragt, auf die sich der (durch open(2) zurückgelieferte) dd bezieht.

Ein erweitertes Attribut name ist eine mit Null abgeschlossene Zeichenkette. Der Name enthält einen Namensraum-Vorsatz; es kann mehrere, getrennte Namensräume geben, die einem individuellem Inode zugeordnet sind. Der Wert eines erweiterten Attributs ist ein Stück beliebiger Text- oder Binärdaten, die mittels setxattr(2) zugewiesen wurden.

Falls größe als Null festgelegt ist, liefern diese Aufrufe die aktuelle Größe des benannten erweiterten Attributs (und belassen wert unverändert). Dies kann zur Größenbestimmung des Puffers verwandt werden, der in einem nachfolgenden Aufruf bereitgestellt wird. (Aber beachten Sie, dass sich der Attributwert zwischen zwei Aufrufen ändern könnte, so dass es weiterhin notwendig ist, den Rückkehrstatus des zweiten Aufrufs zu überprüfen.)

RÜCKGABEWERT
Im Erfolgsfall liefern diese Aufrufe einen nichtnegativen Wert, der die Größe (in Byte) des Werts des erweiterten Attributs ist. Im Fehlerfall wird -1 zurückgeliefert und errno gesetzt, um den Fehler zu kennzeichnen.

FEHLER

E2BIG
    Die Größe des Attributwertes ist größer als die maximal erlaubte Größe; das Attribut kann nicht abgerufen werden. Dies kann auf Dateisystemen wie beispielsweise NFSv4 passieren, die sehr große Attributwerte unterstützen.

ENODATA
    Das benannte Attribut existiert nicht oder der Prozess hat keinen Zugriff auf dieses Attribut.

ENOTSUP
    Erweiterte Attribute werden vom Dateisystem nicht unterstützt oder sind deaktiviert.

ERANGE
    Die größe des Puffers wert ist zu klein, um das Ergebnis zu enthalten.

Zusätzlich können die in stat(2) dokumentierten Fehler auftreten.

STANDARDS
Linux.

GESCHICHTE
Linux 2.4, glibc 2.3.

BEISPIELE
Siehe listxattr(2).

SIEHE AUCH
getfattr(1), setfattr(1), listxattr(2), open(2), removexattr(2), setxattr(2), stat(2), symlink(7), xattr(7)

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) 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: debian-l10n-german@lists.debian.org.