.\" -*- coding: UTF-8 -*- .\" Copyright (C) Andreas Gruenbacher, February 2001 .\" Copyright (C) Silicon Graphics Inc, September 2001 .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getxattr 2 "23. Juli 2024" "Linux man\-pages 6.12" .SH BEZEICHNUNG getxattr, lgetxattr, fgetxattr \- Den Wert eines erweiterten Attributs abfragen .SH BIBLIOTHEK Standard\-C\-Bibliothek (\fIlibc\fP,\ \fI\-lc\fP) .SH ÜBERSICHT .nf \fB#include \fP .P \fBssize_t getxattr(const char *\fP\fIpfad\fP\fB, const char *\fP\fIname\fP\fB,\fP \fB void \fP\fIwert\fP\fB[.\fP\fIgröße\fP\fB], size_t \fP\fIgröße\fP\fB);\fP \fBssize_t lgetxattr(const char *\fP\fIpfad\fP\fB, const char *\fP\fIname\fP\fB,\fP \fB void \fP\fIwert\fP\fB[.\fP\fIgröße\fP\fB], size_t \fP\fIgröße\fP\fB);\fP \fBssize_t fgetxattr(int \fP\fIdd\fP\fB, const char *\fP\fIname\fP\fB,\fP \fB void \fP\fIwert\fP\fB[.\fP\fIgröße\fP\fB], size_t \fP\fIgröße\fP\fB);\fP .fi .SH BESCHREIBUNG Erweiterte Attribute sind \fIName\fP:\fIWert\fP\-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 \fBstat\fP(2)\-Daten) zugeordnet sind. Eine vollständige Übersicht über das Konzept der erweiterten Attribute kann in \fBxattr\fP(7) gefunden werden. .P \fBgetxattr\fP() fragt den Wert des durch \fIname\fP identifizierten erweiterten Attributs ab, der dem angegebenen \fIpfad\fP im Dateisystem zugeordnet ist. Der Attributwert wird in einem Puffer abgelegt, auf den \fIwert\fP zeigt. \fIgröße\fP legt die Größe dieses Puffers fest. Der Rückgabewert des Aufrufs ist die Anzahl der in \fIwert\fP abgelegten Byte. .P \fBlgetxattr\fP() ist zu \fBgetxattr\fP() identisch, außer im Falle eines symbolischen Links, bei dem der Link selber abgefragt wird, nicht die Datei, auf die er sich bezieht. .P \fBfgetxattr\fP() ist identisch zu \fBgetxattr\fP(), nur wird anstelle von \fIpfad\fP die offene Datei abgefragt, auf die sich der (durch \fBopen\fP(2) zurückgelieferte) \fIdd\fP bezieht. .P Ein erweitertes Attribut \fIname\fP 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 \fBsetxattr\fP(2) zugewiesen wurden. .P Falls \fIgröße\fP als Null festgelegt ist, liefern diese Aufrufe die aktuelle Größe des benannten erweiterten Attributs (und belassen \fIwert\fP 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.) .SH RÜCKGABEWERT Im Erfolgsfall liefern diese Aufrufe einen nicht negativen Wert, der die Größe (in Byte) des Werts des erweiterten Attributs ist. Im Fehlerfall wird \-1 zurückgeliefert und \fIerrno\fP gesetzt, um den Fehler zu kennzeichnen. .SH FEHLER .TP \fBE2BIG\fP 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. .TP \fBENODATA\fP .\" .RB ( ENOATTR .\" is defined to be a synonym for .\" .BR ENODATA .\" in .\" .IR .) Das benannte Attribut existiert nicht oder der Prozess hat keinen Zugriff auf dieses Attribut. .TP \fBENOTSUP\fP Erweiterte Attribute werden vom Dateisystem nicht unterstützt oder sind deaktiviert. .TP \fBERANGE\fP Die \fIgröße\fP des Puffers \fIwert\fP ist zu klein, um das Ergebnis zu enthalten. .P Zusätzlich können die in \fBstat\fP(2) dokumentierten Fehler auftreten. .SH STANDARDS Linux. .SH GESCHICHTE .\" .SH AUTHORS .\" Andreas Gruenbacher, .\" .RI < a.gruenbacher@computer.org > .\" and the SGI XFS development team, .\" .RI < linux-xfs@oss.sgi.com >. .\" Please send any bug reports or comments to these addresses. Linux 2.4, glibc 2.3. .SH BEISPIELE Siehe \fBlistxattr\fP(2). .SH "SIEHE AUCH" \fBgetfattr\fP(1), \fBsetfattr\fP(1), \fBlistxattr\fP(2), \fBopen\fP(2), \fBremovexattr\fP(2), \fBsetxattr\fP(2), \fBstat\fP(2), \fBsymlink\fP(7), \fBxattr\fP(7) .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .