الاسم¶

init_module, finit_module - تحميل وحدة نواة

المكتبة¶

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

موجز¶

#include <linux/module.h>    /* Definition of MODULE_* constants */
#include <sys/syscall.h>     /* Definition of SYS_* constants */
#include <unistd.h>

int syscall(unsigned long size;
SYS_init_module,
            void module_image[size], unsigned long size,
            const char *param_values);
int syscall(SYS_finit_module, int fd,
            const char *param_values, int flags);

ملاحظة: لا توفر glibc أغلفة لنداءات النظام هذه، مما يستلزم استخدام syscall(2).

الوصف¶

init_module() يحمل صورة ELF إلى مساحة النواة، ويؤدي أي إعادة توطين رموز ضرورية، ويُهيئ معاملات الوحدة إلى القيم المقدمة من المستدعي، ثم يشغل دالة init للوحدة. تتطلب استدعاء النظام هذا صلاحية.

تشير وسيطة module_image إلى مخزن مؤقت يحتوي على الصورة الثنائية المراد تحميلها؛ تحدد size حجم ذلك المخزن. يجب أن تكون صورة الوحدة صورة ELF صالحة، مبنية للنواة الجارية.

وسيطة param_values هي سلسلة تحتوي على مواصفات مفصولة بمسافات لقيم معاملات الوحدة (المعرفة داخل الوحدة باستخدام module_param() و module_param_array()). تحلل النواة هذه السلسلة وتهيئ المعاملات المحددة. كل مواصفات معامل لها الشكل:

name[ =value [,value...]]

اسم المعامل name هو أحد تلك المعرفة داخل الوحدة باستخدام module_param() (انظر ملف مصدر نواة لينكس include/linux/moduleparam.h). قيمة المعامل value اختيارية في حالة معاملات bool و invbool. تُحدد قيم معاملات المصفوفة كقائمة مفصولة بفواصل.

قيمة الإرجاع¶

عند النجاح، تُرجع استدعاءات النظام هذه 0. عند الخطأ، يُرجع -1 ويُضبط errno للإشارة إلى الخطأ.

الأخطاء¶

EBADMSG (منذ لينكس 3.7)

توقيع الوحدة ذو تنسيق خاطئ.

EBUSY

انتهاء المهلة أثناء محاولة حل مرجع رمز بواسطة هذه الوحدة.

EFAULT

وسيطة عنوان تشير إلى موقع خارج مساحة العنوان القابلة للوصول للعملية.

ENOKEY (منذ لينكس 3.7)

توقيع الوحدة غير صالح أو لا يملك النواة مفتاحًا لهذه الوحدة. يُرجع هذا الخطأ فقط إذا ضُبطت النواة مع CONFIG_MODULE_SIG_FORCE؛ إذا لم تضبط النواة مع هذا الخيار، فإن الوحدة غير الصالحة أو غير الموقعة تشوه النواة ببساطة.

ENOMEM

نفدت الذاكرة.

EPERM

لم يكن المتصل مميزًا (لم يملك صلاحية CAP_SYS_MODULE)، أو تحميل الوحدة معطل (انظر /proc/sys/kernel/modules_disabled في proc(5)).

قد تحدث الأخطاء التالية بالإضافة إلى ذلك لـ init_module():

EEXIST

وحدة بهذا الاسم محملة بالفعل.

EINVAL

param_values غير صالح، أو جزء ما من صورة ELF في module_image يحتوي على تناقضات.

ENOEXEC

الصورة الثنائية المقدمة في module_image ليست صورة ELF، أو هي صورة ELF غير صالحة أو لبنية مختلفة.

قد تحدث الأخطاء التالية بالإضافة إلى ذلك لـ finit_module():

EBADF

الملف المشار إليه بـ fd لم يُفتح للقراءة.

EFBIG

الملف المشار إليه بـ fd كبير جدًا.

EINVAL

flags غير صالحة.

EINVAL

فشلت فحوصات السلامة لمفكك الضغط، أثناء تحميل وحدة مضغوطة مع تعيين العلم MODULE_INIT_COMPRESSED_FILE.

ENOEXEC

fd لا يشير إلى ملف مفتوح.

EOPNOTSUPP (منذ لينكس 5.17)

العلم MODULE_INIT_COMPRESSED_FILE مضبوط لتحميل وحدة مضغوطة، وبُنيت النواة بدون CONFIG_MODULE_DECOMPRESS.

ETXTBSY (منذ لينكس 4.7)

الملف المشار إليه بـ fd مفتوح للقراءة والكتابة.

بالإضافة إلى الأخطاء أعلاه، إذا نُفذت دالة init للوحدة وأرجعت خطأ، فإن init_module() أو finit_module() تفشل ويُضبط errno على القيمة التي أرجعتها دالة init.

المعايير¶

لينكس.

التاريخ¶

finit_module()

لينكس 3.8.

استدعاء النظام init_module() غير مدعوم من glibc. لا يُقدم أي تصريح في رؤوس glibc، ولكن، من خلال غرابة تاريخية، أصدرت إصدارات glibc قبل glibc 2.23 واجهة ABI لاستدعاء النظام هذا. لذلك، لاستخدام استدعاء النظام هذا، يكفي (قبل glibc 2.23) التصريح يدويًا بالواجهة في شفرتك؛ بدلاً من ذلك، يمكنك استدعاء استدعاء النظام باستخدام syscall(2).

struct module {


    unsigned long         size_of_struct;


    struct module        *next;


    const char           *name;


    unsigned long         size;


    long                  usecount;


    unsigned long         flags;


    unsigned int          nsyms;


    unsigned int          ndeps;


    struct module_symbol *syms;


    struct module_ref    *deps;


    struct module_ref    *refs;


    typeof(int (void))   *init;


    typeof(void (void))  *cleanup;


    const struct exception_table_entry *ex_table_start;


    const struct exception_table_entry *ex_table_end;
#ifdef __alpha__


    unsigned long gp;
#endif
};

ملاحظات¶

يمكن العثور على معلومات حول الوحدات المحملة حاليًا في /proc/modules وفي أشجار الملفات تحت الدلائل الفرعية لكل وحدة تحت /sys/module.

انظر ملف مصدر نواة لينكس include/linux/module.h للحصول على بعض المعلومات الخلفية المفيدة.

انظر أيضًا¶

create_module(2)، delete_module(2)، query_module(2)، lsmod(8)، modprobe(8)

ترجمة¶

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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