sysfs(5)

الاسم
sysfs - نظام ملفات لتصدير كائنات النواة

الوصف
نظام الملفات sysfs هو نظام ملفات زائف يوفر واجهة لهياكل بيانات النواة. (بشكل أكثر دقة، توفر الملفات والدلائل في sysfs عرضًا لهياكل kobject المعرفة داخليًا داخل النواة.) توفر الملفات تحت sysfs معلومات حول الأجهزة، ووحدات النواة، وأنظمة الملفات، ومكونات النواة الأخرى.

يُوصل نظام الملفات sysfs عادةً في /sys. عادةً، يُوصل آليًا بواسطة النظام، ولكن يمكن أيضًا وصله يدويًا باستخدام أمر مثل:

    mount -t sysfs sysfs /sys

العديد من الملفات في نظام الملفات sysfs هي للقراءة فقط، ولكن بعض الملفات قابلة للكتابة، مما يسمح بتغيير متغيرات النواة. لتجنب التكرار، تُستخدم الروابط الرمزية بكثافة لربط الإدخالات عبر شجرة نظام الملفات.

  الملفات والمجلدات
تصف القائمة التالية بعض الملفات والدلائل تحت التسلسل الهرمي /sys.

/sys/block
    يحتوي هذا الدليل الفرعي على رابط رمزي واحد لكل جهاز كتلة تم اكتشافه على النظام. تشير الروابط الرمزية إلى الدلائل المقابلة تحت /sys/devices.

/sys/bus
    يحتوي هذا الدليل على دليل فرعي واحد لكل نوع من أنواع النواقل في النواة. داخل كل من هذه الدلائل يوجد دليلان فرعيان:

    devices
        يحتوي هذا الدليل الفرعي على روابط رمزية لإدخالات في /sys/devices تتوافق مع الأجهزة المكتشفة على هذا الناقل.

    drivers
        يحتوي هذا الدليل الفرعي على دليل فرعي واحد لكل برنامج تشغيل جهاز تم تحميله على هذا الناقل.

/sys/class
    يحتوي هذا الدليل الفرعي على طبقة واحدة من الدلائل الفرعية الإضافية لكل فئة من فئات الأجهزة المسجلة على النظام (مثل، المحطات الطرفية، أجهزة الشبكة، أجهزة الكتلة، أجهزة الرسوميات، أجهزة الصوت، وهكذا). داخل كل من هذه الدلائل الفرعية توجد روابط رمزية لكل جهاز في هذه الفئة. تشير هذه الروابط الرمزية إلى إدخالات في دليل /sys/devices.

/sys/class/net
    كل إدخال في هذا الدليل هو رابط رمزي يمثل أحد أجهزة الشبكة الحقيقية أو الافتراضية المرئية في مساحة اسم الشبكة للعملية التي تصل إلى الدليل. يشير كل من هذه الروابط الرمزية إلى إدخالات في دليل /sys/devices.

/sys/dev
    يحتوي هذا الدليل على دليلين فرعيين block/ و char/، يتوافقان على التوالي مع أجهزة الكتلة والحروف على النظام. داخل كل من هذه الدلائل الفرعية توجد روابط رمزية بأسماء من الشكل major-ID:minor-ID، حيث تتوافق قيم المعرف مع المعرف الرئيسي والثانوي لجهاز معين. يشير كل رابط رمزي إلى دليل sysfs لجهاز. توفر الروابط الرمزية داخل /sys/dev بالتالي طريقة سهلة للبحث عن واجهة sysfs باستخدام معرفات الأجهزة التي تُرجعها استدعاء stat(2) (أو ما شابه).

    جلسة الصدفة التالية تظهر مثالاً من /sys/dev:

        $ stat -c "%t %T" /dev/null;
        1 3
        $ readlink /sys/dev/char/1\:3;
        ../../devices/virtual/mem/null
        $ ls -Fd /sys/devices/virtual/mem/null;
        /sys/devices/virtual/mem/null/
        $ ls -d1 /sys/devices/virtual/mem/null/*;
        /sys/devices/virtual/mem/null/dev
        /sys/devices/virtual/mem/null/power/
        /sys/devices/virtual/mem/null/subsystem@
        /sys/devices/virtual/mem/null/uevent

/sys/devices
    هذا دليل يحتوي على تمثيل نظام ملفات لشجرة أجهزة النواة، وهي تسلسل هرمي لهياكل جهاز داخل النواة.

/sys/firmware
    يحتوي هذا الدليل الفرعي على واجهات لعرض ومعالجة الكائنات والسمات الخاصة بالبرامج الثابتة.

/sys/fs
    يحتوي هذا الدليل على أدلة فرعية لبعض أنظمة الملفات. لن يكون لنظام ملفات دليل فرعي هنا إلا إذا اختار إنشاء الدليل الفرعي بشكل صريح.

/sys/fs/cgroup
    يُستخدم هذا الدليل تقليديًا كنقطة وصل لنظام ملفات tmpfs(5) يحتوي على نقاط وصل لأنظمة ملفات cgroups(7).

/sys/fs/smackfs
    يحتوي الدليل على ملفات تهيئة لـ SMACK LSM. انظر ملف مصدر النواة Documentation/admin-guide/LSM/Smack.rst.

/sys/hypervisor
    [سيُوثّق]

/sys/kernel
    يحتوي هذا الدليل الفرعي على ملفات وأدلة فرعية متنوعة توفر معلومات حول النواة الجارية.

/sys/kernel/cgroup/
    للحصول على معلومات حول الملفات في هذا الدليل، انظر cgroups(7).

/sys/kernel/debug/tracing
    نقطة وصل لنظام الملفات tracefs المستخدم بواسطة ميزة ftrace في النواة. (للحصول على معلومات حول ftrace، انظر ملف مصدر النواة Documentation/trace/ftrace.rst.)

/sys/kernel/mm
    يحتوي هذا الدليل الفرعي على ملفات وأدلة فرعية متنوعة توفر معلومات حول نظام إدارة الذاكرة في النواة.

/sys/kernel/mm/hugepages
    يحتوي هذا الدليل الفرعي على دليل فرعي واحد لكل حجم صفحة ضخمة يدعمه النظام. يشير اسم الدليل الفرعي إلى حجم الصفحة الضخمة (مثل hugepages-2048kB). داخل كل من هذه الأدلة الفرعية توجد مجموعة من الملفات التي يمكن استخدامها لعرض الإعدادات المرتبطة بحجم الصفحة الضخمة ذلك وتغييرها (في بعض الحالات). لمزيد من المعلومات، راجع ملف مصدر النواة Documentation/admin-guide/mm/hugetlbpage.rst.

/sys/module
    يحتوي هذا الدليل الفرعي على دليل فرعي واحد لكل وحدة محملة في النواة. اسم كل دليل هو اسم الوحدة. في كل من الأدلة الفرعية، قد توجد الملفات التالية:

    coresize
        [سيُوثّق]

    initsize
        [سيُوثّق]

    initstate
        [سيُوثّق]

    refcnt
        [سيُوثّق]

    srcversion
        [سيُوثّق]

    taint
        [سيُوثّق]

    uevent
        [سيُوثّق]

    الإصدار
        [سيُوثّق]

    في كل من الأدلة الفرعية، قد توجد الأدلة الفرعية التالية:

    drivers
        [سيُوثّق]

    holders
        [سيُوثّق]

    notes
        [سيُوثّق]

    parameters
        يحتوي هذا الدليل على ملف واحد لكل معامل وحدة، حيث يحتوي كل ملف على قيمة المعامل المقابل. بعض هذه الملفات قابلة للكتابة، مما يسمح بتغيير المعاملات.

    sections
        تحتوي هذه الأدلة الفرعية على ملفات تحتوي على معلومات حول أقسام الوحدة. تُستخدم هذه المعلومات بشكل أساسي لتصحيح الأخطاء.

    [سيُوثّق]

/sys/power
    [سيُوثّق]

المعايير
لينكس.

التاريخ
لينكس 2.6.0.

ملاحظات
صفحة الدليل هذه غير مكتملة، وقد تكون غير دقيقة، وهي من النوع الذي يحتاج إلى تحديث متكرر جدًا.

انظر أيضًا
proc(5), udev(7)

P. Mochel (2005). نظام الملفات sysfs. وقائع ندوة أوتاوا لينكس 2005.

ملف مصدر النواة Documentation/filesystems/sysfs.rst وملفات أخرى متنوعة في Documentation/ABI و Documentation/*/sysfs.rst.

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

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

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