getfsent(3)

الاسم
getfsent, getfsspec, getfsfile, setfsent, endfsent - معالجة مدخلات fstab

المكتبة
مكتبة سي المعيارية (libc، -lc)

موجز
#include <fstab.h>

int setfsent(void);
struct fstab *getfsent(void);
void endfsent(void);

struct fstab *getfsfile(const char *mount_point);
struct fstab *getfsspec(const char *special_file);

الوصف
تقرأ هذه الدوال من الملف /etc/fstab. يُعرف struct fstab بما يلي:

    struct fstab {
        char       *fs_spec;       /* اسم جهاز الكتلة */
        char       *fs_file;       /* نقطة الوصل */
        char       *fs_vfstype;    /* نوع نظام الملفات */
        char       *fs_mntops;     /* خيارات الوصل */
        const char *fs_type;       /* خيار rw/rq/ro/sw/xx */
        int         fs_freq;       /* تردد التفريغ، بالأيام */
        int         fs_passno;     /* رقم المرور في التفريغ المتوازي */
    };

هنا يحتوي الحقل fs_type (على نظام *BSD) على إحدى السلاسل الخمس "rw"، "rq"، "ro"، "sw"، "xx" (قراءة-كتابة، قراءة-كتابة مع حصة، قراءة فقط، مبادلة، تجاهل).

تفتح الدالة setfsent() الملف عند الحاجة وتضعه عند السطر الأول.

تحلل الدالة getfsent() السطر التالي من الملف. (بعد فتحه عند الحاجة.)

تغلق الدالة endfsent() الملف عند الحاجة.

تبحث الدالة getfsspec() في الملف من البداية وتعيد أول مدخل وُجد يطابق فيه الحقل fs_spec المعامل special_file.

تبحث الدالة getfsfile() في الملف من البداية وتعيد أول مدخل وُجد يطابق فيه الحقل fs_file المعامل mount_point.

قيمة الإرجاع
عند النجاح، تعيد الدوال getfsent() و getfsfile() و getfsspec() مؤشرًا إلى struct fstab، بينما تعيد setfsent() 1. عند الفشل أو نهاية الملف، تعيد هذه الدوال NULL و 0، على التوالي.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
endfsent(), setfsent() | سلامة الخيوط | MT-Unsafe race:fsent
getfsent(), getfsspec(), getfsfile() | سلامة الخيوط | MT-Unsafe race:fsent locale

الإصدارات
تمتلك العديد من أنظمة التشغيل هذه الدوال، على سبيل المثال، *BSD و SunOS و Digital UNIX و AIX (الذي يمتلك أيضًا getfstype()). يمتلك HP-UX دوال بنفس الأسماء، لكنها تستخدم struct checklist بدلاً من struct fstab، وتعتبر هذه الدوال مهملة، ومستبدلة بـ getmntent(3).

المعايير
لا شيء.

التاريخ
ظهرت الدالة getfsent() في 4.0BSD؛ ظهرت الدوال الأربع الأخرى في 4.3BSD.

ملاحظات
هذه الدوال ليست آمنة الخيوط.

بما أن لينكس يسمح بوصل جهاز كتلة خاص في عدة أماكن، وبما أن عدة أجهزة يمكن أن يكون لها نفس نقطة الوصل، حيث يكون آخر جهاز بنقطة وصل معينة هو المهم، بينما getfsfile() وgetfsspec() لا يُرجعان إلا أول ظهور، فإن هاتين الدالتين غير مناسبتين للاستخدام تحت لينكس.

انظر أيضًا
getmntent(3)، fstab(5)

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.