.\" -*- 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 setxattr 2 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم setxattr, lsetxattr, fsetxattr \- تعيين قيمة سمة ممتدة .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBint setxattr(\fPsize_t size; \fB const char *\fP\fIpath\fP\fB, const char *\fP\fIname\fP\fB,\fP \fB const void \fP\fIvalue\fP\fB[\fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB, int \fP\fIflags\fP\fB);\fP \fBint lsetxattr(\fPsize_t size; \fB const char *\fP\fIpath\fP\fB, const char *\fP\fIname\fP\fB,\fP \fB const void \fP\fIvalue\fP\fB[\fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB, int \fP\fIflags\fP\fB);\fP \fBint fsetxattr(\fPsize_t size; \fB int \fP\fIfd\fP\fB, const char *\fP\fIname\fP\fB,\fP \fB const void \fP\fIvalue\fP\fB[\fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB, int \fP\fIflags\fP\fB);\fP .fi .SH الوصف السمات الممتدة هي أزواج \fIالاسم\fP:\fIالقيمة\fP المرتبطة بالفهارس (الملفات، المجلدات، الروابط الرمزية، إلخ). وهي امتدادات للسمات العادية المرتبطة بكافة الفهارس في النظام (أي بيانات \fBstat\fP(2)). يمكن العثور على نظرة شاملة لمفاهيم السمات الممتدة في \fBxattr\fP(7). .P \fBsetxattr\fP() يضبط \fIvalue\fP للسمة الممتدة المُعرَّفة بـ \fIname\fP والمرتبطة بـ \fIpath\fP المُعطى في نظام الملفات. تُحدد الوسيطة \fIsize\fP الحجم (بالبايت) لـ \fIvalue\fP؛ يُسمح بقيمة طولها صفر. .P \fBlsetxattr\fP() مطابق لـ \fBsetxattr\fP()، باستثناء حالة الارتباط الرمزي، حيث تُضبط السمة الممتدة على الارتباط نفسه، وليس الملف الذي يشير إليه. .P \fBfsetxattr\fP() مطابق لـ \fBsetxattr\fP()، لكن تُضبط السمة الممتدة على الملف المفتوح المشار إليه بـ \fIfd\fP (كما يُعاد بواسطة \fBopen\fP(2)) بدلاً من \fIpath\fP. .P اسم السمة الممتدة هو سلسلة منتهية بقيمة خالية. يتضمن \fIname\fP بادئة نطاق أسماء؛ قد توجد عدة نطاقات أسماء منفصلة مرتبطة بعقدة فهرسة فردية. \fIvalue\fP للسمة الممتدة هو جزء من بيانات نصية أو ثنائية عشوائية بطول محدد. .P بشكل مبدئي (أي، \fIflags\fP يساوي صفر)، تُنشأ السمة الممتدة إذا لم تكن موجودة، أو يُستبدل \fIvalue\fP إذا كانت السمة موجودة بالفعل. لتعديل هذه الدلالات، يمكن تحديد إحدى القيم التالية في \fIflags\fP: .TP \fBXATTR_CREATE\fP ينفذ إنشاءً خالصًا، يفشل إذا كانت السمة المُسماة موجودة بالفعل. .TP \fBXATTR_REPLACE\fP ينفذ عملية استبدال خالصة، تفشل إذا كانت السمة المُسماة غير موجودة بالفعل. .SH "قيمة الإرجاع" يُعاد صفر عند النجاح. ويُعاد \-1 عند الفشل وتُضبط \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء .TP \fBEDQUOT\fP حدود حصة القرص تعني عدم وجود مساحة كافية متبقية لتخزين السمة الممتدة. .TP \fBEEXIST\fP حُدد \fBXATTR_CREATE\fP، والسمة موجودة بالفعل. .TP \fBENODATA\fP .\" .RB ( ENOATTR .\" is defined to be a synonym for .\" .BR ENODATA .\" in .\" .IR .) حُدد \fBXATTR_REPLACE\fP، والسمة غير موجودة. .TP \fBENOSPC\fP لا توجد مساحة كافية متبقية لتخزين السمة الممتدة. .TP \fBENOTSUP\fP بادئة نطاق الأسماء لـ \fIname\fP غير صالحة. .TP \fBENOTSUP\fP السمات الممتدة غير مدعومة من قبل نظام الملفات، أو معطلة، .TP \fBEPERM\fP الملف معلم بأنه غير قابل للتغيير أو للإلحاق فقط. (انظر \fBFS_IOC_SETFLAGS\fP(2const).) .P بالإضافة إلى ذلك، يمكن أن تحدث أيضًا الأخطاء الموثقة في \fBstat\fP(2). .TP \fBERANGE\fP حجم \fIname\fP أو \fIvalue\fP يتجاوز حدًا خاصًا بنظام الملفات. .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 "انظر أيضًا" \fBgetfattr\fP(1), \fBsetfattr\fP(1), \fBgetxattr\fP(2), \fBlistxattr\fP(2), \fBopen\fP(2), \fBremovexattr\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 .