KERNEL-INSTALL(8)

الاسم
kernel-install - إضافة وإزالة صور النواة وinitrd من وإلى قسم الإقلاع

موجز

kernel-install [OPTIONS...] add KERNEL-VERSION KERNEL-IMAGE [INITRD-FILE...]

kernel-install [OPTIONS...] add-all

kernel-install [OPTIONS...] remove KERNEL-VERSION

kernel-install [OPTIONS...] inspect [KERNEL-VERSION] [KERNEL-IMAGE] [INITRD-FILE...]

kernel-install [OPTIONS...] list

الوصف

kernel-install يُستخدم لتثبيت وإزالة صور النواة وinitrd [1] من وإلى قسم الإقلاع، المشار إليه هنا بـ $BOOT. سيكون عادةً أحد /boot/ أو /efi/ أو /boot/efi/، انظر أدناه.

kernel-install يشغّل الملفات القابلة للتنفيذ ("الإضافات") الموجودة في الدليل /usr/lib/kernel/install.d/ ودليل الإدارة المحلي /etc/kernel/install.d/. تُرتّب جميع الملفات وتُنفّذ بترتيب معجمي، بغض النظر عن الدليل الذي توجد فيه. ومع ذلك، الملفات ذات الأسماء المتطابقة تستبدل بعضها البعض. الملفات في /etc/kernel/install.d/ لها الأولوية على الملفات التي تحمل الاسم نفسه في /usr/lib/kernel/install.d/. يمكن استخدام هذا لتجاوز الملفات القابلة للتنفيذ المقدمة من النظام بملف محلي إذا لزم الأمر؛ رابط رمزي في /etc/kernel/install.d/ بنفس اسم ملف قابل للتنفيذ في /usr/lib/kernel/install.d/، يشير إلى /dev/null، يُعطّل الملف القابل للتنفيذ بالكامل. يجب أن يكون للملفات القابلة للتنفيذ الامتداد ".install"؛ الامتدادات الأخرى تُتجاهل.

يجب أن يُرجع ملف قابل للتنفيذ موضوع في هذه الدلائل 0 عند النجاح. قد يُرجع أيضًا 77 لإنهاء العملية بأكملها (ستُتخطى الملفات القابلة للتنفيذ التي تأتي لاحقًا في الترتيب المعجمي).

الأوامر

الأوامر التالية مفهومة:

add [[[KERNEL-VERSION] KERNEL-IMAGE] [INITRD-FILE ...]]
    يأخذ هذا الأمر سلسلة إصدار النواة ومسارًا لملف صورة النواة كوسائط. إذا حُذف الأول، أو تحديده كسلسلة فارغة أو كـ "-" فإنه يضع مبدئيًا إصدار النواة الحالي، أي نفس السلسلة التي يُرجعها uname -r. إذا حُذف الأخير، أو تحديده كسلسلة فارغة أو كـ "-" فإنه يضع مبدئيًا /usr/lib/modules/KERNEL_VERSION/vmlinuz. اختياريًا، يمكن أيضًا تحديد صورة initrd واحدة أو أكثر (لاحظ أن الإضافات قد تُنشئ صورًا إضافية).

    تُستدعى الملفات القابلة للتنفيذ من /usr/lib/kernel/install.d/*.install و /etc/kernel/install.d/*.install (أي الإضافات) بالوسائط التالية:

        add KERNEL-VERSION $BOOT/ENTRY-TOKEN/KERNEL-VERSION/ KERNEL-IMAGE [INITRD-FILE ...]

    تشير الوسيطة الثالثة مباشرةً إلى المسار حيث توضع صور النواة وصور initrd والموارد الأخرى لإدخالات النوع #1 من UAPI.1 Boot Loader Specification[2] (دليل الإدخال). إذا اُستخدم مخططات أخرى لمُحمّل الإقلاع، قد تُتجاهل هذه المعلمة.

    سلسلة ENTRY-TOKEN هي عادةً معرف الجهاز ومن المفترض أن تُحدد التثبيت المحلي على النظام. للتفاصيل انظر أدناه.

    kernel-install ينشئ $BOOT/ENTRY-TOKEN/KERNEL-VERSION، إذا كان مفعّلاً (انظر $KERNEL_INSTALL_LAYOUT).

    ثلاث إضافات مبدئية تنفذ العمليات التالية في هذه الحالة:

    50-depmod.install
        يشغل الملحق الأمر depmod(8) من أجل KERNEL-VERSION.

    90-loaderentry.install
        ينسخ الملحق KERNEL-IMAGE إلى $BOOT/ENTRY-TOKEN/KERNEL-VERSION/linux. إذا وُفر INITRD-FILE، فإنه ينسخها أيضًا إلى $BOOT/ENTRY-TOKEN/KERNEL_VERSION/INITRD-FILE. يمكن استخدام هذا أيضًا لإضافة الشيفرة الدقيقة قبل initrd الفعلي. ينشئ أيضًا إدخال محمل إقلاع وفقًا لـ UAPI.1 Boot Loader Specification[2] (النوع #1) في $BOOT/loader/entries/ENTRY-TOKEN-KERNEL-VERSION.conf. عنوان الإدخال هو المعامل PRETTY_NAME المحدد في /etc/os-release أو /usr/lib/os-release (إذا كان الأول مفقودًا)، أو "Linux KERNEL-VERSION"، إذا لم يُعينه.

        إذا لم يكن $KERNEL_INSTALL_LAYOUT هو "bls"، فإن هذا الملحق لا يفعل شيئًا.

    90-uki-copy.install
        إذا كان $KERNEL_INSTALL_STAGING_AREA/uki.efi موجودًا، ينسخه الملحق إلى $BOOT/EFI/Linux/ENTRY-TOKEN-KERNEL-VERSION.efi. أيضًا، تُنسخ الملفات في $KERNEL_INSTALL_STAGING_AREA/uki.efi.extra.d"/ إلى $BOOT/EFI/Linux/ENTRY-TOKEN-KERNEL-VERSION.efi.extra.d/.

        إذا لم يكن المجلد $KERNEL_INSTALL_STAGING_AREA/uki.efi موجودًا، وكانت الحجة KERNEL-IMAGE تحمل الامتداد ”.efi“، يقوم المكون الإضافي بنسخ الصورة إلى $BOOT/EFI/Linux/ENTRY-TOKEN-KERNEL-VERSION.efi . كما تُنسخ الملفات الموجودة في KERNEL-IMAGE.extra.d/ و $KERNEL_INSTALL_STAGING_AREA/uki.efi.extra.d"/ إلى $BOOT/EFI/Linux/ENTRY-TOKEN-KERNEL-VERSION.efi.extra.d/.

        إذا لم يكن $KERNEL_INSTALL_LAYOUT هو "uki"، فإن هذا الملحق لا يفعل شيئًا.

    أُضيف في الإصدارة 198.

add-all
    هذا مماثل لـ add (انظر أعلاه)، لكنه يستدعي العملية بشكل تكراري لكل نواة مثبتة في /usr/lib/modules/. هذه العملية مدعومة فقط على الأنظمة التي تكون فيها صورة النواة مثبتة في /usr/lib/modules/KERNEL-VERSION/vmlinuz.

    أُضيف في الإصدار 255.

remove KERNEL-VERSION
    يتوقع هذا الأمر سلسلة إصدار نواة كوسيطة واحدة.

    تُستدعى الملفات القابلة للتنفيذ من /usr/lib/kernel/install.d/*.install و /etc/kernel/install.d/*.install (أي الإضافات) بالوسائط التالية:

        remove KERNEL-VERSION $BOOT/ENTRY-TOKEN/KERNEL-VERSION/

    بعد ذلك، يزيل kernel-install دليل الإدخال $BOOT/ENTRY-TOKEN/KERNEL-VERSION/ ومحتوياته، إذا كان موجودًا.

    ثلاث إضافات مبدئية تنفذ العمليات التالية في هذه الحالة:

    50-depmod.install
        يزيل الملحق الملفات التي أنشأها depmod لهذه النواة مرة أخرى.

    90-loaderentry.install
        يزيل الملحق الملف $BOOT/loader/entries/ENTRY-TOKEN-KERNEL-VERSION.conf.

    90-uki-copy.install
        يزيل الملحق الملف $BOOT/EFI/Linux/ENTRY-TOKEN-KERNEL-VERSION.efi والدليل $BOOT/EFI/Linux/ENTRY-TOKEN-KERNEL-VERSION.efi.extra.d/ بما في ذلك محتوياته.

    أُضيف في الإصدارة 198.

inspect [[[KERNEL-VERSION] KERNEL-IMAGE] [INITRD-FILE ...]]
    يأخذ نفس المعاملات مثل add.

    يعرض المسارات والمعاملات المختلفة المكونة أو المكتشفة آليًا. يعرض بشكل خاص قيم متغيرات البيئة $KERNEL_INSTALL_* المختلفة المدرجة أدناه، كما سيُمرر إلى الملحقات. يمكن استخدام الخيار --json للحصول على مخرجات هذا الفعل ككائن JSON.

    أُضيف في الإصدار 251.

list
    يعرض النوى المختلفة المثبتة. يعدد الأدلة الفرعية لـ /usr/lib/modules/، ويظهر ما إذا كانت صورة نواة مثبتة هناك.

    أُضيف في الإصدار 255.

التوافق مع نظام بناء النواة

installkernel [خيارات...] إصدار VMLINUZ [خريطة] [دليل-التثبيت]

عند استدعائه كـ installkernel، يقبل هذا البرنامج الوسائط كما هو محدد بواسطة أمر make install لنظام بناء النواة. تحدد المعلمتان إصدار و VMLINUZ إصدار النواة وثنائي النواة. يُتجاهل المعلمتين الأخريين (MAP و INSTALLATION-DIR) حالياً.

قسم $BOOT

يسمى القسم الذي توجد فيه النوى ومقتطفات UAPI.1 مواصفات محمل الإقلاع[2] بـ $BOOT. يحدد kernel-install موقع هذا القسم بالتحقق من /efi/ و /boot/ و /boot/efi/ بالتتابع. يُستخدم أول موقع يوجد فيه $BOOT/loader/entries/ أو $BOOT/رمز-الإدخال/.

الخيارات

الخيارات التالية مفهومة:

--esp-path=
    المسار إلى قسم نظام EFI (ESP). إذا لم يُحدد، تُفحص المسارات /efi/، و /boot/، و /boot/efi/ على التوالي. يوصى بوصل ESP في /efi/ إذا كان ذلك ممكناً.

--boot-path=
    المسار إلى قسم محمل الإقلاع الموسع، كما هو معرف في UAPI.1 مواصفات محمل الإقلاع[2]. إذا لم يُحدد، يُتحقق من /boot/. يُوصى بتثبيت قسم محمل الإقلاع الموسع على /boot/، إذا أمكن.

--make-entry-directory=نعم|لا|تلقائي
    يتحكم في إنشاء وحذف دليل الإدخال من النوع #1 لـ UAPI.1 مواصفات محمل الإقلاع[2] على نظام الملفات الذي يحتوي على موارد مثل صور النواة و initrd أثناء add و remove، على التوالي. يُسمى الدليل تيمناً برمز الإدخال، ويوضع مباشرة أسفل دليل جذر الإقلاع. عند "auto"، يُنشئ الدليل أو حذفه فقط عندما يكون تخطيط التثبيت "bls". المبدئي هو "تلقائي".

    أُضيف في الإصدار 254.

--entry-type=نوع1|نوع2|الكل
    يتحكم في نوع الإدخالات التي يعالجها الأمر. يكون هذا مفيداً عادةً عندما تكون أنواع متعددة من إدخالات الإقلاع بنفس إصدار النواة مثبتة، ويجب إزالة واحد فقط. عند تحديد "نوع1" أو "نوع2"، تُستدعى كل إضافة مع متغير البيئة $KERNEL_INSTALL_BOOT_ENTRY_TYPE بالقيمة المحددة. عند تحديد "الكل"، لن يُعين متغير البيئة. المبدئي هو "الكل".

    أُضيف في الإصدار 258.

--entry-token=
    يتحكم في كيفية تسمية وتحديد إدخالات محمل الإقلاع لهذا التثبيت أو الحذف للنواة. يأخذ واحدة من "تلقائي"، "machine-id"، "os-id"، "os-image-id"، أو سلسلة عشوائية مسبوقة بـ "literal:" كوسيطة.

    إذا ضُبطت على machine-id، فستُسمّى المدخلات تيمناً بمعرّف الحاسوب للنظام المشغّل (مثل: "b0e793a9baf14b5fa13ecbe84ff637ac"). انظر machine-id(5) لتفاصيل عن مفهوم معرّف الحاسوب وملفه.

    إذا ضُبطت على os-id، فستُسمّى المدخلات تيمناً بمعرّف نظام التشغيل للنظام المشغّل، أي حقل ID= في os-release(5) (مثل: "fedora"). وبالمثل، إذا ضُبطت على os-image-id، فستُسمّى المدخلات تيمناً بمعرّف صورة نظام التشغيل للنظام المشغّل، أي حقل IMAGE_ID= في os-release (مثل: "vendorx-cashier-system").

    إذا عُينه إلى auto (المبدئي)، سيُقرأ ملف /etc/kernel/entry-token (أو $KERNEL_INSTALL_CONF_ROOT/entry-token) إذا كان موجوداً، و تُستخدم القيمة المخزنة. بخلاف ذلك، إذا هُيئ معرف الآلة المحلي، فسيُستخدم . بخلاف ذلك، سياُستخدم IMAGE_ID= من os-release، إذا عُين . بخلاف ذلك، سيُستخدم ID= من os-release، إذا عُينه. بخلاف ذلك، ياُستخدم معرف آلة مولّد عشوائياً.

    استخدام معرف الآلة لتسمية الإدخالات هو الأفضل عموماً، ومع ذلك هناك حالات يكون فيها استخدام المعرفات الأخرى خياراً جيداً. تحديداً: إذا كان يجب ألا تُخزن بيانات التعريف التي يستلزمها معرف الآلة على قسم $BOOT_ROOT (غير مُعمى)، أو إذا كان يجب إنشاء المعرف عند الإقلاع الأول ولا يكون معروفاً عند تحضير الإدخالات. لاحظ أن استخدام معرف الآلة له فائدة أن تثبيتات متعددة متوازية لنفس نظام التشغيل يمكن أن تتعايش على نفس الوسيط، ويمكنها تحديث إدخالات محمل الإقلاع الخاصة بها بشكل مستقل. عند استخدام معرف آخر (مثل معرف نظام التشغيل أو معرف صورة نظام التشغيل)، ستحاول التثبيتات المتوازية لنفس نظام التشغيل استخدام نفس اسم الإدخال. لدعم التثبيتات المتوازية، يجب على المثبت استخدام رمز إدخال مختلف عند إضافة تثبيت ثانٍ.

    أُضيف في الإصدار 254.

-v، --verbose
    يخرج معلومات إضافية حول العمليات التي تُنفذ.

    أُضيف في الإصدارة 242.

--root=جذر
    يأخذ مسار دليل كوسيط. سَتُلْحَقُ بادئة مسار root البديلة المعطاة لجميع المسارات، بما في ذلك مسارات البحث عن الضبط. هذا مفيد للعمل على صورة نظام موصولة بالدليل المحدد بدلاً من نظام المضيف نفسه.

    أُضيف في الإصدار 255.

--image=image
    يأخذ مساراً إلى ملف صورة قرص أو عقدة جهاز كتلة. إذا حُدد، يُطبق جميع العمليات على نظام الملفات في صورة القرص المشار إليها. هذا الخيار مشابه لـ --root=، لكنه يعمل على أنظمة الملفات المخزنة في صور الأقراص أو أجهزة الكتلة. يجب أن تحتوي صورة القرص إما على نظام ملفات فقط أو مجموعة من أنظمة الملفات ضمن جدول أقسام GPT، متبعةً UAPI.2 مواصفات الأقسام القابلة للاكتشاف[3]. لمزيد من المعلومات حول صور الأقراص المدعومة، راجع مفتاح systemd-nspawn(1) الذي يحمل نفس الاسم.

    أُضيف في الإصدار 255.

-h، --help
    اطبع نص مساعدة قصير واخرج.

--version
    اطبع سلسلة إصدار قصيرة واخرج.

--no-pager
    لا تمرر المخرجات إلى برنامج عرض (pager).

--json=وضع
    يظهر المخرجات منسقة بصيغة JSON. يتوقع أحد الخيارات: "short" (لأقصر مخرج ممكن دون أي مسافات زائدة أو فواصل أسطر)، أو "pretty" (لنسخة جميلة من المخرج نفسه، مع إزاحة وفواصل أسطر) أو "off" (لإيقاف مخرجات JSON، وهو الخيار المبدئي).

--image-policy=السياسة
    يأخذ سلسلة سياسة صورة كوسييط، وفقًا لـ systemd.image-policy(7). تُفرض السياسة عند العمل على صورة القرص المحددة عبر --image=، انظر أعلاه. إذا لم تُحدد، فسيُرجع إلى سياسة "*" المبدئية، أي تُستخدم جميع أنظمة الملفات المعروفة في الصورة.

--no-legend
    لا تطبع مفتاح الرموز، أي ترويسات الأعمدة والتذييل المزود بالتلميحات.

متغيرات البيئة

  متغيرات البيئة المصدرة للإضافات

إذا اُستخدم --verbose، سيُصدر $KERNEL_INSTALL_VERBOSE=1 للإضافات. قد تخرج سجلات إضافية في هذه الحالة.

يُعين $KERNEL_INSTALL_IMAGE_TYPE=uki|pe|غير معروف للإضافات لتحديد نوع صورة النواة.

uki
    صورة نواة موحدة.

    أُضيف في الإصدار 254.

pe
    ثنائي PE.

    أُضيف في الإصدار 254.

unknown
    نوع غير معروف.

    أُضيف في الإصدار 254.

يُضبط $KERNEL_INSTALL_MACHINE_ID للإضافات على معرف-الآلة المطلوب استخدامه. وهو دائمًا معرف 128-بت. يُقرأ عادةً من /etc/machine-id، لكن يمكن تجاوزه عبر $MACHINE_ID (انظر أدناه). إذا لم يُحدد عبر هذه الطرق، يُنشأ قيمة احتياطية بواسطة kernel-install وتُستخدم لاستدعاء واحد فقط.

يُضبط $KERNEL_INSTALL_ENTRY_TOKEN للإضافات على "الرمز" المطلوب استخدامه. وهو معرّف يُستخدم لتعريف التثبيت المحلي، وغالبًا ما يكون معرف الآلة، أي نفس $KERNEL_INSTALL_MACHINE_ID، لكن قد يكون نوعًا مختلفًا من المعرفات، مثل سلسلة ثابتة أو قيم ID=، IMAGE_ID= من /etc/os-release. ستُستخدم السلسلة المُمررة هنا لتسمية إدخالات مواصفات محمل الإقلاع، أو الدلائل التي توضع فيها صورة النواة وصور قرص RAM الأولي.

لاحظ أنه بينما يُضبط $KERNEL_INSTALL_ENTRY_TOKEN و $KERNEL_INSTALL_MACHINE_ID غالبًا على نفس القيمة، يُضمن أن الأخير هو معرف صالح مكون من 32 حرفًا سداسيًا عشريًا صغيرًا بينما يمكن أن يكون الأول أي سلسلة قصيرة. يُقرأ رمز الإدخال المستخدم من /etc/kernel/entry-token، إذا كان موجودًا. وإلا، تُفحص بعض المرشحات المحتملة أسفل $BOOT لدلائل إدخالات مواصفات محمل الإقلاع من النوع 1، وإذا وُجد يُشتق رمز الإدخال من ذلك. إذا لم ينجح ذلك، يُستخدم $KERNEL_INSTALL_MACHINE_ID كاحتياطي.

يُضبط $KERNEL_INSTALL_BOOT_ROOT للإضافات على المسار المطلق للدليل الجذر (نقطة التحميل، عادةً) للتسلسل الهرمي حيث توضع إدخالات محمل الإقلاع، وصور النواة، والموارد المرتبطة. هذا عادةً هو المسار حيث يُحمّل قسم XBOOTLDR أو ESP (قسم نظام EFI)، ويُشار إليه أيضًا نظريًا بـ $BOOT. يمكن تجاوزه بضبط $BOOT_ROOT (انظر أدناه).

يُضبط $KERNEL_INSTALL_LAYOUT=auto|bls|uki|other|... للإضافات لتحديد تخطيط التثبيت. يمكن تعريف أسماء تخطيط إضافية بالاتفاق. إذا استخدمت إضافة تخطيطًا خاصًا، يُشجع على تعريف اسم تخطيط خاص بها وتكوين layout= في install.conf عند التثبيت الأولي. القيم التالية مفهومة حاليًا:

bls
    تخطيط قياسي UAPI.1 Boot Loader Specification[2] من النوع #1، متوافق مع systemd-boot(7): إدخالات في $BOOT/loader/entries/ENTRY-TOKEN-KERNEL-VERSION[+TRIES].conf، النواة و initrds تحت $BOOT/ENTRY-TOKEN/KERNEL-VERSION/

    مُطبّق بواسطة 90-loaderentry.install.

    أُضيف في الإصدار 250.

uki
    تخطيط قياسي UAPI.1 Boot Loader Specification[2] من النوع #2، متوافق مع systemd-boot(7): صور نواة موحدة تحت $BOOT/EFI/Linux كـ $BOOT/EFI/Linux/ENTRY-TOKEN-KERNEL-VERSION[+TRIES].efi.

    مُطبّق بواسطة 90-uki-copy.install.

    أُضيف في الإصدار 253.

other
    تخطيط آخر غير مفهوم أصلاً بواسطة kernel-install.

    أُضيف في الإصدار 250.

auto
    اختر التخطيط آليًا. إذا كانت النواة UKI، اضبط التخطيط على uki. إذا لم تكن، فالمبدئي هو bls إذا كان $BOOT/loader/entries.srel بمحتوى "type1" أو $BOOT/ENTRY-TOKEN موجودًا، أو other خلاف ذلك.

    ترك التخطيط فارغًا له نفس التأثير. هذا هو المبدئي.

    أُضيف في الإصدار 254.

يُضبط $KERNEL_INSTALL_INITRD_GENERATOR و $KERNEL_INSTALL_UKI_GENERATOR للإضافات لاختيار مولد initrd و/أو UKI. يمكن تكوين هذا كـ initrd_generator= و uki_generator= في install.conf، انظر أدناه.

يُضبط $KERNEL_INSTALL_STAGING_AREA للإضافات على مسار إلى دليل. قد تضع الإضافات ملفات في ذلك الدليل، وستُثبت كجزء من إدخال المحمل، بناءً على اسم الملف وامتداده: الملفات المسماة initrd* ستُثبّت كـ INITRD-FILEs، والملفات المسماة microcode* ستُسبق قبل INITRD-FILEs.

  متغيرات البيئة المفهومة بواسطة kernel-install

يمكن ضبط $KERNEL_INSTALL_CONF_ROOT لتجاوز موقع ملفات التهيئة التي يقرؤها kernel-install. عند ضبطه، ستُقرأ install.conf وentry-token والملفات الأخرى من هذا الدليل فقط. لاحظ أن هذا المسار نسبي للمضيف، وبشكل خاص تُحل الروابط الرمزية في هذا الدليل نسبة للمضيف، حتى إذا استُخدم --root=root. هذا يعني أنه من غير الصحيح عمومًا استخدام هذا المتغير لتحديد دليل أسفل root إذا استُخدمت روابط رمزية هناك.

يمكن ضبط $KERNEL_INSTALL_PLUGINS لتجاوز قائمة الإضافات التي ينفذها kernel-install. الوسيطة هي قائمة من المسارات مفصولة بمسافات. يمكن استخدام "KERNEL_INSTALL_PLUGINS=:" لمنع تشغيل أي إضافات.

يمكن ضبط $MACHINE_ID لـ kernel-install لتجاوز $KERNEL_INSTALL_MACHINE_ID، معرف الآلة.

يمكن ضبط $BOOT_ROOT لـ kernel-install لتجاوز $KERNEL_INSTALL_BOOT_ROOT، موقع تثبيت مدخلات الإقلاع.

يمكن أيضًا ضبط المتغيرين الأخيرين في install.conf. المتغيرات المضبوطة في البيئة لها أولوية على القيم المحددة في ملف التهيئة.

حالة الخروج

إذا أعاد كل ملف قابل للتنفيذ 0 أو 77، يُعاد 0، وإلا يُعاد رمز فشل غير صفري.

الملفات

/etc/kernel/install.d/*.install, /usr/lib/kernel/install.d/*.install
    ملفات إضافية ينفذها kernel-install.

    أُضيف في الإصدارة 198.

/etc/kernel/cmdline, /usr/lib/kernel/cmdline, /proc/cmdline
    يحدد سطر أوامر النواة المراد استخدامه. سيُستخدم أول ملف يُعثر عليه. الأسطر التي تبدأ بالحرف "#" تُتجاهل. عند التشغيل في حاوية، يُتجاهل /proc/cmdline. يمكن استخدام $KERNEL_INSTALL_CONF_ROOT لتجاوز مسار البحث؛ انظر أدناه للتفاصيل.

    أُضيف في الإصدارة 198.

/etc/kernel/devicetree, /usr/lib/kernel/devicetree
    يحدد المسار الجزئي للملف الذي يحتوي على كتلة شجرة الجهاز المراد تثبيتها مع النواة واستخدامها عند الإقلاع. سيُستخدم أول ملف يُعثر عليه. يمكن استخدام $KERNEL_INSTALL_CONF_ROOT لتجاوز مسار البحث؛ انظر أدناه للتفاصيل.

    ملف شجرة الجهاز يحتوي على مسار، وهذا المسار يحدد موقعًا نسبيًا لشجرة تثبيت النواة. يُتحقق من مجموعة من المواقع، بما في ذلك بشكل خاص /usr/lib/modules/KERNEL_VERSION/dtb/، وهو الموقع الموصى به لوضع ملفات dtb تحته. على سبيل المثال، مع "broadcom/bcm2711-rpi-4-b.dtb" في ملف شجرة الجهاز، ستُثبت كتلة شجرة الجهاز لـ Raspberry Pi 4 Model B، وسيكون الملف الفعلي هو /usr/lib/modules/KERNEL_VERSION/dtb/broadcom/bcm2711-rpi-4-b.dtb.

    أُضيف في الإصدار 255.

/etc/kernel/tries
    يُقرأ بواسطة 90-loaderentry.install و90-uki-copy.install. إذا كان هذا الملف موجودًا، تُقرأ قيمة رقمية منه ويُعدل تسمية ملف المدخل المُنشأ أو UKI لتضمينها كـ $BOOT/loader/entries/ENTRY-TOKEN-KERNEL-VERSION+TRIES.conf أو $BOOT/EFI/Linux/ENTRY-TOKEN-KERNEL-VERSION+TRIES.efi، على التوالي. هذا مفيد لمحملات الإقلاع مثل systemd-boot(7) التي تنفذ عد محاولات الإقلاع بعداد مضمن في اسم ملف المدخل. يمكن استخدام $KERNEL_INSTALL_CONF_ROOT لتجاوز مسار البحث؛ انظر أدناه للتفاصيل.

    أُضيف في الإصدار 240.

/etc/kernel/entry-token
    إذا كان هذا الملف موجودًا، يُقرأ ويُستخدم كـ "رمز مدخل" لهذا النظام، أي يُستخدم لتسمية مدخلات مواصفات محمل الإقلاع. انظر $KERNEL_INSTALL_ENTRY_TOKEN أعلاه للتفاصيل. يمكن استخدام $KERNEL_INSTALL_CONF_ROOT لتجاوز مسار البحث؛ انظر أدناه للتفاصيل.

    أُضيف في الإصدار 251.

/etc/machine-id
    محتوى هذا الملف يحدد تعريف الآلة MACHINE-ID.

    أُضيف في الإصدارة 198.

/etc/os-release, /usr/lib/os-release
    يُقرأ بواسطة 90-loaderentry.install. إذا كان متاحًا، يُقرأ PRETTY_NAME= من هذه الملفات ويُستخدم كعنوان لمدخل قائمة الإقلاع. وإلا، سيُستخدم "Linux KERNEL-VERSION".

    أُضيف في الإصدارة 198.

/etc/kernel/install.conf, /run/kernel/install.conf, /usr/local/lib/kernel/install.conf, /usr/lib/kernel/install.conf, /etc/kernel/install.conf.d/*.conf, /run/kernel/install.conf.d/*.conf, /usr/local/lib/kernel/install.conf.d/*.conf, /usr/lib/kernel/install.conf.d/*.conf
    ملف تهيئة مع خيارات لـ kernel-install، كسلسلة من تعيينات KEY=VALUE، متوافقة مع صيغة الصدفة، تتبع نفس القواعد الموصوفة في os-release(5). سيُستخدم أول ملف يُعثر عليه. يمكن استخدام $KERNEL_INSTALL_CONF_ROOT لتجاوز مسار البحث؛ انظر أدناه للتفاصيل. يمكن أيضًا استخدام الملفات الإضافية لتوسيع التهيئة مع تجاوزات، انظر systemd.unit(5).

    حاليًا، المفاتيح التالية مدعومة: MACHINE_ID=، BOOT_ROOT=، layout=، initrd_generator=، uki_generator=. راجع قسم متغيرات البيئة أعلاه للتفاصيل.

    أُضيف في الإصدار 250.

/etc/kernel/uki.conf
    ملف تهيئة بنمط Ini لـ ukify(1) والذي يكون فعّالًا فقط عندما يُعين $KERNEL_INSTALL_LAYOUT أو layout= في install.conf إلى uki ويُعين $KERNEL_INSTALL_UKI_GENERATOR أو uki_generator= في install.conf إلى ukify، أو يكون غير مضبوط. يمكن استخدام $KERNEL_INSTALL_CONF_ROOT لتجاوز مسار البحث؛ راجع أدناه للتفاصيل.

    أُضيف في الإصدار 255.

/usr/lib/modules/KERNEL-VERSION/
    موقع وحدات النواة المثبتة والموارد الأخرى ذات الصلة بالنواة. لكل نواة مثبتة محليًا، يُحتفظ بدليل يُسمى باسم إصدار النواة (uname -r).

    أُضيف في الإصدار 255.

/usr/lib/modules/KERNEL-VERSION/vmlinuz
    موقع صور النواة المثبتة. هذا هو الموقع الموصى به لمديري حزم نظام التشغيل لتثبيت صور النواة فيه (حسب الاقتضاء)، ومن ثم ينسخها kernel-install add إلى قسم الإقلاع النهائي.

    أُضيف في الإصدار 255.

للحالات المختلفة المذكورة أعلاه، إذا عُين متغير البيئة $KERNEL_INSTALL_CONF_ROOT، فإنه سيتجاوز مسار البحث. ستُحمل الملفات فقط من الدليل المحدد بواسطة متغير البيئة. عندما لا يكون المتغير مضبوطًا، تُجرّب المسارات المدرجة بالتتابع، ويُستخدم أول ملف موجود.

انظر أيضًا

machine-id(5)، os-release(5)، depmod(8)، systemd-boot(7)، ukify(1)، UAPI.1 Boot Loader Specification[2]

ملاحظات

1.  في الوقت الحالي، تُستخدم أرشيفات CPIO فعليًا كـ "initramfs" بدلاً من "initrd". راجع bootup(7) للشرح.

2.  مواصفات محمل الإقلاع UAPI.1
    https://uapi-group.org/specifications/specs/boot_loader_specification

3.  UAPI.2 مواصفات الأقسام القابلة للاكتشاف
    https://uapi-group.org/specifications/specs/discoverable_partitions_specification

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

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

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