BOOTCTL(1)

الاسم
bootctl - التحكم في إعدادات إقلاع برمجيات EFI الثابتة وإدارة محمل الإقلاع

موجز

bootctl [الخيارات...] {الأمر}

الوصف

يمكن لـ bootctl فحص حالة برمجيات EFI الثابتة ومحمل الإقلاع، وسرد وإدارة مدخلات محمل الإقلاع المتاحة، وتثبيت أو تحديث أو إزالة محمل الإقلاع systemd-boot(7) على النظام الحالي.

أوامر برمجيات EFI الثابتة/محمل الإقلاع العامة

تتوفر هذه الأوامر على أي نظام EFI، بغض النظر عن محمل الإقلاع المستخدم.

status
    يعرض معلومات موجزة عن برمجيات النظام الثابتة، ومحمل الإقلاع الذي استُخدم لإقلاع النظام، ومحملات الإقلاع المتاحة حالياً في ESP، ومحملات الإقلاع المدرجة في قائمة البرمجيات الثابتة ومدخل محمل الإقلاع المبدئي الحالي. إذا لم يُحدد أي أمر، فهذا هو الخيار المبدئي الضمني.

    انظر المثال أدناه لتفاصيل المخرجات.

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

reboot-to-firmware [BOOL]
    الاستعلام عن أو ضبط علم "Reboot-Into-Firmware-Setup" لبرمجيات EFI الثابتة. يأخذ وسيطاً منطقياً يتحكم في إظهار إعدادات البرمجيات الثابتة عند إعادة تشغيل النظام التالية. إذا أُغفل الوسيط، فإنه يعرض الحالة الحالية للعلم، أو ما إذا كان العلم مدعوماً. يتحكم هذا في نفس العلم الذي يتحكم فيه systemctl reboot --firmware-setup، ولكنه يعمل على مستوى أدنى ويسمح بضبط العلم بشكل مستقل عن طلب إعادة التشغيل الفعلي.

    تلميح: استخدم systemctl reboot --firmware-setup لإعادة التشغيل والدخول إلى إعدادات البرمجيات الثابتة لمرة واحدة. انظر systemctl(1) للتفاصيل.

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

أوامر مواصفات محمل الإقلاع

تتوفر هذه الأوامر لجميع محملات الإقلاع التي تطبق مواصفات محمل الإقلاع UAPI.1[1]، مثل systemd-boot.

list
    يعرض جميع مدخلات محمل الإقلاع المتاحة التي تطبق مواصفات محمل الإقلاع UAPI.1[1]، بالإضافة إلى أي مدخلات أخرى اُكتشفت أو أُنشئت آليًا بواسطة محمل إقلاع يطبق واجهة محمل الإقلاع[2]. يمكن طلب المخرجات بصيغة JSON باستخدام --json=.

    انظر المثال أدناه لتفاصيل المخرجات.

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

unlink [معرف]
    يزيل مدخلة محمل إقلاع بما في ذلك الملفات التي تشير إليها. يأخذ سلسلة محارف اختيارية لمعرف مدخلة محمل الإقلاع أو نمط عام كمعامل. الملفات المشار إليها مثل النواة، صور initrd، إضافات النظام (sysexts)، إضافات التهيئة (confexts) أو ملفات بيانات الاعتماد تُزال فقط إذا لم تشير إليها أي مدخلة أخرى.

    إذا لم يُحدد معامل ID، فيجب تحديد الخيار --oldest، وفي هذه الحالة تُزال مدخلة محمل الإقلاع ذات الإصدار الأقل (لأسباب المتانة، لا تُزال مدخلة القائمة المُقلعة حاليًا أبدًا، ولا آخر مدخلة محمل إقلاع موجودة).

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

link نواة
    ينشئ مدخلة أو أكثر من النوع #1 لمحمل الإقلاع تشير إلى UKI المحدد. يأخذ المسار إلى صورة نواة موحدة (UKI) كمعامل. تُنسخ UKI إلى ESP (أو قسم XBOOTLDR إن وُجد) أسفل دليل رمز المدخلة المُهيأ، وتُولد مدخلة أو أكثر من النوع #1 وفقًا لـ مواصفات محمل الإقلاع[1] تشير إليها (واحدة لكل تشكيلة UKI، إذا كانت تشكيلات متعددة مضمنة).

    يمكن تجاوز العنوان، الإصدار، رقم الإيداع وعداد المحاولات الأولي للمدخلات المُولدة باستخدام --entry-title= و --entry-version= و --entry-commit= و --tries-left=. يمكن تحديد موارد جانبية إضافية (صور إضافات النظام، صور إضافات التهيئة، ملفات بيانات الاعتماد) لتمريرها إلى UKI عند الإقلاع باستخدام --extra=.

    إذا لم يكن لدى ESP/XBOOTLDR مساحة خالية كافية لمدخلة محمل الإقلاع الجديدة ومواردها المشار إليها، تُزال أقدم مدخلة محمل إقلاع موجودة تطابق رمز المدخلة المحدد (مع أي موارد تشير إليها لم تعد مشار إليها بأي مدخلة أخرى). تُكرر هذه الخطوة حتى تناسب مدخلة محمل الإقلاع الجديدة. لأسباب المتانة، لا تُزال مدخلة محمل الإقلاع المُقلعة حاليًا أبدًا، ولا آخر مدخلة محمل إقلاع موجودة.

    مبدئيًا، ترفض العملية المتابعة إذا كانت المساحة الخالية الناتجة لـ ESP/XBOOTLDR ستنخفض تحت حد الأمان بعد اكتمال الإزالة الآلية للمدخلات الأقدم؛ استخدم --keep-free= للتعديل.

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

cleanup
    يزيل الملفات من أقسام ESP و XBOOTLDR التي تنتمي لرمز المدخل ولكن لا يشار إليها في أي من مدخلات محمل الإقلاع.

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

أوامر واجهة محمل الإقلاع

تتوفر هذه الأوامر لجميع محملات الإقلاع التي تطبق مواصفات محمل الإقلاع UAPI.1[1] و واجهة محمل الإقلاع[2]، مثل systemd-boot.

set-preferred المعرف، set-default المعرف، set-oneshot المعرف، set-sysfail المعرف
    يضبط مدخل محمل الإقلاع المبدئي. يأخذ سلسلة معرف مدخل محمل إقلاع واحد أو نمطاً عاماً كوسييط. يضبط الأمر set-oneshot المدخل المبدئي للإقلاع القادم فقط، بينما يضبطه set-default بشكل دائم لجميع الإقلاعات المستقبلية، أما set-preferred فهو يشبه set-default ولكنه يدرك تقييم الإقلاع وسيتخطى مدخلات الإقلاع التي وصل عداد محاولاتها إلى الصفر. يضبط الأمر set-sysfail مدخل محمل الإقلاع ليُستخدم في حالة فشل النظام. يمكن لمدخلات إقلاع فشل النظام (SysFail) اختيارياً تعديل ترتيب الاختيار الآلي في حالة الفشل، مثل فشل تحديث برمجيات الإقلاع الثابتة مع تسجيل حالة الفشل في جدول نظام EFI.

    يمكن استخدام bootctl list لسرد مدخلات محمل الإقلاع المتاحة ومعرفاتها.

    بالإضافة إلى ذلك، يمكن تحديد معرف مدخل محمل الإقلاع كواحد من: @default أو @oneshot أو @current، والتي تقابل مدخل محمل الإقلاع المبدئي الحالي لجميع الإقلاعات المستقبلية، ومدخل محمل الإقلاع المبدئي الحالي للإقلاع القادم، ومدخل محمل الإقلاع الذي أُقلع منه حالياً. تُحل هذه المعرفات الخاصة إلى القيم الحالية لمتغيرات EFI وهي LoaderEntryDefault و LoaderEntrySysFail و LoaderEntryOneShot و LoaderEntrySelected، انظر مواصفات محمل الإقلاع UAPI.1[1] للتفاصيل. هذه المعرفات الخاصة مفيدة بشكل أساسي كطريقة سريعة لجعل مدخل محمل الإقلاع الحالي هو الخيار المبدئي بشكل دائم، أو لترقية مدخل الإقلاع المبدئي للإقلاع القادم ليكون المبدئي الدائم، ولكن يمكن استخدامها لعمليات أخرى أيضًا.

    إذا ضُبط على @saved، فسيُحفظ المدخل المختار كمتغير EFI عند كل إقلاع وسيُختار آليًا في المرة القادمة التي يبدأ فيها محمل الإقلاع.

    عند تحديد سلسلة فارغة ("") كمعرف، سيُلغى تعيين متغير EFI المقابل.

    تلميح: استخدم systemctl reboot --boot-loader-entry=ID لإعادة التشغيل في مدخل إقلاع معين و systemctl reboot --boot-loader-menu=timeout لإعادة التشغيل في قائمة محمل الإقلاع لمرة واحدة. انظر systemctl(1) للتفاصيل.

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

set-timeout المهلة، set-timeout-oneshot المهلة
    يضبط مهلة قائمة محمل الإقلاع بالثواني. يضبط الأمر set-timeout-oneshot المهلة للإقلاع القادم فقط. انظر systemd.time(7) لتفاصيل حول تنسيق الفترات الزمنية.

    إذا ضُبط هذا على menu-disabled أو menu-hidden أو 0، فلن تظهر أي قائمة وسيأُقلع من المدخل المبدئي فوراً، بينما يؤدي الضبط على menu-force إلى تعطيل المهلة مع إظهار القائمة دائماً. عند تحديد سلسلة فارغة ("")، سيعود محمل الإقلاع إلى مهلة القائمة المبدئية.

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

أوامر SYSTEMD-BOOT

تدير هذه الأوامر محمل إقلاع EFI المسمى systemd-boot، ولا تعمل بالتزامن مع محملات الإقلاع الأخرى.

install
    يثبت systemd-boot في قسم نظام EFI (ESP). ستُخزن نسخة من systemd-boot كمحمل مبدئي/احتياطي لـ EFI في المسار ESP/EFI/BOOT/BOOT*.EFI. ثم يُضاف محمل الإقلاع إلى أعلى قائمة محملات الإقلاع في البرمجيات الثابتة.

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

update
    يحدث جميع الإصدارات المثبتة من systemd-boot(7)، إذا كان الإصدار المتاح أحدث من الإصدار المثبت في قسم نظام EFI. يشمل هذا أيضًا المحمل المبدئي/الاحتياطي في المسار ESP/EFI/BOOT/BOOT*.EFI. ثم يُضاف محمل الإقلاع إلى نهاية قائمة محملات الإقلاع في البرمجيات الثابتة إذا كان مفقوداً.

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

remove
    يزيل جميع الإصدارات المثبتة من systemd-boot من قسم نظام EFI ومن قائمة محملات الإقلاع في البرمجيات الثابتة.

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

is-installed
    يتحقق مما إذا كان systemd-boot مثبتاً في ESP. لاحظ أن ESP واحد قد يستضيف عدة محملات إقلاع؛ لذا فإن هذا يتحقق مما إذا كان systemd-boot واحداً منها، ولا يتحقق مما إذا كان هو المبدئي أو مسجلاً في أي من متغيرات EFI.

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

random-seed
    يولد بذرة عشوائية ويخزنها في قسم نظام EFI (ESP)، لاستخدامها بواسطة محمل الإقلاع systemd-boot. إذا كانت البذرة العشوائية موجودة بالفعل في ESP فستُحدث. كما يولد "رمز نظام" عشوائياً ويخزنه بشكل دائم كمتغير EFI، إذا لم يُعين من قبل. إذا وجد محمل الإقلاع البذرة العشوائية في ESP ورمز النظام في متغير EFI، فسيشتق بذرة عشوائية لتمريرها إلى نظام التشغيل وبذرة جديدة لتخزينها في ESP من مزيج كليهما. البذرة العشوائية الممررة لنظام التشغيل تضاف إلى مجمع الإنتروبيا (entropy pool) للنواة بواسطة مدير النظام أثناء الإقلاع المبكر، مما يسمح لمساحة المستخدم بالإقلاع مع مجمع إنتروبيا مهيأ بالكامل في وقت مبكر جداً. انظر أيضًا systemd-boot-random-seed.service(8).

    انظر البذور العشوائية[3] لمزيد من المعلومات.

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

أوامر صورة النواة

kernel-identify صورة-النواة
    يأخذ صورة نواة كوسييط. يتحقق من نوع صورة النواة. يعيد واحداً من "uki" أو "addon" أو "pe" أو "unknown".

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

kernel-inspect صورة-النواة
    يأخذ صورة نواة كوسييط. يطبع تفاصيل حول الصورة.

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

الخيارات

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

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

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

--root=جذر
    يأخذ مسار دليل كمعامل. ستُسبق جميع المسارات بمسار root البديل المعطى، بما في ذلك مسارات البحث عن الضبط.

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

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

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

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

--install-source=
    عند تثبيت الملفات الثنائية باستخدام --root= أو --image=، يحدد مصدر جلبها. يأخذ واحداً من "auto" (المبدئي) أو "image" أو "host". مع "auto"، ستُجلب الملفات من الدليل أو الصورة المحددة، وإذا لم توجد ستُجلب من المضيف. مع "image" أو "host" لن يُجرى بحث احتياطي إذا لم توجد الملفات في المصدر المختار.

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

-p, --print-esp-path
    يعدل هذا الخيار سلوك status. يطبع فقط المسار إلى قسم نظام EFI (ESP) في المخرج القياسي ويخرج.

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

-x, --print-boot-path
    يعدل هذا الخيار سلوك status. يطبع فقط المسار إلى قسم محمل الإقلاع الموسع إذا كان موجوداً، ومسار ESP خلاف ذلك في المخرج القياسي ويخرج. هذا الأمر مفيد لتحديد مكان وضع مدخلات محمل الإقلاع، حيث يفضل وضعها في قسم محمل الإقلاع الموسع إن وجد وإلا ففي ESP.

    يجب عموماً وضع مدخلات "مواصفات محمل الإقلاع النوع #1" في الدليل "$(bootctl -x)/loader/entries/". يمكن أيضًا استخدام وجود هذا الدليل كإشارة على توفر دعم مدخلات محمل الإقلاع في النظام. وبالمثل، يجب وضع مدخلات النوع #2 في الدليل "$(bootctl -x)/EFI/Linux/".

    لاحظ أن هذا الخيار (على غرار خيار --print-esp-path المذكور أعلاه)، متاح بشكل مستقل عن محمل الإقلاع المستخدم، أي حتى بدون تثبيت systemd-boot.

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

--print-loader-path
    يعدل هذا الخيار سلوك status: حيث يظهر المسار المطلق لملف EFI الثنائي لمحمل الإقلاع المستخدم في الإقلاع الحالي إذا كانت هذه المعلومات متوفرة. لاحظ أنه لا يُجرى أي محاولة للتحقق مما إذا كان الملف الثنائي لا يزال موجوداً.

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

--print-stub-path
    يعدل هذا الخيار سلوك status: حيث يظهر المسار المطلق لملف EFI الثنائي لـ UKI/stub المستخدم في الإقلاع الحالي إذا كانت هذه المعلومات متوفرة. لاحظ أنه لا يُجرى أي محاولة للتحقق مما إذا كان الملف الثنائي لا يزال موجوداً.

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

-R, --print-root-device
    يطبع المسار إلى عقدة الجهاز الكتلوية التي تدعم نظام ملفات الجذر لنظام التشغيل المحلي. يطبع هذا مساراً مثل /dev/nvme0n1p5. إذا كان نظام ملفات الجذر مدعوماً بـ dm-crypt/LUKS أو dm-verity فسيرجع الجهاز الكتلوى الأساسي. إذا كان نظام ملفات الجذر مدعوماً بأجهزة كتلوية متعددة (كما هو مدعوم في btrfs) فستفشل العملية. إذا حُدد الخيار مرتين (أي -RR) وكان الجهاز المكتشف هو قسم، فسيُحدد وطباعة الجهاز الكتلوى "الكامل" الذي ينتمي إليه (مثلاً /dev/nvme0n1). إذا كان نظام ملفات الجذر هو "tmpfs"، فسيرجع الجهاز الكتلوى الذي يدعم /usr/ إن أمكن. إذا كان نظام ملفات الجذر نظام ملفات شبكياً (مثل NFS أو CIFS) فستفشل العملية.

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

--print-efi-architecture
    اطبع سلسلة محارف بنية EFI للبرامج الثابتة المحلية. هذا مفيد لتنسيق أسماء الملفات بشكل عام مثل bootx64.efi التي تتضمن بنية البرامج الثابتة المحلية في الاسم.

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

--variables=yes|no|auto
    يتحكم في ما إذا كان ستُعدل قائمة محمل الإقلاع في البرمجيات الثابتة المخزنة في متغيرات EFI، ومتغيرات EFI الأخرى. إذا لم يُحدد أو ضُبط على auto، فلن تُعدل متغيرات EFI عند اكتشاف التشغيل داخل حاوية. يمكن استخدام yes لتجاوز هذا الفحص صراحة.

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

--random-seed=yes|no
    مبدئياً، يقوم الأمر install بتهيئة ملف بذرة عشوائية في ESP. عند إنشاء صورة، قد يكون من المرغوب فيه تعطيل ذلك لتجنب وجود نفس البذرة في جميع النسخ.

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

--graceful
    تجاهل الفشل عندما لا يمكن العثور على قسم نظام EFI، أو عندما لا يمكن الكتابة في متغيرات EFI، أو عندما يكون هناك محمل إقلاع مختلف أو أحدث مثبت بالفعل. حالياً ينطبق فقط على الأوامر is-installed و update و random-seed و install. منذ الإصدار v258، يُفعل ضمنياً عند التشغيل داخل chroot.

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

-q، --quiet
    كتم طباعة نتائج الأوامر المختلفة وأيضًا التلميحات حول عدم توفر ESP.

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

--make-entry-directory=yes|no
    يتحكم في إنشاء وحذف دليل مدخلات النوع #1 لـ مواصفات محمل الإقلاع UAPI.1[1] على نظام الملفات الذي يحتوي على موارد مثل صور النواة و initrd أثناء install و remove على التوالي. يُسمى الدليل تيمناً بـ "رمز المدخل"، كما هو محدد في المعامل --entry-token= الموضح أدناه، ويوضع مباشرة تحت دليل الجذر $BOOT (أي تحت نظام الملفات الذي يعيده خيار --print-boot-path). القيمة المبدئية هي "no".

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

--entry-token=
    يتحكم في كيفية تسمية وتحديد مدخلات محمل الإقلاع لتثبيت نظام التشغيل هذا. يُقبل أثناء install، ويأخذ واحداً من "auto" أو "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 إن وجد، واستخدام القيمة المخزنة فيه. خلاف ذلك، إذا هُيء معرف الجهاز المحلي فسيُستخدم. وإلا، سيُستخدم حقل IMAGE_ID= من os-release إن وجد. وإلا، سيُستخدم حقل ID= من os-release إن وجد.

    ما لم يُعين على "machine-id"، أو عند استخدام --make-entry-directory=yes فإن سلسلة الرمز المختارة تُكتب في ملف /etc/kernel/entry-token، لضمان استخدامها للمدخلات المستقبلية. يقرأ هذا الملف أيضًا بواسطة kernel-install(8) لتحديد الاسم الذي ستُولد مدخلات محمل الإقلاع به للنوى المثبتة حديثاً، أو لتحديد أسماء المدخلات عند إزالة القديمة.

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

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

--all-architectures
    تثبيت الملفات الثنائية لجميع معماريات EFI المدعومة (وهذا يتضمن --variables=no).

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

--efi-boot-option-description=
    وصف المدخل المضاف إلى قائمة خيارات إقلاع البرمجيات الثابتة. المبدئي هو "Linux Boot Manager".

    استخدام الاسم المبدئي "Linux Boot Manager" هو الأفضل عموماً حيث يجب استخدام محمل إقلاع واحد فقط مثبت في قسم ESP واحد لإقلاع أي عدد من تثبيتات أنظمة التشغيل الموجودة على الأقراص المختلفة. تحديداً، لا ينبغي للتوزيعات استخدام هذا العلم لتثبيت مدخل يحمل علامة تجارية في القائمة. ومع ذلك، في الحالات التي توجد فيها عدة أقراص لكل منها قسم ESP الخاص به، قد يكون من المفيد تسهيل التعرف على محمل الإقلاع المستخدم في قائمة البرمجيات الثابتة.

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

--efi-boot-option-description-with-device=
    يأخذ قيمة منطقية، المبدئي هو false. يتحكم في ما إذا كان ستُلحق معلومات طراز القرص بوصف خيار الإقلاع (كما هو مهيأ في --efi-boot-option-description= أعلاه). هذا مفيد عند تثبيت عدة أنظمة تشغيل على أقراص منفصلة في نفس الجهاز، حيث يضمن إمكانية تمييز خيارات الإقلاع ويعطي تلميحاً عن القرص الذي يأُقلع منه. لاحظ أن هذا يستخدم معلومات طراز الأجهزة، وبالتالي قد لا يكون مفيداً جداً في حال استخدام عدة أقراص من نفس الطراز تماماً.

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

--dry-run
    تشغيل تجريبي لأوامر unlink و cleanup.

    في وضع التشغيل التجريبي، تطبع عمليات unlink و cleanup فقط الملفات التي كانت ستُحذف دون حذفها فعلياً.

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

--oldest
    عند استخدامه مع unlink، يختار أقدم مدخلة محمل إقلاع مثبتة تطابق رمز مدخلة الإقلاع للإزالة (بدلاً من تمرير معرف مدخلة صريح). هذا مفيد لتقليم مدخلات محمل الإقلاع الأقدم المثبتة. لاحظ أن المدخلة المُقلعة حاليًا لا تُزال أبدًا، ولا آخر مدخلة متبقية.

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

--keep-free=بايتات
    عند استخدامه مع link، يتحكم في الحد الأدنى من المساحة الخالية (بالبايت) التي يجب أن تبقى على القسم الهدف (ESP أو XBOOTLDR) بعد تجسيد المدخلة الجديدة. تفشل العملية إذا كان تثبيت المدخلة سيخفض المساحة الخالية تحت هذا الحد. يقبل لواحق الحجم المعتادة (K، M، G، ...). إذا كان فارغًا، يُستعاد المبدئي المدمج. إذا ضُبط على صفر، لا تُحتفظ بأي حد أدنى من المساحة الخالية.

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

--entry-title=عنوان
    عند استخدامه مع link، يحدد عنوان مدخلة محمل الإقلاع المُولدة (حقل "title" لمدخلة النوع #1). إذا لم يُحدد، يُشتق العنوان من البيانات الوصفية المضمنة لـ UKI.

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

--entry-version=إصدارة
    عند استخدامه مع link، يحدد سلسلة محارف إصدار مدخلة محمل الإقلاع المُولدة (حقل "version" لمدخلة النوع #1). إذا لم يُحدد، يُشتق الإصدار من البيانات الوصفية المضمنة لـ UKI. يُستخدم بواسطة محمل الإقلاع لفرز واختيار المدخلات.

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

--entry-commit=NR
    عند استخدامه مع link، يحدد رقم الإيداع لمدخلة محمل الإقلاع المُولدة.

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

--extra=مسار, -X مسار
    عند استخدامه مع link، يُسجل ملف مورد جانبي إضافي يجب تمريره إلى UKI عند الإقلاع. قد يكون هذا صورة إضافة نظام (*.sysext.raw)، صورة إضافة تهيئة (*.confext.raw)، أو ملف بيانات اعتماد (*.cred). يُنسخ الملف إلى ESP/XBOOTLDR بجانب UKI وسيقوم محمل الإقلاع بتحميله وتمريره إلى النواة عبر initrd. يمكن استخدام هذا الخيار عدة مرات لتسجيل أكثر من مورد إضافي. إذا مُرر معامل فارغ، تُمسح جميع الإضافات المحددة سابقًا.

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

--tries-left=NR
    عند استخدامه مع link، يُهيئ عداد "المحاولات المتبقية" لعد الإقلاع للمدخلة المُولدة. إذا ضُبط، يُسمى ملف مدخلة الإقلاع الناتج وفقًا لنظام عد الإقلاع الموصوف في وثائق التقييم الآلي للإقلاع[5]، بحيث يخفض محمل الإقلاع العداد عند كل محاولة إقلاع ويُعلم المدخلة في النهاية كسيئة. إذا لم يُحدد، لا يُفعّل عد الإقلاع للمدخلة المُولدة.

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

--secure-boot-auto-enroll=yes|no, --private-key=المسار/المعرف, --private-key-source=النوع[:الاسم], --certificate=المسار, --certificate-source=النوع[:الاسم]
    تهيئة قسم نظام (ESP) للتسجيل الآلي للإقلاع الآمن عند استدعاء الأمر install. يأخذ وسيطاً منطقياً (boolean). معطل مبدئيًا. سيؤدي تفعيل هذا الخيار إلى قيام bootctl بملء قسم ESP بقواعد بيانات توقيع "PK" و "KEK" و "db" الموقعة، بحيث تحتوي كل منها على الشهادة المحددة بتنسيق "DER" كإدخال وحيد لها. ستُلتقط قواعد بيانات توقيع الإقلاع الآمن هذه وتُسجل بواسطة systemd-boot إذا كان الإقلاع الآمن في وضع الإعداد وكان التسجيل التلقائي للإقلاع الآمن مفعلاً.

    عند تحديد هذا الخيار، يجب توفير شهادة ومفتاح خاص أيضًا باستخدام خيارات --certificate= و --private-key=. يأخذ خيار الشهادة مساراً لشهادة X.509 مرمزة بصيغة PEM أو URI يُمرر لمزود OpenSSL المهيأ عبر --certificate-source الذي يأخذ "file" أو "provider" متبوعاً بمعرف المزود. يمكن لخيار المفتاح الخاص أن يأخذ مساراً أو URI سيُمرر لمحرك OpenSSL أو المزود الموصوف بـ --private-key-source= مثل "engine:pkcs11". سيُستخدم محرك أو مزود OpenSSL المحدد لتوقيع قوائم تواقيع EFI.

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

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

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

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

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

ملفات EFI الموقعة

سيبحث bootctl install و update عن ملف systemd-boot ينتهي باللاحقة ".efi.signed" أولاً، وسيقوم بنسخه بدلاً من ملف ".efi" العادي. هذا يسمح للتوزيعات أو المستخدمين النهائيين بتوفير صور موقعة لـ UEFI SecureBoot.

حالة الخروج

عند النجاح، تُرجع 0، ورمز فشل غير صفري خلاف ذلك. يعيد bootctl --print-root-device حالة الخروج 80 في حال لم يكن نظام ملفات الجذر مدعوماً بجهاز كتلوى واحد، وحالات خروج غير صفرية أخرى عند حدوث أخطاء أخرى.

البيئة

إذا عُيين $SYSTEMD_RELAX_ESP_CHECKS=1، فستُخفف فحوصات التحقق لـ ESP، وقد يشير المسار المحدد بـ --esp-path= إلى أي نوع من أنظمة الملفات على أي نوع من الأقسام.

وبالمثل، يؤدي $SYSTEMD_RELAX_XBOOTLDR_CHECKS=1 إلى إيقاف بعض فحوصات التحقق لقسم محمل الإقلاع الموسع.

أمثلة

مثال 1. مخرجات status و list

    $ bootctl status
    System:
         Firmware: UEFI 2.40 (إصدار-البرمجيات-الثابتة)  ← بائع البرمجيات الثابتة وإصدارها
      Secure Boot: disabled (setup)              ← حالة الإقلاع الآمن
     TPM2 Support: yes
     Boot into FW: supported                     ← هل تدعم البرمجيات الثابتة الإقلاع إلى نفسها

    Current Boot Loader:                         ← تفاصيل حول systemd-boot أو محمل إقلاع آخر
          Product: systemd-boot الإصدار            ينفذ واجهة محمل الإقلاع[2]
         Features: ✓ عد الإقلاع
                   ✓ التحكم في مهلة القائمة
                   ✓ التحكم في مهلة القائمة لمرة واحدة
                   ✓ التحكم في المدخل المبدئي
                   ✓ التحكم في المدخل لمرة واحدة
                   ✓ دعم قسم XBOOTLDR
                   ✓ دعم تمرير بذرة عشوائية إلى نظام التشغيل
                   ✓ تحميل مشغلات إضافية
                   ✓ محمل الإقلاع يضبط معلومات ESP
                   ✓ يمكن تعطيل القائمة
              ESP: /dev/disk/by-partuuid/01234567-89ab-cdef-dead-beef00000000
             File: └─/EFI/systemd/systemd-bootx64.efi

    Random Seed:                                 ← البذرة العشوائية المستخدمة للإنتروبيا في الإقلاع المبكر
     Passed to OS: yes
     System Token: set
           Exists: yes

    محملات الإقلاع المتاحة في ESP:
              ESP: /boot/efi (/dev/disk/by-partuuid/01234567-89ab-cdef-dead-beef00000000)
             File: └─/EFI/systemd/systemd-bootx64.efi (systemd-boot 251
             File: └─/EFI/BOOT/BOOTX64.EFI (systemd-boot 251

    محملات الإقلاع المدرجة في متغيرات EFI:
            العنوان: Linux Boot Manager
               المعرف: 0x0001
           الحالة: نشط، ترتيب-الإقلاع
        القسم: /dev/disk/by-partuuid/...
             الملف: └─/EFI/systemd/systemd-bootx64.efi

            العنوان: Fedora
               المعرف: 0x0000
           الحالة: نشط، ترتيب-الإقلاع
        القسم: /dev/disk/by-partuuid/...
             الملف: └─/EFI/fedora/shimx64.efi

            العنوان: Linux-Firmware-Updater
               المعرف: 0x0002
           الحالة: نشط، ترتيب-الإقلاع
        القسم: /dev/disk/by-partuuid/...
             الملف: └─/EFI/fedora/fwupdx64.efi

    مدخلات محمل الإقلاع:
            $BOOT: /boot/efi (/dev/disk/by-partuuid/01234567-89ab-cdef-dead-beef00000000)

    مدخل محمل الإقلاع المبدئي:
             النوع: مواصفات محمل الإقلاع من النوع #1 (.conf)
            العنوان: Fedora Linux 36 (Workstation Edition)
               المعرف: ...
           المصدر: /boot/efi/loader/entries/entry-token-kernel-version.conf
          الإصدار: kernel-version
       معرف الحاسوب: ...
            linux: /entry-token/kernel-version/linux
           initrd: /entry-token/kernel-version/initrd
          الخيارات: root=...

    $ bootctl list
    مدخلات محمل الإقلاع:
             النوع: مواصفات محمل الإقلاع من النوع #1 (.conf)
            العنوان: Fedora Linux 36 (Workstation Edition) (مبدئي) (مختار)
               المعرف: ...
           المصدر: /boot/efi/loader/entries/entry-token-kernel-version.conf
          الإصدار: kernel-version
       معرف الحاسوب: ...
            linux: /entry-token/kernel-version/linux
           initrd: /entry-token/kernel-version/initrd
          الخيارات: root=...

             النوع: مواصفات محمل الإقلاع من النوع #2 (.efi)
            العنوان: Fedora Linux 35 (Workstation Edition)
               المعرف: ...
           المصدر: /boot/efi/EFI/Linux/fedora-kernel-version.efi
          الإصدار: kernel-version
       معرف الحاسوب: ...
            linux: /EFI/Linux/fedora-kernel-version.efi
          الخيارات: root=...

             النوع: آلي
            العنوان: إعادة التشغيل إلى واجهة البرمجيات الثابتة
               المعرف: auto-reboot-to-firmware-setup
           المصدر: /sys/firmware/efi/efivars/LoaderEntries-4a67b082-0a4c-41cf-b6c7-440b29bb8c4f

في القائمة، يحدد "(default)" المدخل الذي سيستخدم مبدئياً، ويحدد "(selected)" المدخل المُختار في المرة الأخيرة (أي الذي يعمل حالياً).

انظر أيضًا

systemd-boot(7)، مواصفات محمل الإقلاع UAPI.1[1]، واجهة محمل الإقلاع[2]، systemd-boot-random-seed.service(8)

ملاحظات

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

2.  واجهة محمل الإقلاع
    https://systemd.io/BOOT_LOADER_INTERFACE

3.  بذور عشوائية
    https://systemd.io/RANDOM_SEEDS

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

5.  تقييم الإقلاع الآلي
    https://systemd.io/AUTOMATIC_BOOT_ASSESSMENT

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

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

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