.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 2003, Andries E. Brouwer .\" 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 statvfs 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم statvfs, fstatvfs \- الحصول على إحصائيات نظام الملفات .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBint statvfs(const char *restrict \fP\fIpath\fP\fB, struct statvfs *restrict \fP\fIbuf\fP\fB);\fP \fBint fstatvfs(int \fP\fIfd\fP\fB, struct statvfs *\fP\fIbuf\fP\fB);\fP .fi .SH الوصف الدالة \fBstatvfs\fP() تُرجع معلومات عن نظام ملفات موصول. \fIpath\fP هو اسم مسار أي ملف داخل نظام الملفات الموصول. \fIbuf\fP هو مؤشر إلى بنية \fIstatvfs\fP المُعرَّفة تقريبًا كما يلي: .P .in +4n .EX struct statvfs { unsigned long f_bsize; /* حجم كتلة نظام الملفات */ unsigned long f_frsize; /* حجم القطعة */ fsblkcnt_t f_blocks; /* حجم نظام الملفات بوحدات f_frsize */ fsblkcnt_t f_bfree; /* عدد الكتل الحرة */ fsblkcnt_t f_bavail; /* عدد الكتل الحرة للمستخدمين غير المميزين */ fsfilcnt_t f_files; /* عدد عقد inode */ fsfilcnt_t f_ffree; /* عدد عقد inode الحرة */ fsfilcnt_t f_favail; /* عدد عقد inode الحرة للمستخدمين غير المميزين */ unsigned long f_fsid; /* معرف نظام الملفات */ unsigned long f_flag; /* أعلام الوصل */ unsigned long f_namemax; /* أقصى طول لاسم الملف */ }; .EE .in .P هنا الأنواع \fIfsblkcnt_t\fP و \fIfsfilcnt_t\fP مُعرَّفة في \fI\fP. كلاهما كانا من النوع \fIunsigned long\fP. .P .\" XXX Keep this list in sync with statfs(2) الحقل \fIf_flag\fP هو قناع بتات يُشير إلى خيارات متنوعة استُخدمت عند وصل نظام الملفات هذا. يحتوي على صفر أو أكثر من الأعلام التالية: .TP \fBST_MANDLOCK\fP القفل الإجباري مسموح به على نظام الملفات (انظر \fBfcntl\fP(2)). .TP \fBST_NOATIME\fP لا تُحدّث أوقات الوصول؛ انظر \fBmount\fP(2). .TP \fBST_NODEV\fP امنع الوصول إلى ملفات الأجهزة الخاصة على نظام الملفات هذا. .TP \fBST_NODIRATIME\fP لا تُحدّث أوقات وصول الأدلة؛ انظر \fBmount\fP(2). .TP \fBST_NOEXEC\fP تنفيذ البرامج غير مسموح به على نظام الملفات هذا. .TP \fBST_NOSUID\fP تُتجاهل بتات set\-user\-ID و set\-group\-ID بواسطة \fBexec\fP(3) للملفات التنفيذية على نظام الملفات هذا .TP \fBST_RDONLY\fP نظام الملفات هذا موصول للقراءة فقط. .TP \fBST_RELATIME\fP حدث atime بالنسبة إلى mtime/ctime؛ انظر \fBmount\fP(2). .TP \fBST_SYNCHRONOUS\fP تُزامن عمليات الكتابة إلى نظام الملفات فورًا (انظر وصف \fBO_SYNC\fP في \fBopen\fP(2)). .P غير مُحدد ما إذا كانت جميع أعضاء البنية المُرجعة لها قيم ذات معنى على جميع أنظمة الملفات. .P \fBfstatvfs\fP() تُرجع نفس المعلومات عن ملف مفتوح يُشار إليه بالواصف \fIfd\fP. .SH "قيمة الإرجاع" عند النجاح، يُعاد الصفر. وعند حدوث خطأ، يُعاد الرقم \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء .TP \fBEACCES\fP (\fBstatvfs\fP()) إذن البحث مرفوض لمكون من بادئة مسار \fIpath\fP. (انظر أيضًا \fBpath_resolution\fP(7).) .TP \fBEBADF\fP (\fBfstatvfs\fP()) \fIfd\fP ليس واصف ملف مفتوح صالحًا. .TP \fBEFAULT\fP \fIBuf\fP أو \fIpath\fP يُشير إلى عنوان غير صالح. .TP \fBEINTR\fP هذه الاستدعاء قُطعت بإشارة؛ انظر \fBsignal\fP(7). .TP \fBEIO\fP حدث خطأ إدخال/إخراج أثناء القراءة من نظام الملفات. .TP \fBELOOP\fP (\fBstatvfs\fP()) وُجد عدد كبير جدًا من الروابط الرمزية أثناء ترجمة \fIpath\fP. .TP \fBENAMETOOLONG\fP (\fBstatvfs\fP()) \fIpath\fP طويل جدًا. .TP \fBENOENT\fP (\fBstatvfs\fP()) الملف المشار إليه بواسطة \fIpath\fP غير موجود. .TP \fBENOMEM\fP ذاكرة النواة المتوفرة غير كافية. .TP \fBENOSYS\fP نظام الملفات لا يدعم هذا الاستدعاء. .TP \fBENOTDIR\fP (\fBstatvfs\fP()) مكون من بادئة مسار \fIpath\fP ليس دليلاً. .TP \fBEOVERFLOW\fP كانت بعض القيم أكبر من أن تُمَثَّل في البنية (struct) المعادة. .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBstatvfs\fP(), \fBfstatvfs\fP() T} سلامة الخيوط MT\-Safe .TE .SH الإصدارات فقط العلمان \fBST_NOSUID\fP و \fBST_RDONLY\fP من الحقل \fIf_flag\fP مُحددان في POSIX.1. للحصول على تعريفات الأعلام المتبقية، يجب تعريف \fB_GNU_SOURCE\fP. .SH ملاحظات نواة لينكس تحتوي على استدعاءات النظام \fBstatfs\fP(2) و \fBfstatfs\fP(2) لدعم استدعاء المكتبة هذا. .P تطبيقات glibc للدوال .P .in +4n .EX pathconf(path, _PC_REC_XFER_ALIGN); pathconf(path, _PC_ALLOC_SIZE_MIN); pathconf(path, _PC_REC_MIN_XFER_SIZE); .EE .in .P تستخدم على التوالي الحقول \fIf_frsize\fP و \fIf_frsize\fP و \fIf_bsize\fP التي يُرجعها استدعاء \fBstatvfs\fP() مع المعامل \fIpath\fP. .P تحت لينكس، يكون \fIf_favail\fP دائمًا مماثلاً لـ \fIf_ffree\fP، ولا توجد طريقة لنظام الملفات للإبلاغ بخلاف ذلك. هذه ليست مشكلة، إذ لا توجد أنظمة ملفات ذات حجز جذر لعُقد الإدخال (inode). .SH المعايير POSIX.1\-2008. .SH التاريخ POSIX.1\-2001. .P .\" glibc commit 3cdaa6adb113a088fdfb87aa6d7747557eccc58d قبل glibc 2.13، كان \fBstatvfs\fP() يملأ بتات الحقل \fIf_flag\fP بمسح خيارات الوصل (mount) المعروضة في \fI/proc/mounts\fP. لكن، بدءًا من لينكس 2.6.36، يوفر استدعاء النظام الأساسي \fBstatfs\fP(2) المعلومات الضرورية عبر الحقل \fIf_flags\fP، ومنذ glibc 2.13، تستخدم الدالة \fBstatvfs\fP() المعلومات من ذلك الحقل بدلاً من مسح \fI/proc/mounts\fP. .SH "انظر أيضًا" \fBstatfs\fP(2) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .