.\" -*- coding: UTF-8 -*- .\" Copyright 2001, Andreas Grünbacher .\" Copyright 2001, Silicon Graphics, Inc. .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getxattr 2 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم getxattr, lgetxattr, fgetxattr \- استرداد قيمة سمة ممتدة .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBssize_t getxattr(\fPsize_t size; \fB const char *\fP\fIpath\fP\fB, const char *\fP\fIname\fP\fB,\fP \fB void \fP\fIvalue\fP\fB[\fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB);\fP \fBssize_t lgetxattr(\fPsize_t size; \fB const char *\fP\fIpath\fP\fB, const char *\fP\fIname\fP\fB,\fP \fB void \fP\fIvalue\fP\fB[\fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB);\fP \fBssize_t fgetxattr(\fPsize_t size; \fB int \fP\fIfd\fP\fB, const char *\fP\fIname\fP\fB,\fP \fB void \fP\fIvalue\fP\fB[\fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB);\fP .fi .SH الوصف السمات الممتدة هي أزواج \fIالاسم\fP:\fIالقيمة\fP المرتبطة بالفهارس (الملفات، المجلدات، الروابط الرمزية، إلخ). وهي امتدادات للسمات العادية المرتبطة بكافة الفهارس في النظام (أي بيانات \fBstat\fP(2)). يمكن العثور على نظرة شاملة لمفاهيم السمات الممتدة في \fBxattr\fP(7). .P \fBgetxattr\fP() يسترد قيمة السمة الممتدة المعرفة بـ \fIname\fP والمرتبطة بـ \fIpath\fP المعطى في نظام الملفات. توضع قيمة السمة في المخزن المؤقت المشار إليه بـ \fIvalue\fP؛ يحدد \fIsize\fP حجم ذلك المخزن المؤقت. قيمة إرجاع الاستدعاء هي عدد البايتات الموضوعة في \fIvalue\fP. .P \fBlgetxattr\fP() مطابق لـ \fBgetxattr\fP()، باستثناء حالة الارتباط الرمزي، حيث يُستجوب الرابط نفسه، وليس الملف الذي يشير إليه. .P \fBfgetxattr\fP() مطابق لـ \fBgetxattr\fP()، فقط الملف المفتوح المشار إليه بـ \fIfd\fP (كما يُرجع بواسطة \fBopen\fP(2)) يُستجوب بدلاً من \fIpath\fP. .P السمة الممتدة \fIname\fP هي سلسلة منتهية بقيمة خالية. يتضمن الاسم بادئة نطاق أسماء؛ قد يكون هناك عدة نطاقات أسماء منفصلة مرتبطة بعقدة inode فردية. قيمة السمة الممتدة هي قطعة من بيانات نصية أو ثنائية عشوائية تم تعيينها باستخدام \fBsetxattr\fP(2). .P إذا تم تحديد \fIsize\fP كصفر، تُرجع هذه الاستدعاءات الحجم الحالي للسمة الممتدة المسماة (وتترك \fIvalue\fP دون تغيير). يمكن استخدام هذا لتحديد حجم المخزن المؤقت الذي يجب توفيره في استدعاء لاحق. (لكن، ضع في اعتبارك أن هناك احتمالًا أن تتغير قيمة السمة بين الاستدعاءين، لذلك لا يزال من الضروري التحقق من حالة الإرجاع من الاستدعاء الثاني.) .SH "قيمة الإرجاع" عند النجاح، تُرجع هذه الاستدعاءات قيمة غير سالبة وهي حجم (بالبايت) قيمة السمة الممتدة. عند الفشل، يُرجع \-1 ويُضبط \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء .TP \fBE2BIG\fP حجم قيمة السمة أكبر من الحجم الأقصى المسموح به؛ لا يمكن استرداد السمة. يمكن أن يحدث هذا في أنظمة الملفات التي تدعم قيم سمات كبيرة جدًا مثل NFSv4، على سبيل المثال. .TP \fBENODATA\fP .\" .RB ( ENOATTR .\" is defined to be a synonym for .\" .BR ENODATA .\" in .\" .IR .) السمة المسماة غير موجودة، أو لا تملك العملية وصولًا إلى هذه السمة. .TP \fBENOTSUP\fP السمات الموسعة غير مدعومة من قبل نظام الملفات، أو أنها معطلة. .TP \fBERANGE\fP حجم \fIsize\fP للمخزن المؤقت \fIvalue\fP صغير جدًا لاستيعاب النتيجة. .P بالإضافة إلى ذلك، يمكن أن تحدث أيضًا الأخطاء الموثقة في \fBstat\fP(2). .SH المعايير لينكس. .SH التاريخ .\" .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. لينكس 2.4، glibc 2.3. .SH أمثلة انظر \fBlistxattr\fP(2). .SH "انظر أيضًا" \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 ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .