getxattr(2) System Calls Manual getxattr(2) BEZEICHNUNG getxattr, lgetxattr, fgetxattr - Den Wert eines erweiterten Attributs abfragen BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include ssize_t getxattr(const char *pfad, const char *name, void wert[.grosse], size_t grosse); ssize_t lgetxattr(const char *pfad, const char *name, void wert[.grosse], size_t grosse); ssize_t fgetxattr(int dd, const char *name, void wert[.grosse], size_t grosse); 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 vollstandige Ubersicht uber 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. grosse legt die Grosse dieses Puffers fest. Der Ruckgabewert des Aufrufs ist die Anzahl der in wert abgelegten Byte. lgetxattr() ist zu getxattr() identisch, ausser 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) zuruckgelieferte) dd bezieht. Ein erweitertes Attribut name ist eine mit Null abgeschlossene Zeichenkette. Der Name enthalt einen Namensraum-Vorsatz; es kann mehrere, getrennte Namensraume geben, die einem individuellem Inode zugeordnet sind. Der Wert eines erweiterten Attributs ist ein Stuck beliebiger Text- oder Binardaten, die mittels setxattr(2) zugewiesen wurden. Falls grosse als Null festgelegt ist, liefern diese Aufrufe die aktuelle Grosse des benannten erweiterten Attributs (und belassen wert unverandert). Dies kann zur Grossenbestimmung des Puffers verwandt werden, der in einem nachfolgenden Aufruf bereitgestellt wird. (Aber beachten Sie, dass sich der Attributwert zwischen zwei Aufrufen andern konnte, so dass es weiterhin notwendig ist, den Ruckkehrstatus des zweiten Aufrufs zu uberprufen.) RUCKGABEWERT Im Erfolgsfall liefern diese Aufrufe einen nicht negativen Wert, der die Grosse (in Byte) des Werts des erweiterten Attributs ist. Im Fehlerfall wird -1 zuruckgeliefert und errno gesetzt, um den Fehler zu kennzeichnen. FEHLER E2BIG Die Grosse des Attributwertes ist grosser als die maximal erlaubte Grosse; das Attribut kann nicht abgerufen werden. Dies kann auf Dateisystemen wie beispielsweise NFSv4 passieren, die sehr grosse Attributwerte unterstutzen. ENODATA Das benannte Attribut existiert nicht oder der Prozess hat keinen Zugriff auf dieses Attribut. ENOTSUP Erweiterte Attribute werden vom Dateisystem nicht unterstutzt oder sind deaktiviert. ERANGE Die grosse des Puffers wert ist zu klein, um das Ergebnis zu enthalten. Zusatzlich konnen 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) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . Linux man-pages 6.12 23. Juli 2024 getxattr(2)