.\" -*- coding: UTF-8 -*- .\" Copyright 1996, Andries E. Brouwer .\" Copyright 2010, Jan Kara .\" Copyright 2010, Michael Kerrisk .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH quotactl 2 "19 أبريل 2026" "صفحات دليل لينكس 6.18" .SH الاسم quotactl, quotactl_fd \- معالجة حصص القرص .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP /* Definition of \fBQ_X*\fP and \fBXFS_QUOTA_*\fP constants (or \fB\fP; see NOTES) */ \fB#include \fP .P \fBint quotactl(int \fP\fIop\fP\fB, const char *_Nullable \fP\fIspecial\fP\fB, int \fP\fIid\fP\fB,\fP \fB caddr_t \fP\fIaddr\fP\fB);\fP .P \fB#include \fP /* Definition of \fBQ_X*\fP and \fBXFS_QUOTA_*\fP constants (or \fB\fP; see NOTES) */ \fB#include \fP /* Definition of \fBSYS_*\fP constants */ \fB#include \fP .P \fBint syscall(SYS_quotactl_fd, int \fP\fIfd\fP\fB, int \fP\fIop\fP\fB, int \fP\fIid\fP\fB, caddr_t \fP\fIaddr\fP\fB);\fP .fi .SH الوصف يمكن استخدام نظام الحصص لتعيين حدود لكل مستخدم، لكل مجموعة، ولكل مشروع على مقدار مساحة القرص المستخدمة في نظام الملفات. لكل مستخدم و/أو مجموعة، يمكن تعيين حد مرن وحد صارم لكل نظام ملفات. لا يمكن تجاوز الحد الصارم. يمكن تجاوز الحد المرن، ولكن ستظهر تحذيرات. علاوة على ذلك، لا يمكن للمستخدم تجاوز الحد المرن لمدة أطول من فترة السماح (أسبوع واحد مبدئيًا) في المرة الواحدة؛ بعد ذلك، يُحتسب الحد المرن كحد صارم. .P تتعامل استدعاءات \fBquotactl\fP() و \fBquotactl_fd\fP() مع حصص القرص. الفرق بين هاتين الدالتين هو طريقة تحديد نظام الملفات الذي تتم معالجته، انظر وصف الوسائط أدناه. انظر الملاحظات لمعرفة سبب تفضيل أحد المتغيرات على الآخر. .P .\" 847aac644e92e5624f2c153bab409bf713d5ff9a تشير وسيطة \fIop\fP إلى عملية سيتم تطبيقها على معرف المستخدم أو المجموعة المحدد في \fIid\fP. لتهيئة وسيطة \fIop\fP، استخدم الماكرو \fIQCMD(subop, type)\fP. قيمة \fItype\fP هي إما \fBUSRQUOTA\fP، لحصص المستخدمين، أو \fBGRPQUOTA\fP، لحصص المجموعات، أو (منذ Linux 4.1) \fBPRJQUOTA\fP، لحصص المشاريع. قيمة \fIsubop\fP موصوفة أدناه. .P بالنسبة لـ \fBquotactl\fP()، وسيطة \fIspecial\fP هي مؤشر لسلسلة منتهية بقيمة خالية تحتوي على اسم مسار جهاز الكتلة الخاص (الموصول) لنظام الملفات الذي تتم معالجته. .P بالنسبة لـ \fBquotactl_fd\fP()، وسيطة \fIfd\fP هي واصف ملف (يمكن فتحه مع العلم \fBO_PATH\fP) يشير إلى ملف أو دليل على نظام الملفات الذي تتم معالجته. .P وسيطة \fIaddr\fP هي عنوان بنية بيانات اختيارية خاصة بالعملية يتم نسخها إلى أو من النظام. يتم إعطاء تفسير \fIaddr\fP مع كل عملية أدناه. .P قيمة \fIsubop\fP هي إحدى العمليات التالية: .TP \fBQ_QUOTAON\fP تشغيل الحصص لنظام ملفات. وسيطة \fIid\fP هي رقم تعريف تنسيق الحصة الذي سيتم استخدامه. حاليًا، هناك ثلاثة تنسيقات حصص مدعومة: .RS .TP 13 \fBQFMT_VFS_OLD\fP تنسيق الحصة الأصلي. .TP \fBQFMT_VFS_V0\fP تنسيق الحصة القياسي VFS v0، الذي يمكنه التعامل مع معرفات المستخدمين والمجموعات ذات 32 بت وحدود حصص تصل إلى 2\[ha]42 بايت و 2\[ha]32 عقدة فهرس. .TP \fBQFMT_VFS_V1\fP تنسيق حصة يمكنه التعامل مع معرفات المستخدمين والمجموعات ذات 32 بت وحدود حصص تبلغ 2\[ha]63 \- 1 بايت و 2\[ha]63 \- 1 عقدة فهرس. .RE .IP تشير وسيطة \fIaddr\fP إلى اسم مسار ملف يحتوي على الحصص لنظام الملفات. يجب أن يوجد ملف الحصة؛ يتم إنشاؤه عادةً باستخدام برنامج \fBquotacheck\fP(8) .IP يمكن أيضًا تخزين معلومات الحصة في عقد فهرس نظام مخفية لـ ext4 و XFS وأنظمة ملفات أخرى إذا تم تكوين نظام الملفات بهذا الشكل. في هذه الحالة، لا توجد ملفات حصة مرئية ولا حاجة لاستخدام \fBquotacheck\fP(8). يتم دائمًا الحفاظ على اتساق معلومات الحصة بواسطة نظام الملفات وتخدم عملية \fBQ_QUOTAON\fP فقط لتمكين فرض حدود الحصة. يُشار إلى وجود عقد فهرس نظام مخفية مع معلومات الحصة بواسطة العلم \fBDQF_SYS_FILE\fP في حقل \fIdqi_flags\fP الذي يتم إرجاعه بواسطة عملية \fBQ_GETINFO\fP. .IP يتجاهل المتغير \fBquotactl_fd\fP() من استدعاء النظام هذا وسيطتي \fIaddr\fP و \fIid\fP، لذا فإن عملية \fBQ_QUOTAON\fP الخاصة بـ \fBquotactl_fd\fP() مناسبة فقط للعمل مع عقد فهرس النظام المخفية. .IP تتطلب هذه العملية صلاحية (\fBCAP_SYS_ADMIN\fP). .TP \fBQ_QUOTAOFF\fP إيقاف تشغيل الحصص لنظام ملفات. يتم تجاهل وسيطتي \fIaddr\fP و \fIid\fP. تتطلب هذه العملية صلاحية (\fBCAP_SYS_ADMIN\fP). .TP \fBQ_GETQUOTA\fP الحصول على حدود حصة القرص والاستخدام الحالي للمستخدم أو المجموعة \fIid\fP. وسيطة \fIaddr\fP هي مؤشر لبنية \fIdqblk\fP المعرفة في \fI\fP كما يلي: .IP .in +4n .EX struct dqblk { /* Definition since Linux 2.4.22 */ uint64_t dqb_bhardlimit; /* Absolute limit on disk quota blocks alloc */ uint64_t dqb_bsoftlimit; /* Preferred limit on disk quota blocks */ uint64_t dqb_curspace; /* Current occupied space (in bytes) */ uint64_t dqb_ihardlimit; /* Maximum number of allocated inodes */ uint64_t dqb_isoftlimit; /* Preferred inode limit */ uint64_t dqb_curinodes; /* Current number of allocated inodes */ uint64_t dqb_btime; /* Time limit for excessive disk use */ uint64_t dqb_itime; /* Time limit for excessive files */ uint32_t dqb_valid; /* Bit mask of QIF_* constants */ }; \& /* Flags in dqb_valid that indicate which fields in dqblk structure are valid. */ \& #define QIF_BLIMITS 1 #define QIF_SPACE 2 #define QIF_ILIMITS 4 #define QIF_INODES 8 #define QIF_BTIME 16 #define QIF_ITIME 32 #define QIF_LIMITS (QIF_BLIMITS | QIF_ILIMITS) #define QIF_USAGE (QIF_SPACE | QIF_INODES) #define QIF_TIMES (QIF_BTIME | QIF_ITIME) #define QIF_ALL (QIF_LIMITS | QIF_USAGE | QIF_TIMES) .EE .in .IP حقل \fIdqb_valid\fP هو قناع بت يتم تعيينه للإشارة إلى الإدخالات في بنية \fIdqblk\fP الصالحة. حاليًا، يملأ النواة جميع إدخالات بنية \fIdqblk\fP ويضع علامة عليها كصالحة في حقل \fIdqb_valid\fP. يمكن للمستخدمين غير المميزين استرداد حصصهم الخاصة فقط؛ يمكن للمستخدم المميز (\fBCAP_SYS_ADMIN\fP) استرداد حصص أي مستخدم. .TP \fBQ_GETNEXTQUOTA\fP (منذ Linux 4.6) .\" commit 926132c0257a5a8d149a6a395cc3405e55420566 هذه العملية هي نفس \fBQ_GETQUOTA\fP، ولكنها تُرجع معلومات الحصة للمعرف التالي الأكبر من أو يساوي \fIid\fP الذي لديه حصة محددة. .IP وسيطة \fIaddr\fP هي مؤشر لبنية \fInextdqblk\fP التي حقولها مثل \fIdqblk\fP، باستثناء إضافة حقل \fIdqb_id\fP المستخدم لإرجاع المعرف الذي يتم إرجاع معلومات الحصة له: .IP .in +4n .EX struct nextdqblk { uint64_t dqb_bhardlimit; uint64_t dqb_bsoftlimit; uint64_t dqb_curspace; uint64_t dqb_ihardlimit; uint64_t dqb_isoftlimit; uint64_t dqb_curinodes; uint64_t dqb_btime; uint64_t dqb_itime; uint32_t dqb_valid; uint32_t dqb_id; }; .EE .in .TP \fBQ_SETQUOTA\fP تعيين معلومات الحصة للمستخدم أو المجموعة \fIid\fP، باستخدام المعلومات المقدمة في بنية \fIdqblk\fP المشار إليها بواسطة \fIaddr\fP. يشير حقل \fIdqb_valid\fP من بنية \fIdqblk\fP إلى الإدخالات في البنية التي تم تعيينها بواسطة المتصل. تحل هذه العملية محل عمليات \fBQ_SETQLIM\fP و \fBQ_SETUSE\fP في واجهات الحصة السابقة. تتطلب هذه العملية صلاحية (\fBCAP_SYS_ADMIN\fP). .TP \fBQ_GETINFO\fP (منذ Linux 2.4.22) الحصول على معلومات (مثل أوقات السماح) حول ملف الحصة. يجب أن تكون وسيطة \fIaddr\fP مؤشرًا لبنية \fIdqinfo\fP. هذه البنية معرفة في \fI\fP كما يلي: .IP .in +4n .EX struct dqinfo { /* Defined since Linux 2.4.22 */ uint64_t dqi_bgrace; /* Time before block soft limit becomes hard limit */ uint64_t dqi_igrace; /* Time before inode soft limit becomes hard limit */ uint32_t dqi_flags; /* Flags for quotafile (DQF_*) */ uint32_t dqi_valid; }; \& /* Bits for dqi_flags */ \& /* Quota format QFMT_VFS_OLD */ \& #define DQF_ROOT_SQUASH (1 << 0) /* Root squash enabled */ /* Before Linux 4.0, this had been defined privately as V1_DQF_RSQUASH */ \& /* Quota format QFMT_VFS_V0 / QFMT_VFS_V1 */ \& #define DQF_SYS_FILE (1 << 16) /* Quota stored in a system file */ \& /* Flags in dqi_valid that indicate which fields in dqinfo structure are valid. */ \& #define IIF_BGRACE 1 #define IIF_IGRACE 2 #define IIF_FLAGS 4 #define IIF_ALL (IIF_BGRACE | IIF_IGRACE | IIF_FLAGS) .EE .in .IP يشير حقل \fIdqi_valid\fP في بنية \fIdqinfo\fP إلى الإدخالات في البنية الصالحة. حاليًا، يملأ النواة جميع إدخالات بنية \fIdqinfo\fP ويضع علامة عليها جميعًا كصالحة في حقل \fIdqi_valid\fP. يتم تجاهل وسيطة \fIid\fP. .TP \fBQ_SETINFO\fP (منذ Linux 2.4.22) تعيين معلومات حول ملف الحصة. يجب أن تكون وسيطة \fIaddr\fP مؤشرًا لبنية \fIdqinfo\fP. يشير حقل \fIdqi_valid\fP من بنية \fIdqinfo\fP إلى الإدخالات في البنية التي تم تعيينها بواسطة المتصل. تحل هذه العملية محل عمليات \fBQ_SETGRACE\fP و \fBQ_SETFLAGS\fP في واجهات الحصة السابقة. يتم تجاهل وسيطة \fIid\fP. تتطلب هذه العملية صلاحية (\fBCAP_SYS_ADMIN\fP). .TP \fBQ_GETFMT\fP (منذ Linux 2.4.22) الحصول على تنسيق الحصة المستخدم في نظام الملفات المحدد. يجب أن تكون الوسيطة \fIaddr\fP مؤشرًا لمخزن مؤقت بحجم 4 بايت حيث سيُخزَّن رقم التنسيق. .TP \fBQ_SYNC\fP تحديث النسخة على القرص من استخدامات الحصة لنظام ملفات. بالنسبة لـ \fBquotactl\fP()، إذا كانت \fIspecial\fP NULL، فجميع أنظمة الملفات ذات الحصص النشطة تُزامَن. (\fBquotactl_fd\fP() تُزامِن دائمًا نظام ملفات واحدًا فقط.) في كلتا الحالتين، تُتجاهَل الوسيطتان \fIaddr\fP و \fIid\fP. .TP \fBQ_GETSTATS\fP (مدعوم حتى Linux 2.4.21) الحصول على إحصائيات ومعلومات عامة أخرى حول نظام الحصة الفرعي. يجب أن تكون الوسيطة \fIaddr\fP مؤشرًا لبنية \fIdqstats\fP حيث تُخزَّن البيانات. هذه البنية مُعرَّفة في \fI\fP. تُتجاهَل الوسيطتان \fIspecial\fP و \fIid\fP. .IP هذه العملية قديمة وأُزيلت في Linux 2.4.22. الملفات في \fI/proc/sys/fs/quota/\fP تحمل المعلومات بدلاً من ذلك. .P بالنسبة لأنظمة ملفات XFS التي تستخدم مدير حصة XFS (XQM)، تُتجاوز العمليات أعلاه وتُستخدم العمليات التالية: .TP \fBQ_XQUOTAON\fP تشغيل الحصص لنظام ملفات XFS. يوفر XFS القدرة على تشغيل/إيقاف فرض حد الحصة مع محاسبة الحصة. لذلك، يتوقع XFS أن تكون \fIaddr\fP مؤشرًا لـ \fIunsigned int\fP يحتوي على توليفة بتية من الأعلام التالية (مُعرَّفة في \fI\fP): .IP .in +4n .EX XFS_QUOTA_UDQ_ACCT /* حساب حصص المستخدمين */ XFS_QUOTA_UDQ_ENFD /* فرض حدود حصص المستخدمين */ XFS_QUOTA_GDQ_ACCT /* حساب حصص المجموعات */ XFS_QUOTA_GDQ_ENFD /* فرض حدود حصص المجموعات */ XFS_QUOTA_PDQ_ACCT /* حساب حصص المشاريع */ XFS_QUOTA_PDQ_ENFD /* فرض حدود حصص المشاريع */ .EE .in .IP تتطلب هذه العملية صلاحية (\fBCAP_SYS_ADMIN\fP). تُتجاهَل الوسيطة \fIid\fP. .TP \fBQ_XQUOTAOFF\fP إيقاف الحصص لنظام ملفات XFS. كما هو الحال مع \fBQ_QUOTAON\fP، تتوقع أنظمة ملفات XFS مؤشرًا لـ \fIunsigned int\fP يُحدد ما إذا كانت محاسبة الحصة و/أو فرض الحد بحاجة إلى الإيقاف (باستخدام نفس الأعلام المستخدمة لعملية \fBQ_XQUOTAON\fP). تتطلب هذه العملية صلاحية (\fBCAP_SYS_ADMIN\fP). تُتجاهَل الوسيطة \fIid\fP. .TP \fBQ_XGETQUOTA\fP الحصول على حدود حصة القرص والاستخدام الحالي للمستخدم \fIid\fP. الوسيطة \fIaddr\fP هي مؤشر لبنية \fIfs_disk_quota\fP، المُعرَّفة في \fI\fP كالتالي: .IP .in +4n .EX /* All the blk units are in BBs (Basic Blocks) of 512 bytes. */ \& #define FS_DQUOT_VERSION 1 /* fs_disk_quota.d_version */ \& #define XFS_USER_QUOTA (1<<0) /* User quota type */ #define XFS_PROJ_QUOTA (1<<1) /* Project quota type */ #define XFS_GROUP_QUOTA (1<<2) /* Group quota type */ \& struct fs_disk_quota { int8_t d_version; /* Version of this structure */ int8_t d_flags; /* XFS_{USER,PROJ,GROUP}_QUOTA */ uint16_t d_fieldmask; /* Field specifier */ uint32_t d_id; /* User, project, or group ID */ uint64_t d_blk_hardlimit; /* Absolute limit on disk blocks */ uint64_t d_blk_softlimit; /* Preferred limit on disk blocks */ uint64_t d_ino_hardlimit; /* Maximum # allocated inodes */ uint64_t d_ino_softlimit; /* Preferred inode limit */ uint64_t d_bcount; /* # disk blocks owned by the user */ uint64_t d_icount; /* # inodes owned by the user */ int32_t d_itimer; /* Zero if within inode limits */ /* If not, we refuse service */ int32_t d_btimer; /* Similar to above; for disk blocks */ uint16_t d_iwarns; /* # warnings issued with respect to # of inodes */ uint16_t d_bwarns; /* # warnings issued with respect to disk blocks */ int32_t d_padding2; /* Padding \- for future use */ uint64_t d_rtb_hardlimit; /* Absolute limit on realtime (RT) disk blocks */ uint64_t d_rtb_softlimit; /* Preferred limit on RT disk blocks */ uint64_t d_rtbcount; /* # realtime blocks owned */ int32_t d_rtbtimer; /* Similar to above; for RT disk blocks */ uint16_t d_rtbwarns; /* # warnings issued with respect to RT disk blocks */ int16_t d_padding3; /* Padding \- for future use */ char d_padding4[8]; /* Yet more padding */ }; .EE .in .IP يمكن للمستخدمين غير المميزين استرداد حصصهم الخاصة فقط؛ يمكن للمستخدم المميز (\fBCAP_SYS_ADMIN\fP) استرداد حصص أي مستخدم. .TP \fBQ_XGETNEXTQUOTA\fP (منذ Linux 4.6) .\" commit 8b37524962b9c54423374717786198f5c0820a28 هذه العملية هي نفس \fBQ_XGETQUOTA\fP، لكنها تُرجع (في بنية \fIfs_disk_quota\fP المشار إليها بـ \fIaddr\fP) معلومات الحصة للمعرف التالي الأكبر من أو يساوي \fIid\fP الذي لديه حصة مضبوطة. لاحظ أنه بما أن \fIfs_disk_quota\fP تحتوي بالفعل على حقل \fIq_id\fP، فلا حاجة لنوع بنية منفصل (على عكس عمليات \fBQ_GETQUOTA\fP و \fBQ_GETNEXTQUOTA\fP) .TP \fBQ_XSETQLIM\fP ضبط حدود حصة القرص للمستخدم \fIid\fP. الوسيطة \fIaddr\fP هي مؤشر لبنية \fIfs_disk_quota\fP. تتطلب هذه العملية صلاحية (\fBCAP_SYS_ADMIN\fP). .TP \fBQ_XGETQSTAT\fP إرجاع معلومات حصة خاصة بنظام ملفات XFS في بنية \fIfs_quota_stat\fP المشار إليها بـ \fIaddr\fP. هذا مفيد لمعرفة مقدار المساحة المستخدمة لتخزين معلومات الحصة، وأيضًا للحصول على حالة تشغيل/إيقاف الحصة لنظام ملفات XFS محلي معين. بنية \fIfs_quota_stat\fP نفسها مُعرَّفة كالتالي: .IP .in +4n .EX #define FS_QSTAT_VERSION 1 /* fs_quota_stat.qs_version */ \& struct fs_qfilestat { uint64_t qfs_ino; /* Inode number */ uint64_t qfs_nblks; /* Number of BBs 512\-byte\-blocks */ uint32_t qfs_nextents; /* Number of extents */ }; \& struct fs_quota_stat { int8_t qs_version; /* Version number for future changes */ uint16_t qs_flags; /* XFS_QUOTA_{U,P,G}DQ_{ACCT,ENFD} */ int8_t qs_pad; /* Unused */ struct fs_qfilestat qs_uquota; /* User quota storage information */ struct fs_qfilestat qs_gquota; /* Group quota storage information */ uint32_t qs_incoredqs; /* Number of dquots in core */ int32_t qs_btimelimit; /* Limit for blocks timer */ int32_t qs_itimelimit; /* Limit for inodes timer */ int32_t qs_rtbtimelimit;/* Limit for RT blocks timer */ uint16_t qs_bwarnlimit; /* Limit for # of warnings */ uint16_t qs_iwarnlimit; /* Limit for # of warnings */ }; .EE .in .IP الوسيطة \fIid\fP تُتجاهَل. .TP \fBQ_XGETQSTATV\fP إرجاع معلومات حصة خاصة بنظام ملفات XFS في \fIfs_quota_statv\fP المشار إليه بـ \fIaddr\fP. هذا الإصدار من العملية يستخدم بنية مع دعم إصدار مناسب، مع تخطيط مناسب (جميع الحقول محاذاة طبيعيًا) وحشو لتجنب معالجة توافق خاصة؛ كما يوفر القدرة على الحصول على إحصائيات بخصوص ملف حصة المشروع. بنية \fIfs_quota_statv\fP نفسها مُعرَّفة كالتالي: .IP .in +4n .EX #define FS_QSTATV_VERSION1 1 /* fs_quota_statv.qs_version */ \& struct fs_qfilestatv { uint64_t qfs_ino; /* Inode number */ uint64_t qfs_nblks; /* Number of BBs 512\-byte\-blocks */ uint32_t qfs_nextents; /* Number of extents */ uint32_t qfs_pad; /* Pad for 8\-byte alignment */ }; \& struct fs_quota_statv { int8_t qs_version; /* Version for future changes */ uint8_t qs_pad1; /* Pad for 16\-bit alignment */ uint16_t qs_flags; /* XFS_QUOTA_.* flags */ uint32_t qs_incoredqs; /* Number of dquots incore */ struct fs_qfilestatv qs_uquota; /* User quota information */ struct fs_qfilestatv qs_gquota; /* Group quota information */ struct fs_qfilestatv qs_pquota; /* Project quota information */ int32_t qs_btimelimit; /* Limit for blocks timer */ int32_t qs_itimelimit; /* Limit for inodes timer */ int32_t qs_rtbtimelimit; /* Limit for RT blocks timer */ uint16_t qs_bwarnlimit; /* Limit for # of warnings */ uint16_t qs_iwarnlimit; /* Limit for # of warnings */ uint64_t qs_pad2[8]; /* For future proofing */ }; .EE .in .IP حقل \fIqs_version\fP من البنية يجب أن يُملأ بإصدار البنية المدعوم من قبل المُستدعى (حاليًا، فقط \fIFS_QSTAT_VERSION1\fP مدعوم). سيملأ النواة البنية وفقًا للإصدار المُقدم. الوسيطة \fIid\fP تُتجاهَل. .TP \fBQ_XQUOTARM\fP (معيب حتى Linux 3.16) .\" 9da93f9b7cdf8ab28da6b364cdc1fafc8670b4dc تحرير مساحة القرص التي تشغلها حصص القرص. يجب أن تكون الوسيطة \fIaddr\fP مؤشرًا لقيمة \fIunsigned int\fP تحتوي على أعلام (نفس تلك الموجودة في حقل \fId_flags\fP من بنية \fIfs_disk_quota\fP) التي تُحدد أنواع الحصة التي يجب إزالتها. (لاحظ أن نوع الحصة المُمرَّر في الوسيطة \fIop\fP يُتجاهَل، لكن يجب أن يبقى صالحًا لاجتياز فحوصات معالج استدعاء النظام quotactl الأولية.) .IP يجب أن تكون الحصص قد أُوقفت بالفعل. الوسيطة \fIid\fP تُتجاهَل. .TP \fBQ_XQUOTASYNC\fP (منذ Linux 2.6.15؛ عملية عدم فعل منذ Linux 3.4) .\" Added in commit ee34807a65aa0c5911dc27682863afca780a003e .\" 4b217ed9e30f94b6e8e5e262020ef0ceab6113af كانت هذه العملية مكافئة لحصة XFS لـ \fBQ_SYNC\fP، لكنها عملية عدم فعل منذ Linux 3.4، حيث أن \fBsync\fP(1) يكتب معلومات الحصة إلى القرص الآن (بالإضافة إلى بيانات وصفية أخرى لنظام الملفات التي يكتبها). الوسيطات \fIspecial\fP و \fIid\fP و \fIaddr\fP تُتجاهَل. .SH "قيمة الإرجاع" عند النجاح، تُرجع \fBquotactl\fP() 0؛ عند الخطأ، تُرجع \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء .TP \fBEACCES\fP \fIop\fP هو \fBQ_QUOTAON\fP، وملف الحصة المشار إليه بـ \fIaddr\fP موجود، لكنه ليس ملفًا عاديًا أو ليس على نظام الملفات المشار إليه بـ \fIspecial\fP. .TP \fBEBUSY\fP \fIop\fP هو \fBQ_QUOTAON\fP، لكن عملية \fBQ_QUOTAON\fP أخرى قد نُفذت بالفعل. .TP \fBEFAULT\fP \fIaddr\fP أو \fIspecial\fP غير صالح. .TP \fBEINVAL\fP \fIop\fP أو \fItype\fP غير صالح. .TP \fBEINVAL\fP \fIop\fP هو \fBQ_QUOTAON\fP، لكن ملف الحصة المحدد تالف. .TP \fBEINVAL\fP (منذ لينكس 5.5) .\" 3dd4d40b420846dd35869ccc8f8627feef2cff32 \fIop\fP هو \fBQ_XQUOTARM\fP، لكن \fIaddr\fP لا يشير إلى أنواع حصص صالحة. .TP \fBENOENT\fP الملف المحدد بواسطة \fIspecial\fP أو \fIaddr\fP غير موجود. .TP \fBENOSYS\fP لم يتم تجميع النواة مع خيار \fBCONFIG_QUOTA\fP. .TP \fBENOTBLK\fP \fIspecial\fP ليس جهاز كتلة. .TP \fBEPERM\fP يفتقر المستدعي إلى الامتياز المطلوب (\fBCAP_SYS_ADMIN\fP) للعملية المحددة. .TP \fBERANGE\fP \fIop\fP هو \fBQ_SETQUOTA\fP، لكن الحدود المحددة خارج النطاق المسموح به بواسطة تنسيق الحصة. .TP \fBESRCH\fP لم يتم العثور على حصة قرص للمستخدم المشار إليه. لم يتم تفعيل الحصص لنظام الملفات هذا. .TP \fBESRCH\fP \fIop\fP هو \fBQ_QUOTAON\fP، لكن تنسيق الحصة المحدد لم يتم العثور عليه. .TP \fBESRCH\fP \fIop\fP هو \fBQ_GETNEXTQUOTA\fP أو \fBQ_XGETNEXTQUOTA\fP، لكن لا يوجد معرف أكبر من أو يساوي \fIid\fP لديه حصة نشطة. .SH ملاحظات .SS "رأس XFS بديل" بدلاً من \fI\fP يمكن استخدام \fI\fP، مع مراعاة وجود عدة اختلافات في التسمية: .IP \[bu] 3 أعلام تفعيل الحصة (بصيغة \fBXFS_QUOTA_[UGP]DQ_{ACCT,ENFD}\fP) تُعرف بدون حرف "X" البادئ، كـ \fBFS_QUOTA_[UGP]DQ_{ACCT,ENFD}\fP. .IP \[bu] نفس الشيء ينطبق على أعلام أنواع الحصص \fBXFS_{USER,GROUP,PROJ}_QUOTA\fP، والتي تُعرف كـ \fBFS_{USER,GROUP,PROJ}_QUOTA\fP. .IP \[bu] ملف الرأس \fIdqblk_xfs.h\fP يعرّف ثوابته الخاصة \fBXQM_USRQUOTA\fP و \fBXQM_GRPQUOTA\fP و \fBXQM_PRJQUOTA\fP لأنواع الحصص المتاحة، لكن قيمها هي نفسها للثوابت بدون البادئة \fBXQM_\fP. .SS "quotactl() مقابل quotactl_fd()" النسخة الأصلية \fBquotactl\fP() من استدعاء النظام هذا تتطلب تحديد جهاز الكتلة الذي يحتوي على نظام الملفات المراد العمل عليه. هذا يجعل من المستحيل استخدامه في الحالات التي لا يحتوي فيها نظام الملفات على جهاز كتلة داعم (مثل tmpfs). حتى عندما يكون جهاز الكتلة موجودًا، قد يكون من الصعب تحديد موقعه (يتطلب مسح \fI/proc/self/mounts\fP وحتى بعض التحليل الخاص بنظام الملفات في حالة، على سبيل المثال، bcachefs). \fBquotactl_fd\fP() بدلاً من ذلك يعمل على نقطة الوصل، مما يتجنب هذا القيد ويكون أبسط في الاستخدام (نظرًا لأن نظام الملفات المراد معالجته يُحدد عادةً بنقطة الوصل الخاصة به على أي حال). .SH المعايير لينكس. .SH التاريخ .TP \fBquotactl_fd\fP() لينكس 5.14. .SH "انظر أيضًا" \fBquota\fP(1), \fBgetrlimit\fP(2), \fBquotacheck\fP(8), \fBquotaon\fP(8) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .