.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993, David Metcalfe .\" 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 getmntent 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم getmntent, setmntent, addmntent, endmntent, hasmntopt, getmntent_r \- الحصول على مدخل ملف واصف نظام الملفات .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP \fB#include \fP .P \fBFILE *setmntent(const char *\fP\fIpath\fP\fB, const char *\fP\fItype\fP\fB);\fP .P \fBstruct mntent *getmntent(FILE *\fP\fIstream\fP\fB);\fP .P \fBint addmntent(FILE *restrict \fP\fIstream\fP\fB,\fP \fB const struct mntent *restrict \fP\fImnt\fP\fB);\fP .P \fBint endmntent(FILE *\fP\fIstreamp\fP\fB);\fP .P \fBchar *hasmntopt(const struct mntent *\fP\fImnt\fP\fB, const char *\fP\fIopt\fP\fB);\fP .P /* GNU extension */ \fB#include \fP .P \fBstruct mntent *getmntent_r(\fPint size; \fB FILE *restrict \fP\fIstreamp\fP\fB,\fP \fB struct mntent *restrict \fP\fImntbuf\fP\fB,\fP \fB char \fP\fIbuf\fP\fB[restrict \fP\fIsize\fP\fB], int \fP\fIsize\fP\fB);\fP .fi .P .RS -4 متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)): .RE .P \fBgetmntent_r\fP(): .nf منذ glibc 2.19: _DEFAULT_SOURCE glibc 2.19 وما قبله: _BSD_SOURCE || _SVID_SOURCE .fi .SH الوصف تُستخدم هذه الروتينات للوصول إلى ملف وصف نظام الملفات \fI/etc/fstab\fP وملف وصف نظام الملفات المُوصَل \fI/etc/mtab\fP. .P تفتح الدالة \fBsetmntent\fP() ملف وصف نظام الملفات \fIpath\fP وتُعيد مؤشر ملف يمكن استخدامه بواسطة \fBgetmntent\fP(). المعامل \fItype\fP هو نوع الوصول المطلوب ويمكن أن يأخذ نفس قيم معامل \fImode\fP للدالة \fBfopen\fP(3). يجب إغلاق الدفق المُعاد باستخدام \fBendmntent\fP() بدلاً من \fBfclose\fP(3). .P تقرأ الدالة \fBgetmntent\fP() السطر التالي من ملف وصف نظام الملفات من \fIstream\fP وتُعيد مؤشراً إلى بنية تحتوي على الحقول المفصولة من سطر في الملف. يشير المؤشر إلى منطقة ذاكرة ثابتة تُستبدل باستدعاءات لاحقة لـ \fBgetmntent\fP(). .P تُضيف الدالة \fBaddmntent\fP() بنية \fImntent\fP \fImnt\fP إلى نهاية الدفق المفتوح \fIstream\fP. .P تُغلق الدالة \fBendmntent\fP() الدفق \fIstream\fP المرتبط بملف وصف نظام الملفات. .P تفحص الدالة \fBhasmntopt\fP() حقل \fImnt_opts\fP (انظر أدناه) من بنية \fImntent\fP \fImnt\fP بحثاً عن سلسلة فرعية تطابق \fIopt\fP. انظر \fI\fP و \fBmount\fP(8) لخيارات الوصل الصالحة. .P الدالة المعاد دخولها \fBgetmntent_r\fP() مشابهة لـ \fBgetmntent\fP()، لكنها تخزن بنية \fImntent\fP في \fI*mntbuf\fP المُقدم، وتخزن السلاسل التي تشير إليها المدخلات في تلك البنية في المصفوفة المُقدمة \fIbuf\fP ذات الحجم \fIsize\fP. .P تُعرف بنية \fImntent\fP في \fI\fP كما يلي: .P .in +4n .EX struct mntent { char *mnt_fsname; /* اسم نظام الملفات الموصول */ char *mnt_dir; /* بادئة مسار نظام الملفات */ char *mnt_type; /* نوع الوصل (انظر mntent.h) */ char *mnt_opts; /* خيارات الوصل (انظر mntent.h) */ int mnt_freq; /* تواتر النسخ الاحتياطي (dump) بالأيام */ int mnt_passno; /* رقم المرور لبرنامج fsck المتوازي */ }; .EE .in .P نظراً لأن الحقول في ملفات mtab و fstab مفصولة بمسافات بيضاء، تُستخدم الهروب الثماني لتمثيل الأحرف مسافة (\[rs]040)، تبويب (\[rs]011)، سطر جديد (\[rs]012)، وخط مائل عكسي (\[rs]\[rs]) في تلك الملفات عندما تظهر في إحدى السلاسل الأربع في بنية \fImntent\fP. ستحول الروتينات \fBaddmntent\fP() و \fBgetmntent\fP() من تمثيل السلسلة إلى تمثيل الهروب والعكس. عند التحويل من تمثيل الهروب، يُحول التسلسل \[rs]134 أيضاً إلى خط مائل عكسي. .SH "قيمة الإرجاع" تُعيد الدالتان \fBgetmntent\fP() و \fBgetmntent_r\fP() مؤشرًا إلى بنية \fImntent\fP أو NULL عند الفشل. .P تُعيد الدالة \fBaddmntent\fP() 0 عند النجاح و 1 عند الفشل. .P تُعيد الدالة \fBendmntent\fP() دائمًا 1. .P تُعيد الدالة \fBhasmntopt\fP() عنوان السلسلة الفرعية إذا وُجد تطابق و NULL بخلاف ذلك. .SH الملفات .TP \fI/etc/fstab\fP ملف وصف نظام الملفات .TP \fI/etc/mtab\fP ملف وصف نظام الملفات الموصول .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lb lb lbx l l l. الواجهة السمة القيمة T{ .na .nh \fBsetmntent\fP(), \fBendmntent\fP(), \fBhasmntopt\fP() T} سلامة الخيوط MT\-Safe T{ .na .nh \fBgetmntent\fP() T} سلامة الخيوط T{ .na .nh MT\-Unsafe race:mntentbuf locale T} T{ .na .nh \fBaddmntent\fP() T} سلامة الخيوط T{ .na .nh MT\-Safe race:stream locale T} T{ .na .nh \fBgetmntent_r\fP() T} سلامة الخيوط المنطقة (locale) آمنة لتعدد المسالك (MT\-Safe) .TE .SH المعايير لا شيء. .SH التاريخ الدوال غير المعاد دخولها من SunOS 4.1.3. أُدخلت روتين \fBgetmntent_r\fP() في HP\-UX 10، لكنها تُعيد \fIint\fP. النموذج الأولي المعروض أعلاه خاص بـ glibc فقط. .P يحتوي System V أيضًا على دالة \fBgetmntent\fP() لكن تسلسل الاستدعاء يختلف، والبنية المُعادة مختلفة. تحت System V يُستخدم \fI/etc/mnttab\fP. 4.4BSD و Digital UNIX لديهما روتين \fB\%getmntinfo\fP()، وهو غلاف حول استدعاء النظام \fBgetfsstat\fP(). .SH "انظر أيضًا" \fBfopen\fP(3)، \fBfstab\fP(5)، \fBmount\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 .