.\" -*- coding: UTF-8 -*- '\" t .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH KERNEL\-INSTALL 8 "" "systemd 260.1" kernel\-install .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH الاسم kernel\-install \- إضافة وإزالة صور النواة وinitrd من وإلى قسم الإقلاع .SH موجز .HP \w'\fBkernel\-install\fR\ 'u \fBkernel\-install\fP [OPTIONS...] add \fIKERNEL\-VERSION\fP \fIKERNEL\-IMAGE\fP [\fIINITRD\-FILE\fP...] .HP \w'\fBkernel\-install\fR\ 'u \fBkernel\-install\fP [OPTIONS...] add\-all .HP \w'\fBkernel\-install\fR\ 'u \fBkernel\-install\fP [OPTIONS...] remove \fIKERNEL\-VERSION\fP .HP \w'\fBkernel\-install\fR\ 'u \fBkernel\-install\fP [OPTIONS...] inspect [\fIKERNEL\-VERSION\fP] [\fIKERNEL\-IMAGE\fP] [\fIINITRD\-FILE\fP...] .HP \w'\fBkernel\-install\fR\ 'u \fBkernel\-install\fP [OPTIONS...] list .SH الوصف .PP \fBkernel\-install\fP يُستخدم لتثبيت وإزالة صور النواة وinitrd \&\s-2\u[1]\d\s+2 من وإلى قسم الإقلاع، المشار إليه هنا بـ \fI$BOOT\fP\&. سيكون عادةً أحد /boot/ أو /efi/ أو /boot/efi/، انظر أدناه\&. .PP \fBkernel\-install\fP يشغّل الملفات القابلة للتنفيذ ("الإضافات") الموجودة في الدليل /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"؛ الامتدادات الأخرى تُتجاهل\&. .PP يجب أن يُرجع ملف قابل للتنفيذ موضوع في هذه الدلائل \fB0\fP عند النجاح\&. قد يُرجع أيضًا \fB77\fP لإنهاء العملية بأكملها (سيتم تخطي الملفات القابلة للتنفيذ التي تأتي لاحقًا في الترتيب المعجمي)\&. .SH الأوامر .PP الأوامر التالية مفهومة: .PP \fBadd [[[\fP\fIKERNEL\-VERSION\fP\fB] \fP\fIKERNEL\-IMAGE\fP\fB] [\fP\fIINITRD\-FILE\fP\fB \&.\&.\&.]]\fP .RS 4 يأخذ هذا الأمر سلسلة إصدار النواة ومسارًا لملف صورة النواة كوسائط\&. إذا تم حذف الأول، أو تحديده كسلسلة فارغة أو كـ "\-" فإنه يضع مبدئيًا إصدار النواة الحالي، أي نفس السلسلة التي يُرجعها \fBuname \-r\fP\&. إذا تم حذف الأخير، أو تحديده كسلسلة فارغة أو كـ "\-" فإنه يضع مبدئيًا /usr/lib/modules/\fIKERNEL_VERSION\fP/vmlinuz\&. اختياريًا، يمكن أيضًا تحديد صورة initrd واحدة أو أكثر (لاحظ أن الإضافات قد تُنشئ صورًا إضافية)\&. .sp تُستدعى الملفات القابلة للتنفيذ من /usr/lib/kernel/install\&.d/*\&.install و /etc/kernel/install\&.d/*\&.install (أي الإضافات) بالوسائط التالية: .sp .if n \{\ .RS 4 .\} .nf add \fIKERNEL\-VERSION\fP $BOOT/\fIENTRY\-TOKEN\fP/\fIKERNEL\-VERSION\fP/ \fIKERNEL\-IMAGE\fP [\fIINITRD\-FILE\fP \&.\&.\&.] .fi .if n \{\ .RE .\} .sp تشير الوسيطة الثالثة مباشرةً إلى المسار حيث توضع صور النواة وصور initrd والموارد الأخرى لإدخالات النوع #1 من \m[blue]\fBUAPI\&.1 Boot Loader Specification\fP\m[]\&\s-2\u[2]\d\s+2 (دليل الإدخال)\&. إذا تم استخدام مخططات أخرى لمُحمّل الإقلاع، قد تُتجاهل هذه المعلمة\&. .sp سلسلة \fIENTRY\-TOKEN\fP هي عادةً معرف الجهاز ومن المفترض أن تُحدد التثبيت المحلي على النظام\&. للتفاصيل انظر أدناه\&. .sp \fBkernel\-install\fP ينشئ $BOOT/\fIENTRY\-TOKEN\fP/\fIKERNEL\-VERSION\fP، إذا كان مفعّلاً (انظر \fI$KERNEL_INSTALL_LAYOUT\fP)\&. .sp ثلاث إضافات مبدئية تنفذ العمليات التالية في هذه الحالة: .PP 50\-depmod\&.install .RS 4 يشغل الملحق الأمر \fBdepmod\fP(8) من أجل \fIKERNEL\-VERSION\fP\&. .RE .PP 90\-loaderentry\&.install .RS 4 ينسخ الملحق \fIKERNEL\-IMAGE\fP إلى $BOOT/\fIENTRY\-TOKEN\fP/\fIKERNEL\-VERSION\fP/linux\&. إذا تم توفير \fIINITRD\-FILE\fP، فإنه ينسخها أيضًا إلى $BOOT/\fIENTRY\-TOKEN\fP/\fIKERNEL_VERSION\fP/\fIINITRD\-FILE\fP\&. يمكن استخدام هذا أيضًا لإضافة الشيفرة الدقيقة قبل initrd الفعلي\&. ينشئ أيضًا إدخال محمل إقلاع وفقًا لـ \m[blue]\fBUAPI\&.1 Boot Loader Specification\fP\m[]\&\s-2\u[2]\d\s+2 (النوع #1) في $BOOT/loader/entries/\fIENTRY\-TOKEN\fP\-\fIKERNEL\-VERSION\fP\&.conf\&. عنوان الإدخال هو المعامل \fIPRETTY_NAME\fP المحدد في /etc/os\-release أو /usr/lib/os\-release (إذا كان الأول مفقودًا)، أو "Linux \fIKERNEL\-VERSION\fP"، إذا لم يتم تعيينه\&. .sp إذا لم يكن \fI$KERNEL_INSTALL_LAYOUT\fP هو "bls"، فإن هذا الملحق لا يفعل شيئًا\&. .RE .PP 90\-uki\-copy\&.install .RS 4 إذا كان \fI$KERNEL_INSTALL_STAGING_AREA/uki\&.efi\fP موجودًا، ينسخه الملحق إلى $BOOT/EFI/Linux/\fIENTRY\-TOKEN\fP\-\fIKERNEL\-VERSION\fP\&.efi\&. أيضًا، تُنسخ الملفات في $KERNEL_INSTALL_STAGING_AREA/uki\&.efi\&.extra\&.d"/ إلى $BOOT/EFI/Linux/\fIENTRY\-TOKEN\fP\-\fIKERNEL\-VERSION\fP\&.efi\&.extra\&.d/\&. .sp إذا لم يكن المجلد \fI$KERNEL_INSTALL_STAGING_AREA/uki\&.efi\fP موجودًا، وكانت الحجة \fIKERNEL\-IMAGE\fP تحمل الامتداد ”\&.efi“، يقوم المكون الإضافي بنسخ الصورة إلى $BOOT/EFI/Linux/\fIENTRY\-TOKEN\fP\-\fIKERNEL\-VERSION\fP\&.efi\& . كما يتم نسخ الملفات الموجودة في \fIKERNEL\-IMAGE\fP\&.extra\&.d/ و $KERNEL_INSTALL_STAGING_AREA/uki\&.efi\&.extra\&.d"/ إلى $BOOT/EFI/Linux/\fIENTRY\-TOKEN\fP\-\fIKERNEL\-VERSION\fP\&.efi\&.extra\&.d/\&. .sp إذا لم يكن \fI$KERNEL_INSTALL_LAYOUT\fP هو "uki"، فإن هذا الملحق لا يفعل شيئًا\&. .RE .sp أُضيف في الإصدارة 198\&. .RE .PP \fBadd\-all\fP .RS 4 هذا مماثل لـ \fBadd\fP (انظر أعلاه)، لكنه يستدعي العملية بشكل تكراري لكل نواة مثبتة في /usr/lib/modules/\&. هذه العملية مدعومة فقط على الأنظمة التي تكون فيها صورة النواة مثبتة في /usr/lib/modules/\fIKERNEL\-VERSION\fP/vmlinuz\&. .sp أُضيف في الإصدار 255\&. .RE .PP \fBremove \fP\fIKERNEL\-VERSION\fP .RS 4 يتوقع هذا الأمر سلسلة إصدار نواة كوسيطة واحدة\&. .sp تُستدعى الملفات القابلة للتنفيذ من /usr/lib/kernel/install\&.d/*\&.install و /etc/kernel/install\&.d/*\&.install (أي الإضافات) بالوسائط التالية: .sp .if n \{\ .RS 4 .\} .nf remove \fIKERNEL\-VERSION\fP $BOOT/\fIENTRY\-TOKEN\fP/\fIKERNEL\-VERSION\fP/ .fi .if n \{\ .RE .\} .sp بعد ذلك، يزيل \fBkernel\-install\fP دليل الإدخال $BOOT/\fIENTRY\-TOKEN\fP/\fIKERNEL\-VERSION\fP/ ومحتوياته، إذا كان موجودًا\&. .sp ثلاث إضافات مبدئية تنفذ العمليات التالية في هذه الحالة: .PP 50\-depmod\&.install .RS 4 يزيل الملحق الملفات التي أنشأها \fBdepmod\fP لهذه النواة مرة أخرى\&. .RE .PP 90\-loaderentry\&.install .RS 4 يزيل الملحق الملف $BOOT/loader/entries/\fIENTRY\-TOKEN\fP\-\fIKERNEL\-VERSION\fP\&.conf\&. .RE .PP 90\-uki\-copy\&.install .RS 4 يزيل الملحق الملف $BOOT/EFI/Linux/\fIENTRY\-TOKEN\fP\-\fIKERNEL\-VERSION\fP\&.efi والدليل $BOOT/EFI/Linux/\fIENTRY\-TOKEN\fP\-\fIKERNEL\-VERSION\fP\&.efi\&.extra\&.d/ بما في ذلك محتوياته\&. .RE .sp أُضيف في الإصدارة 198\&. .RE .PP \fBinspect [[[\fP\fIKERNEL\-VERSION\fP\fB] \fP\fIKERNEL\-IMAGE\fP\fB] [\fP\fIINITRD\-FILE\fP\fB \&.\&.\&.]]\fP .RS 4 يأخذ نفس المعاملات مثل \fBadd\fP\&. .sp يعرض المسارات والمعاملات المختلفة المكونة أو المكتشفة آليًا\&. يعرض بشكل خاص قيم متغيرات البيئة \fI$KERNEL_INSTALL_*\fP المختلفة المدرجة أدناه، كما سيتم تمريرها إلى الملحقات\&. يمكن استخدام الخيار \fB\-\-json\fP للحصول على مخرجات هذا الفعل ككائن JSON\&. .sp أُضيف في الإصدار 251\&. .RE .PP \fBlist\fP .RS 4 يعرض النوى المختلفة المثبتة\&. يعدد الأدلة الفرعية لـ /usr/lib/modules/، ويظهر ما إذا كانت صورة نواة مثبتة هناك\&. .sp أُضيف في الإصدار 255\&. .RE .SH "التوافق مع نظام بناء النواة" .HP \w'\fBinstallkernel\fR\ 'u \fBinstallkernel\fP [خيارات...] إصدار VMLINUZ [خريطة] [دليل\-التثبيت] .PP عند استدعائه كـ \fBinstallkernel\fP، يقبل هذا البرنامج الوسائط كما هو محدد بواسطة أمر \fBmake install\fP لنظام بناء النواة\&. تحدد المعلمتان \fIإصدار\fP و \fIVMLINUZ\fP إصدار النواة وثنائي النواة\&. يتم تجاهل المعلمتين الأخريين (\fIخريطة\fP و \fIدليل\-التثبيت\fP) حالياً\&. .SH "قسم \FI$BOOT\FR" .PP يسمى القسم الذي توجد فيه النوى ومقتطفات \m[blue]\fBUAPI\&.1 مواصفات محمل الإقلاع\fP\m[]\&\s-2\u[2]\d\s+2 بـ \fI$BOOT\fP\&. يحدد \fBkernel\-install\fP موقع هذا القسم بالتحقق من /efi/ و /boot/ و /boot/efi/ بالتتابع\&. يُستخدم أول موقع يوجد فيه $BOOT/loader/entries/ أو $BOOT/\fIرمز\-الإدخال\fP/\&. .SH الخيارات .PP الخيارات التالية مفهومة: .PP \fB\-\-esp\-path=\fP .RS 4 المسار إلى قسم نظام EFI (ESP)\&. إذا لم يُحدد، تُفحص المسارات /efi/، و /boot/، و /boot/efi/ على التوالي\&. يوصى بوصل ESP في /efi/ إذا كان ذلك ممكناً\&. .RE .PP \fB\-\-boot\-path=\fP .RS 4 المسار إلى قسم محمل الإقلاع الموسع، كما هو معرف في \m[blue]\fBUAPI\&.1 مواصفات محمل الإقلاع\fP\m[]\&\s-2\u[2]\d\s+2\&. إذا لم يُحدد، يتم التحقق من /boot/\&. يُوصى بتثبيت قسم محمل الإقلاع الموسع على /boot/، إذا أمكن\&. .RE .PP \fB\-\-make\-entry\-directory=نعم|لا|تلقائي\fP .RS 4 يتحكم في إنشاء وحذف دليل الإدخال من النوع #1 لـ \m[blue]\fBUAPI\&.1 مواصفات محمل الإقلاع\fP\m[]\&\s-2\u[2]\d\s+2 على نظام الملفات الذي يحتوي على موارد مثل صور النواة و initrd أثناء \fBإضافة\fP و \fBإزالة\fP، على التوالي\&. يُسمى الدليل تيمناً برمز الإدخال، ويوضع مباشرة أسفل دليل جذر الإقلاع\&. عند "تلقائي"، يتم إنشاء الدليل أو حذفه فقط عندما يكون تخطيط التثبيت "bls"\&. المبدئي هو "تلقائي"\&. .sp أُضيف في الإصدار 254\&. .RE .PP \fB\-\-entry\-type=نوع1|نوع2|الكل\fP .RS 4 يتحكم في نوع الإدخالات التي يعالجها الأمر\&. يكون هذا مفيداً عادةً عندما تكون أنواع متعددة من إدخالات الإقلاع بنفس إصدار النواة مثبتة، ويجب إزالة واحد فقط\&. عند تحديد "نوع1" أو "نوع2"، يتم استدعاء كل إضافة مع متغير البيئة \fI$KERNEL_INSTALL_BOOT_ENTRY_TYPE\fP بالقيمة المحددة\&. عند تحديد "الكل"، لن يتم تعيين متغير البيئة\&. المبدئي هو "الكل"\&. .sp أُضيف في الإصدار 258\&. .RE .PP \fB\-\-entry\-token=\fP .RS 4 يتحكم في كيفية تسمية وتحديد إدخالات محمل الإقلاع لهذا التثبيت أو الحذف للنواة\&. يأخذ واحدة من "تلقائي"، "machine\-id"، "os\-id"، "os\-image\-id"، أو سلسلة عشوائية مسبوقة بـ "literal:" كوسيطة\&. .sp إذا ضُبطت على \fBmachine\-id\fP، فستُسمّى المدخلات تيمناً بمعرّف الحاسوب للنظام المشغّل (مثل: "b0e793a9baf14b5fa13ecbe84ff637ac"). انظر \fBmachine\-id\fP(5) لتفاصيل عن مفهوم معرّف الحاسوب وملفه. .sp إذا ضُبطت على \fBos\-id\fP، فستُسمّى المدخلات تيمناً بمعرّف نظام التشغيل للنظام المشغّل، أي حقل \fIID=\fP في \fBos\-release\fP(5) (مثل: "fedora"). وبالمثل، إذا ضُبطت على \fBos\-image\-id\fP، فستُسمّى المدخلات تيمناً بمعرّف صورة نظام التشغيل للنظام المشغّل، أي حقل \fIIMAGE_ID=\fP في os\-release (مثل: "vendorx\-cashier\-system"). .sp إذا تم تعيينه إلى \fBتلقائي\fP (المبدئي)، سيتم قراءة ملف /etc/kernel/entry\-token (أو $KERNEL_INSTALL_CONF_ROOT/entry\-token) إذا كان موجوداً، وسيتم استخدام القيمة المخزنة\&. بخلاف ذلك، إذا تمت تهيئة معرف الآلة المحلي، فسيتم استخدامه\&. بخلاف ذلك، سيتم استخدام \fIIMAGE_ID=\fP من os\-release، إذا تم تعيينه\&. بخلاف ذلك، سيتم استخدام \fIID=\fP من os\-release، إذا تم تعيينه\&. بخلاف ذلك، يتم استخدام معرف آلة مولّد عشوائياً\&. .sp استخدام معرف الآلة لتسمية الإدخالات هو الأفضل عموماً، ومع ذلك هناك حالات يكون فيها استخدام المعرفات الأخرى خياراً جيداً\&. تحديداً: إذا كان يجب ألا تُخزن بيانات التعريف التي يستلزمها معرف الآلة على قسم \fI$BOOT_ROOT\fP (غير المشفر)، أو إذا كان يجب إنشاء المعرف عند الإقلاع الأول ولا يكون معروفاً عند تحضير الإدخالات\&. لاحظ أن استخدام معرف الآلة له فائدة أن تثبيتات متعددة متوازية لنفس نظام التشغيل يمكن أن تتعايش على نفس الوسيط، ويمكنها تحديث إدخالات محمل الإقلاع الخاصة بها بشكل مستقل\&. عند استخدام معرف آخر (مثل معرف نظام التشغيل أو معرف صورة نظام التشغيل)، ستحاول التثبيتات المتوازية لنفس نظام التشغيل استخدام نفس اسم الإدخال\&. لدعم التثبيتات المتوازية، يجب على المثبت استخدام رمز إدخال مختلف عند إضافة تثبيت ثانٍ\&. .sp أُضيف في الإصدار 254\&. .RE .PP \fB\-v\fP، \fB\-\-verbose\fP .RS 4 يخرج معلومات إضافية حول العمليات التي يتم تنفيذها\&. .sp أُضيف في الإصدارة 242\&. .RE .PP \fB\-\-root=\fP\fIroot\fP .RS 4 يأخذ مسار دليل كوسيط\&. سيتم إلحاق بادئة مسار \fIroot\fP البديلة المعطاة لجميع المسارات، بما في ذلك مسارات البحث عن الضبط\&. هذا مفيد للعمل على صورة نظام موصولة بالدليل المحدد بدلاً من نظام المضيف نفسه\&. .sp أُضيف في الإصدار 255\&. .RE .PP \fB\-\-image=\fP\fIimage\fP .RS 4 يأخذ مساراً إلى ملف صورة قرص أو عقدة جهاز كتلة\&. إذا تم تحديده، يتم تطبيق جميع العمليات على نظام الملفات في صورة القرص المشار إليها\&. هذا الخيار مشابه لـ \fB\-\-root=\fP، لكنه يعمل على أنظمة الملفات المخزنة في صور الأقراص أو أجهزة الكتلة\&. يجب أن تحتوي صورة القرص إما على نظام ملفات فقط أو مجموعة من أنظمة الملفات ضمن جدول أقسام GPT، متبعةً \m[blue]\fBUAPI\&.2 مواصفات الأقسام القابلة للاكتشاف\fP\m[]\&\s-2\u[3]\d\s+2\&. لمزيد من المعلومات حول صور الأقراص المدعومة، راجع مفتاح \fBsystemd\-nspawn\fP(1) الذي يحمل نفس الاسم\&. .sp أُضيف في الإصدار 255\&. .RE .PP \fB\-h\fP، \fB\-\-help\fP .RS 4 اطبع نص مساعدة قصير واخرج\&. .RE .PP \fB\-\-version\fP .RS 4 اطبع سلسلة إصدار قصيرة واخرج\&. .RE .PP \fB\-\-no\-pager\fP .RS 4 لا تمرر المخرجات إلى برنامج عرض (pager)\&. .RE .PP \fB\-\-json=\fP\fIMODE\fP .RS 4 يظهر المخرجات منسقة بصيغة JSON\&. يتوقع أحد الخيارات: "short" (لأقصر مخرج ممكن دون أي مسافات زائدة أو فواصل أسطر)، أو "pretty" (لنسخة جميلة من المخرج نفسه، مع إزاحة وفواصل أسطر) أو "off" (لإيقاف مخرجات JSON، وهو الخيار المبدئي)\&. .RE .PP \fB\-\-image\-policy=\fP\fIالسياسة\fP .RS 4 يأخذ سلسلة سياسة صورة كوسييط، وفقًا لـ \fBsystemd.image\-policy\fP(7)\&. تُفرض السياسة عند العمل على صورة القرص المحددة عبر \fB\-\-image=\fP، انظر أعلاه\&. إذا لم تُحدد، فسيتم الرجوع إلى سياسة "*" المبدئية، أي تُستخدم جميع أنظمة الملفات المعروفة في الصورة\&. .RE .PP \fB\-\-no\-legend\fP .RS 4 لا تطبع مفتاح الرموز، أي ترويسات الأعمدة والتذييل المزود بالتلميحات\&. .RE .SH "متغيرات البيئة" .SS "متغيرات البيئة المصدرة للإضافات" .PP إذا تم استخدام \fB\-\-verbose\fP، سيتم تصدير \fI$KERNEL_INSTALL_VERBOSE=1\fP للإضافات\&. قد تخرج سجلات إضافية في هذه الحالة\&. .PP يتم تعيين \fI$KERNEL_INSTALL_IMAGE_TYPE=uki|pe|غير معروف\fP للإضافات لتحديد نوع صورة النواة\&. .PP uki .RS 4 صورة نواة موحدة\&. .sp أُضيف في الإصدار 254\&. .RE .PP pe .RS 4 ثنائي PE\&. .sp أُضيف في الإصدار 254\&. .RE .PP unknown .RS 4 نوع غير معروف\&. .sp أُضيف في الإصدار 254\&. .RE .PP يُضبط \fI$KERNEL_INSTALL_MACHINE_ID\fP للإضافات على معرف\-الآلة المطلوب استخدامه\&. وهو دائمًا معرف 128\-بت\&. يُقرأ عادةً من /etc/machine\-id، لكن يمكن تجاوزه عبر \fI$MACHINE_ID\fP (انظر أدناه)\&. إذا لم يُحدد عبر هذه الطرق، يُنشأ قيمة احتياطية بواسطة \fBkernel\-install\fP وتُستخدم لاستدعاء واحد فقط\&. .PP يُضبط \fI$KERNEL_INSTALL_ENTRY_TOKEN\fP للإضافات على "الرمز" المطلوب استخدامه\&. وهو معرّف يُستخدم لتعريف التثبيت المحلي، وغالبًا ما يكون معرف الآلة، أي نفس \fI$KERNEL_INSTALL_MACHINE_ID\fP، لكن قد يكون نوعًا مختلفًا من المعرفات، مثل سلسلة ثابتة أو قيم \fIID=\fP، \fIIMAGE_ID=\fP من /etc/os\-release\&. ستُستخدم السلسلة المُمررة هنا لتسمية إدخالات مواصفات محمل الإقلاع، أو الدلائل التي توضع فيها صورة النواة وصور قرص RAM الأولي\&. .PP لاحظ أنه بينما يُضبط \fI$KERNEL_INSTALL_ENTRY_TOKEN\fP و \fI$KERNEL_INSTALL_MACHINE_ID\fP غالبًا على نفس القيمة، يُضمن أن الأخير هو معرف صالح مكون من 32 حرفًا سداسيًا عشريًا صغيرًا بينما يمكن أن يكون الأول أي سلسلة قصيرة\&. يُقرأ رمز الإدخال المستخدم من /etc/kernel/entry\-token، إذا كان موجودًا\&. وإلا، تُفحص بعض المرشحات المحتملة أسفل \fI$BOOT\fP لدلائل إدخالات مواصفات محمل الإقلاع من النوع 1، وإذا وُجد يُشتق رمز الإدخال من ذلك\&. إذا لم ينجح ذلك، يُستخدم \fI$KERNEL_INSTALL_MACHINE_ID\fP كاحتياطي\&. .PP يُضبط \fI$KERNEL_INSTALL_BOOT_ROOT\fP للإضافات على المسار المطلق للدليل الجذر (نقطة التحميل، عادةً) للتسلسل الهرمي حيث توضع إدخالات محمل الإقلاع، وصور النواة، والموارد المرتبطة\&. هذا عادةً هو المسار حيث يُحمّل قسم XBOOTLDR أو ESP (قسم نظام EFI)، ويُشار إليه أيضًا نظريًا بـ \fI$BOOT\fP\&. يمكن تجاوزه بضبط \fI$BOOT_ROOT\fP (انظر أدناه)\&. .PP يُضبط \fI$KERNEL_INSTALL_LAYOUT=auto|bls|uki|other|\&.\&.\&.\fP للإضافات لتحديد تخطيط التثبيت\&. يمكن تعريف أسماء تخطيط إضافية بالاتفاق\&. إذا استخدمت إضافة تخطيطًا خاصًا، يُشجع على تعريف اسم تخطيط خاص بها وتكوين \fIlayout=\fP في install\&.conf عند التثبيت الأولي\&. القيم التالية مفهومة حاليًا: .PP bls .RS 4 تخطيط قياسي \m[blue]\fBUAPI\&.1 Boot Loader Specification\fP\m[]\&\s-2\u[2]\d\s+2 من النوع #1، متوافق مع \fBsystemd\-boot\fP(7): إدخالات في $BOOT/loader/entries/\fIENTRY\-TOKEN\fP\-\fIKERNEL\-VERSION\fP[+\fITRIES\fP]\&.conf، النواة و initrds تحت $BOOT/\fIENTRY\-TOKEN\fP/\fIKERNEL\-VERSION\fP/ .sp مُطبّق بواسطة 90\-loaderentry\&.install\&. .sp أُضيف في الإصدار 250\&. .RE .PP uki .RS 4 تخطيط قياسي \m[blue]\fBUAPI\&.1 Boot Loader Specification\fP\m[]\&\s-2\u[2]\d\s+2 من النوع #2، متوافق مع \fBsystemd\-boot\fP(7): صور نواة موحدة تحت $BOOT/EFI/Linux كـ $BOOT/EFI/Linux/\fIENTRY\-TOKEN\fP\-\fIKERNEL\-VERSION\fP[+\fITRIES\fP]\&.efi\&. .sp مُطبّق بواسطة 90\-uki\-copy\&.install\&. .sp أُضيف في الإصدار 253\&. .RE .PP other .RS 4 تخطيط آخر غير مفهوم أصلاً بواسطة \fBkernel\-install\fP\&. .sp أُضيف في الإصدار 250\&. .RE .PP auto .RS 4 اختر التخطيط آليًا\&. إذا كانت النواة UKI، اضبط التخطيط على \fBuki\fP\&. إذا لم تكن، فالمبدئي هو \fBbls\fP إذا كان $BOOT/loader/entries\&.srel بمحتوى "type1" أو $BOOT/\fIENTRY\-TOKEN\fP موجودًا، أو \fBother\fP خلاف ذلك\&. .sp ترك التخطيط فارغًا له نفس التأثير\&. هذا هو المبدئي\&. .sp أُضيف في الإصدار 254\&. .RE .PP يُضبط \fI$KERNEL_INSTALL_INITRD_GENERATOR\fP و \fI$KERNEL_INSTALL_UKI_GENERATOR\fP للإضافات لاختيار مولد initrd و/أو UKI\&. يمكن تكوين هذا كـ \fIinitrd_generator=\fP و \fIuki_generator=\fP في install\&.conf، انظر أدناه\&. .PP يُضبط \fI$KERNEL_INSTALL_STAGING_AREA\fP للإضافات على مسار إلى دليل\&. قد تضع الإضافات ملفات في ذلك الدليل، وسيتم تثبيتها كجزء من إدخال المحمل، بناءً على اسم الملف وامتداده: الملفات المسماة initrd* ستُثبّت كـ \fIINITRD\-FILE\fPs، والملفات المسماة microcode* ستُسبق قبل \fIINITRD\-FILE\fPs\&. .SS "متغيرات البيئة المفهومة بواسطة kernel\-install" .PP يمكن ضبط \fI$KERNEL_INSTALL_CONF_ROOT\fP لتجاوز موقع ملفات التهيئة التي يقرؤها \fBkernel\-install\fP\&. عند ضبطه، ستُقرأ install\&.conf وentry\-token والملفات الأخرى من هذا الدليل فقط\&. لاحظ أن هذا المسار نسبي للمضيف، وبشكل خاص \fIيتم حل الروابط الرمزية في هذا الدليل نسبة للمضيف\fP، حتى إذا استُخدم \fB\-\-root=\fP\fIroot\fP\&. هذا يعني أنه من \fIغير\fP الصحيح عمومًا استخدام هذا المتغير لتحديد دليل أسفل \fIroot\fP إذا استُخدمت روابط رمزية هناك\&. .PP يمكن ضبط \fI$KERNEL_INSTALL_PLUGINS\fP لتجاوز قائمة الإضافات التي ينفذها \fBkernel\-install\fP\&. الوسيطة هي قائمة من المسارات مفصولة بمسافات\&. يمكن استخدام "KERNEL_INSTALL_PLUGINS=:" لمنع تشغيل أي إضافات\&. .PP يمكن ضبط \fI$MACHINE_ID\fP لـ \fBkernel\-install\fP لتجاوز \fI$KERNEL_INSTALL_MACHINE_ID\fP، معرف الآلة\&. .PP يمكن ضبط \fI$BOOT_ROOT\fP لـ \fBkernel\-install\fP لتجاوز \fI$KERNEL_INSTALL_BOOT_ROOT\fP، موقع تثبيت مدخلات الإقلاع\&. .PP يمكن أيضًا ضبط المتغيرين الأخيرين في install\&.conf\&. المتغيرات المضبوطة في البيئة لها أولوية على القيم المحددة في ملف التهيئة\&. .SH "حالة الخروج" .PP إذا أعاد كل ملف قابل للتنفيذ 0 أو 77، يُعاد 0، وإلا يُعاد رمز فشل غير صفري\&. .SH الملفات .PP /etc/kernel/install\&.d/*\&.install, /usr/lib/kernel/install\&.d/*\&.install .RS 4 ملفات إضافية ينفذها \fBkernel\-install\fP\&. .sp أُضيف في الإصدارة 198\&. .RE .PP /etc/kernel/cmdline, /usr/lib/kernel/cmdline, /proc/cmdline .RS 4 يحدد سطر أوامر النواة المراد استخدامه\&. سيُستخدم أول ملف يتم العثور عليه\&. الأسطر التي تبدأ بالحرف "#" تُتجاهل\&. عند التشغيل في حاوية، يُتجاهل /proc/cmdline\&. يمكن استخدام \fI$KERNEL_INSTALL_CONF_ROOT\fP لتجاوز مسار البحث؛ انظر أدناه للتفاصيل\&. .sp أُضيف في الإصدارة 198\&. .RE .PP /etc/kernel/devicetree, /usr/lib/kernel/devicetree .RS 4 يحدد المسار الجزئي للملف الذي يحتوي على كتلة شجرة الجهاز المراد تثبيتها مع النواة واستخدامها عند الإقلاع\&. سيُستخدم أول ملف يتم العثور عليه\&. يمكن استخدام \fI$KERNEL_INSTALL_CONF_ROOT\fP لتجاوز مسار البحث؛ انظر أدناه للتفاصيل\&. .sp ملف شجرة الجهاز يحتوي على مسار، وهذا المسار يحدد موقعًا نسبيًا لشجرة تثبيت النواة\&. يتم التحقق من مجموعة من المواقع، بما في ذلك بشكل خاص /usr/lib/modules/\fIKERNEL_VERSION\fP/dtb/، وهو الموقع الموصى به لوضع ملفات dtb تحته\&. على سبيل المثال، مع "broadcom/bcm2711\-rpi\-4\-b\&.dtb" في ملف شجرة الجهاز، سيتم تثبيت كتلة شجرة الجهاز لـ Raspberry Pi 4 Model B، وسيكون الملف الفعلي هو /usr/lib/modules/\fIKERNEL_VERSION\fP/dtb/broadcom/bcm2711\-rpi\-4\-b\&.dtb\&. .sp أُضيف في الإصدار 255\&. .RE .PP /etc/kernel/tries .RS 4 يُقرأ بواسطة 90\-loaderentry\&.install و90\-uki\-copy\&.install\&. إذا كان هذا الملف موجودًا، تُقرأ قيمة رقمية منه ويُعدل تسمية ملف المدخل المُنشأ أو UKI لتضمينها كـ $BOOT/loader/entries/\fIENTRY\-TOKEN\fP\-\fIKERNEL\-VERSION\fP+\fITRIES\fP\&.conf أو $BOOT/EFI/Linux/\fIENTRY\-TOKEN\fP\-\fIKERNEL\-VERSION\fP+\fITRIES\fP\&.efi، على التوالي\&. هذا مفيد لمحملات الإقلاع مثل \fBsystemd\-boot\fP(7) التي تنفذ عد محاولات الإقلاع بعداد مضمن في اسم ملف المدخل\&. يمكن استخدام \fI$KERNEL_INSTALL_CONF_ROOT\fP لتجاوز مسار البحث؛ انظر أدناه للتفاصيل\&. .sp أُضيف في الإصدار 240\&. .RE .PP /etc/kernel/entry\-token .RS 4 إذا كان هذا الملف موجودًا، يُقرأ ويُستخدم كـ "رمز مدخل" لهذا النظام، أي يُستخدم لتسمية مدخلات مواصفات محمل الإقلاع\&. انظر \fI$KERNEL_INSTALL_ENTRY_TOKEN\fP أعلاه للتفاصيل\&. يمكن استخدام \fI$KERNEL_INSTALL_CONF_ROOT\fP لتجاوز مسار البحث؛ انظر أدناه للتفاصيل\&. .sp أُضيف في الإصدار 251\&. .RE .PP /etc/machine\-id .RS 4 محتوى هذا الملف يحدد تعريف الآلة \fIMACHINE\-ID\fP\&. .sp أُضيف في الإصدارة 198\&. .RE .PP /etc/os\-release, /usr/lib/os\-release .RS 4 يُقرأ بواسطة 90\-loaderentry\&.install\&. إذا كان متاحًا، يُقرأ \fIPRETTY_NAME=\fP من هذه الملفات ويُستخدم كعنوان لمدخل قائمة الإقلاع\&. وإلا، سيُستخدم "Linux \fIKERNEL\-VERSION\fP"\&. .sp أُضيف في الإصدارة 198\&. .RE .PP /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 .RS 4 ملف تهيئة مع خيارات لـ \fBkernel\-install\fP، كسلسلة من تعيينات \fIKEY=\fP\fIVALUE\fP، متوافقة مع صيغة الصدفة، تتبع نفس القواعد الموصوفة في \fBos\-release\fP(5)\&. سيُستخدم أول ملف يتم العثور عليه\&. يمكن استخدام \fI$KERNEL_INSTALL_CONF_ROOT\fP لتجاوز مسار البحث؛ انظر أدناه للتفاصيل\&. يمكن أيضًا استخدام الملفات الإضافية لتوسيع التهيئة مع تجاوزات، انظر \fBsystemd.unit\fP(5)\&. .sp حاليًا، المفاتيح التالية مدعومة: \fIMACHINE_ID=\fP، \fIBOOT_ROOT=\fP، \fIlayout=\fP، \fIinitrd_generator=\fP، \fIuki_generator=\fP\&. راجع قسم متغيرات البيئة أعلاه للتفاصيل\&. .sp أُضيف في الإصدار 250\&. .RE .PP /etc/kernel/uki\&.conf .RS 4 ملف تهيئة بنمط Ini لـ \fBukify\fP(1) والذي يكون فعّالًا فقط عندما يتم تعيين \fI$KERNEL_INSTALL_LAYOUT\fP أو \fIlayout=\fP في install\&.conf إلى \fBuki\fP ويتم تعيين \fI$KERNEL_INSTALL_UKI_GENERATOR\fP أو \fIuki_generator=\fP في install\&.conf إلى \fBukify\fP، أو يكون غير مضبوط\&. يمكن استخدام \fI$KERNEL_INSTALL_CONF_ROOT\fP لتجاوز مسار البحث؛ راجع أدناه للتفاصيل\&. .sp أُضيف في الإصدار 255\&. .RE .PP /usr/lib/modules/\fIKERNEL\-VERSION/\fP .RS 4 موقع وحدات النواة المثبتة والموارد الأخرى ذات الصلة بالنواة\&. لكل نواة مثبتة محليًا، يُحتفظ بدليل يُسمى باسم إصدار النواة (\fBuname \-r\fP)\&. .sp أُضيف في الإصدار 255\&. .RE .PP /usr/lib/modules/\fIKERNEL\-VERSION/vmlinuz\fP .RS 4 موقع صور النواة المثبتة\&. هذا هو الموقع الموصى به لمديري حزم نظام التشغيل لتثبيت صور النواة فيه (حسب الاقتضاء)، ومن ثم ينسخها \fBkernel\-install add\fP إلى قسم الإقلاع النهائي\&. .sp أُضيف في الإصدار 255\&. .RE .PP للحالات المختلفة المذكورة أعلاه، إذا تم تعيين متغير البيئة \fI$KERNEL_INSTALL_CONF_ROOT\fP، فإنه سيتجاوز مسار البحث\&. سيتم تحميل الملفات \fIفقط\fP من الدليل المحدد بواسطة متغير البيئة\&. عندما لا يكون المتغير مضبوطًا، تُجرّب المسارات المدرجة بالتتابع، ويُستخدم أول ملف موجود\&. .SH "انظر أيضًا" .PP \fBmachine\-id\fP(5)، \fBos\-release\fP(5)، \fBdepmod\fP(8)، \fBsystemd\-boot\fP(7)، \fBukify\fP(1)، \m[blue]\fBUAPI\&.1 Boot Loader Specification\fP\m[]\&\s-2\u[2]\d\s+2 .SH ملاحظات .IP " 1." 4 في الوقت الحالي، تُستخدم أرشيفات CPIO فعليًا كـ "initramfs" بدلاً من "initrd". راجع \fBbootup\fP(7) للشرح. .IP " 2." 4 مواصفات محمل الإقلاع UAPI.1 .RS 4 \%https://uapi\-group.org/specifications/specs/boot_loader_specification .RE .IP " 3." 4 UAPI.2 مواصفات الأقسام القابلة للاكتشاف .RS 4 \%https://uapi\-group.org/specifications/specs/discoverable_partitions_specification .RE .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .