أفعال سطر الأوامر¶

تُعرف أفعال سطر الأوامر التالية:

init

بدء صنو mkosi. هذه عملية تُنفذ لمرة واحدة تضبط ملفات تكوين مختلفة مطلوبة لتجربة مثالية. حاليًا، لا تُبدأ سوى إضافة tmpfiles.d لدليل خبيئة حزم mkosi للتأكد من تنظيف الملفات القديمة وغير المستخدمة آليًا.

summary

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

cat-config

يُخرج أسماء ومحتويات جميع ملفات الضبط المُحمّلة. يُحمّل mkosi مجموعة من الملفات من مواقع مختلفة وهذا الأمر يسهل معرفة ما ضُبط وأين ضُبط.

build

بناء الصورة بناءً على الإعدادات الممرة في سطر الأوامر وفي ملفات التكوين. هذا الأمر هو المبدئي إذا لم يُحدد فعل. يمكن تمرير معطيات إلى سكريبتات البناء، إذا كانت معرفة. لتمرير خيارات إلى سكريبتات البناء، افصلها عن خيارات mkosi العادية باستخدام --.

shell

هذا يبني الصورة إذا لم تُبنَ بعد، ثم يستدعي systemd-nspawn لتشغيل صدفة تفاعلية في الصورة. لا يتطلب هذا إقلاع النظام، فهو يشبه chroot محسنًا. يمكن تحديد سطر أوامر اختياري بعد الفعل shell، ليُستدعى بدلًا من الصدفة في الحاوية. لتمرير خيارات إضافية إلى nspawn، افصلها عن الخيارات العادية باستخدام --.

boot

مشابه للفعل shell، ولكن بدلًا من إطلاق صدفة، فإنه يقلع systemd في الصورة باستخدام systemd-nspawn. يمكن تحديد معطيات إضافية بعد الفعل boot، والتي تُممر كـ سطر أوامر النواة إلى نظام البدء في الصورة. لتمرير خيارات إضافية إلى nspawn، افصلها عن الخيارات العادية باستخدام --.

vm

مشابه للفعل boot، ولكنه يستخدم مراقب الآلة الافتراضية المضبوط (المبدئي هو qemu) لإقلاع الصورة، أي بدلًا من افتراضية الحاويات، تُستخدم افتراضية الآلات الافتراضية. تعتمد كيفية تفسير معطيات سطر الأوامر الإضافية على مراقب الآلة الافتراضية المضبوط. انظر VirtualMachineMonitor= لمزيد من المعلومات. لتمرير خيارات إضافية إلى مراقب الآلة الافتراضية المضبوط، افصلها عن الخيارات العادية باستخدام --.

ssh

عند بناء الصورة مع خيار Ssh=always أو إذا كانت خدمة sshd-vsock الخاصة بـ systemd تعمل في الآلة الافتراضية (systemd الإصدار 256 فأحدث)، يتصل هذا الأمر بآلة افتراضية مقلعة عبر SSH. تأكد من تشغيل mkosi ssh بنفس التكوين المستخدم في mkosi build بحيث تتوفر لديه المعلومات اللازمة للاتصال بالآلة الافتراضية التي تعمل عبر SSH. تحديدًا، يُستخدم مفتاح SSH الخاص من إعداد SshKey= للاتصال بالآلة الافتراضية. استخدم mkosi genkey لتوليد مفتاح وشهادة آليًا ليلتقطهما mkosi. أي معطيات ممرة بعد الفعل ssh تُممر كمعطيات لاستدعاء ssh. لتمرير خيارات إضافية، افصلها عن الخيارات العادية باستخدام --. للاتصال بحاوية، استخدم machinectl login أو machinectl shell.

journalctl

يستخدم journalctl لمعاينة السجل (journal) داخل الصورة. تُلحق جميع المعطيات المحددة بعد الفعل journalctl والمفصولة بـ -- عن الخيارات العادية باستدعاء journalctl.

coredumpctl

يستخدم coredumpctl للبحث عن ملفات إفراغ الذاكرة (coredumps) داخل الصورة. تُلحق جميع المعطيات المحددة بعد الفعل coredumpctl والمفصولة بـ -- عن الخيارات العادية باستدعاء coredumpctl.

sysupdate

يستدعي systemd-sysupdate مع ضبط الخيار --transfer-source= على دليل المخرجات والخيار --definitions= على الدليل المضبوط بـ SysupdateDirectory=. تُمرر جميع المعطيات المحددة بعد الفعل sysupdate والمفصولة عن الخيارات العادية بـ -- مباشرة إلى systemd-sysupdate.

box

تشغيل أوامر اعتباطية داخل نفس البيئة المستخدمة لتنفيذ أفعال أخرى مثل boot و shell و vm وغيرها. هذا يعني أن /usr سيُستبدل بـ /usr من شجرة الأدوات إذا كانت مستخدمة بينما يظل كل شيء آخر في مكانه. إذا لم يُوفر أمر، سيُنفذ $SHELL أو bash إذا لم يكن $SHELL مضبوطًا. لتمرير خيارات إضافية للأمر المعطى، افصلها عن الخيارات العادية بـ --.

clean

إزالة نواتج البناء المولدة في بناء سابق. إذا دُمج مع -f، فإنه يزيل أيضًا صور خبيئة البناء المتزايد وشجرة الأدوات. إذا حُدد -f مرتين، فإنه يزيل أيضًا أي خبيئة حزم.

serve

هذا يبني الصورة إذا لم تُبنَ بعد، ثم يقدم دليل المخرجات (أي عادةً mkosi.output/، انظر أدناه) عبر خادم HTTP صغير مدمج، ينصت على المنفذ 8081. ادمجه مع -f لإعادة بناء الصورة دون شروط قبل تقديمها. هذا الأمر مفيد لاختبار الحصول على صور أنظمة التشغيل عبر الشبكة، على سبيل المثال عبر machinectl pull-raw ... و machinectl pull-tar ....

burn <الجهاز>

يبني هذا الصورة إذا لم تُبنَ بعد، ثم يكتبها في الجهاز الكتلي المحدد. تُكتب محتويات القسم كما هي، ولكن يتم تصحيح جدول أقسام GPT ليطابق حجم القطاع والقرص للوسيط المحدد.

bump

يرفع إصدار الصورة من mkosi.version ويكتب سلسلة الإصدار الناتجة في mkosi.version. هذا مفيد لتنفيذ مخطط ترقيم إصدارات بسيط: في كل مرة يُستدعى فيها هذا الفعل، يُرفع الإصدار استعدادًا للبناء اللاحق. لاحظ أنه يمكن استخدام --auto-bump/-B لرفع الإصدار آليًا كجزء من عملية البناء. لا يُكتب الإصدار الجديد في mkosi.version إلا إذا نجح البناء في تلك الحالة.

genkey

توليد زوج من مفاتيح الإقلاع الآمن (SecureBoot) للاستخدام مع خيارات SecureBootKey=/--secure-boot-key= و SecureBootCertificate=/--secure-boot-certificate=.

documentation

عرض توثيق mkosi. إذا لم يُعطَ معطى، تُعرض صفحة دليل (man) mkosi، ولكن المعطيات mkosi و mkosi-initrd و initrd و mkosi-sandbox و sandbox و mkosi.news و news مدعومة وتعرض على التوالي صفحات الدليل لـ mkosi و mkosi-initrd و mkosi-sandbox وملف NEWS الخاص بـ mkosi.

completion

توليد إكمال الصدفة للصدفة المعطاة كمعطى وطباعتها على المخرج القياسي. المعطيات bash و fish و zsh مفهومة.

dependencies

يُخرج قائمة الحزم المطلوبة من قبل mkosi لبناء وإقلاع الصور.

latest-snapshot

يُخرج أحدث لقطة متاحة في المرآة المضبوطة.

help

هذا الفعل يكافئ مفتاح التبديل --help الموثق أدناه: فهو يعرض شرحًا موجزًا للاستخدام.

خيارات سطر الأوامر فقط¶

لا يمكن ضبط هذه الإعدادات في ملفات الضبط.

--force, -f

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

--directory=, -C

يأخذ مسارًا لمجلد. ينتقل mkosi إلى هذا المجلد قبل القيام بأي شيء. لاحظ أنه يتم البحث عن ملفات الضبط المتنوعة في هذا المجلد، لذا فإن استخدام هذا الخيار طريقة فعالة لبناء مشروع يقع في مجلد معين. القيمة المبدئية هي مجلد العمل الحالي. إذا حُددت سلسلة فارغة، سيتم تجاهل كل الضبط في مجلد العمل الحالي.

--debug

فعل خرج تنقيب إضافي.

--debug-shell

عند فشل تنفيذ أمر في الصورة، سيبدأ mkosi صدفة تفاعلية في الصورة للسماح بمزيد من التنقيح.

--debug-workspace

عند تحديده، لن يُحذف مجلد مساحة العمل وسيتم تسجيل موقعه عند خروج mkosi.

--debug-sandbox

شغّل mkosi-sandbox باستخدام strace.

--version

أظهر إصدار الحزمة.

--help, -h

أظهر معلومات استخدام موجزة.

--genkey-common-name=

الاسم العام (Common name) الذي سيُستخدم عند توليد المفاتيح عبر أمر genkey الخاص بـ mkosi. القيمة المبدئية هي mkosi of %u، حيث تُوسع %u إلى اسم المستخدم الذي يستدعي mkosi.

--genkey-valid-days=

عدد الأيام التي يجب أن تظل فيها المفاتيح صالحة عند توليدها عبر أمر genkey الخاص بـ mkosi. المبدئي هو عامان (730 يومًا).

--auto-bump=, -B

إذا حُدد، سيُرفع الإصدار وإذا نجح البناء، سيُكتب الإصدار في mkosi.version بطريقة مكافئة للفعل bump. هذا مفيد لإدارة الإصدارات البسيطة والخطية: كل بناء في سلسلة سيكون له رقم إصدار أعلى بواحد من الإصدار السابق.

--doc-format

التنسيق الذي سيُعرض به التوثيق. يدعم القيم markdown و man و pandoc و system و auto. في حالة markdown يُعرض التوثيق بتنسيق Markdown الأصلي. تعرض man التوثيق بتنسيق صفحة الدليل، إذا كان متاحًا. ستقوم pandoc بتوليد تنسيق صفحة الدليل فورًا، إذا كانت pandoc متاحة. ستعرض system صفحة الدليل على مستوى النظام لـ mkosi، والتي قد تتوافق أو لا تتوافق مع الإصدار الذي تستخدمه، اعتمادًا على كيفية تثبيتك لـ mkosi. القيمة المبدئية auto ستحاول جميع الطرق بالترتيب man ثم pandoc ثم markdown ثم system.

--json

أظهر خرج الملخص كـ JSON-SEQ.

--wipe-build-dir, -w

امسح مجلد البناء إذا ضُبط واحد قبل بناء الصورة.

--rerun-build-scripts, -R

إعادة تشغيل سكريبتات البناء. يتطلب تمكين الخيار Incremental= وأن تكون الصورة قد بُنيت بالفعل مرة واحدة. إذا كان History= مُمكّنًا، فسيُعاد استخدام السجل من البناء السابق ولن يُكتب سجل جديد.

تنسيقات المخرجات المدعومة¶

تنسيقات المخرجات التالية مدعومة:

•

صورة قرص GPT خام، أنشئت باستخدام systemd-repart (disk)

•

مجلد عادي، يحتوي على شجرة نظام التشغيل (directory)

•

أرشيف Tar (tar)

•

أرشيف CPIO (cpio)

•

صورة نواة موحدة (UKI)

•

... وأكثر من ذلك بكثير. انظر توثيق Format= أدناه.

يمكن أيضًا ضبط تنسيق المخرجات على none لكي لا ينتج mkosi أي صورة على الإطلاق. يمكن أن يكون هذا مفيدًا إذا كنت تريد فقط استخدام الصورة لإنتاج مخرج آخر في سكريبتات البناء (مثل بناء حزمة RPM).

عند إنشاء صورة قرص GPT، يمكن وضع ملفات تعريف أقسام repart في mkosi.repart/ لضبط صورة القرص المولدة.

يوصى بشدة بتشغيل mkosi على نظام ملفات يدعم reflinks مثل XFS و btrfs وإبقاء جميع المجلدات ذات الصلة على نفس نظام الملفات. يسمح هذا لـ mkosi بإنشاء الصور بسرعة كبيرة عن طريق استخدام reflinks لإجراء النسخ عبر عمليات النسخ عند الكتابة (copy-on-write).

إعدادات الضبط¶

يمكن ضبط الإعدادات التالية عبر ملفات التكوين (الصيغة بـ SomeSetting=value) وعلى سطر الأوامر (الصيغة بـ --some-setting=value). بالنسبة لبعض معلمات سطر الأوامر، يُسمح أيضًا باختصار من حرف واحد. في ملفات التكوين، يجب أن يكون الإعداد في القسم المناسب، لذا جُمعت الإعدادات حسب الأقسام أدناه.

يُحلل الضبط بالترتيب التالي:

• تُحلل معطيات سطر الأوامر.
• يُحلل mkosi.local.conf و mkosi.local/ إذا كانا موجودين (بهذا الترتيب). يجب أن يكون هذا الملف وهذا الدليل في .gitignore (أو ما يعادله) وهما مخصصان للتكوين المحلي.

•

إذا كان لخيار ما مسار مبدئي مقابل، فسيتم تحليله إذا وجد المسار المبدئي المقابل.

•

يُحلل mkosi.conf إذا كان موجودًا في الدليل المضبوط بـ --directory= أو دليل العمل الحالي إذا لم يُستخدم --directory=. إذا كان الدليل المحدد لا يحتوي على mkosi.conf أو mkosi.tools.conf ولكن يوجد mkosi/mkosi.conf أو mkosi/mkosi.tools.conf، فسيُحلل التكوين من الدليل الفرعي mkosi/ للدليل المحدد بدلًا من ذلك.

•

يُحلل mkosi.conf.d/ في نفس دليل mkosi.conf إذا كان موجودًا. يُحلل كل دليل وكل ملف بالامتداد .conf في mkosi.conf.d/. يُحلل أي دليل في mkosi.conf.d كما لو كان دليلًا عاديًا من المستوى الأعلى، باستثناء mkosi.images/ و mkosi.tools.conf اللذين لا يُلتقطان إلا في دليل المستوى الأعلى.

•

إذا ضُبطت أي تشكيلات، فسيُحلل تكوينها من دليل mkosi.profiles/.

•

تُحلل الصور الفرعية من دليل mkosi.images/ إذا كان موجودًا.

لاحظ أن الإعدادات المضبوطة عبر سطر الأوامر تتجاوز دائمًا الإعدادات المضبوطة عبر ملفات التكوين. إذا ضُبط نفس الإعداد أكثر من مرة عبر ملفات التكوين، فإن التعيينات اللاحقة تتجاوز التعيينات السابقة باستثناء الإعدادات التي تأخذ مجموعة من القيم. أيضًا، الإعدادات المقروءة من mkosi.local.conf أو mkosi.local/ ستتجاوز الإعدادات من ملفات التكوين التي تُحلل لاحقًا، ولكن ليس الإعدادات المحددة على سطر الأوامر.

بالنسبة للإعدادات التي تأخذ قيمة واحدة، يمكن استخدام التعيين الفارغ (SomeSetting= أو --some-setting=) لتجاوز إعداد سابق وإعادة الضبط إلى المبدئي.

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

لتضمين ملفات التكوين بشرط، يمكن استخدام قسم [Match]. يتكون قسم [Match] من شروط فردية. يمكن للشروط استخدام رمز الأنبوب (|) بعد علامة التساوي (...=|...)، مما يجعل الشرط شرطًا محفزًا. سيُضمن ملف التكوين إذا تحقق الـ AND المنطقي لجميع الشروط غير المحفزة والـ OR المنطقي لجميع الشروط المحفزة. لنفي نتيجة شرط، ألحق المعطى بعلامة تعجب. إذا أُلحق معطى برمز الأنبوب وعلامة تعجب، فيجب تمرير رمز الأنبوب أولًا، ثم علامة التعجب ثانيًا.

لاحظ أن شروط [Match] تُقارن بالقيم الحالية لإعدادات محددة، ولا تأخذ في الاعتبار التغييرات التي أُجريت على الإعداد في ملفات التكوين التي لم تُحلل بعد (تُؤخذ الإعدادات المحددة على سطر الأوامر في الاعتبار). لاحظ أيضًا أن المطابقة مع إعداد ثم تغيير قيمته لاحقًا في ملف تكوين مختلف قد يؤدي إلى نتائج غير متوقعة.

ينطبق قسم [Match] لملف mkosi.conf في دليل ما على الدليل بأكمله. إذا لم تتحقق الشروط، سيُتخطى الدليل بأكمله. تنطبق أقسام [Match] للملفات في mkosi.conf.d/ و mkosi.local.conf على الملف نفسه فقط.

إذا كان هناك عدة أقسام [Match] في نفس ملف التكوين، يجب أن يتحقق كل منها ليُضمن ملف التكوين. تحديدًا، تنطبق الشروط المحفزة فقط على قسم [Match] الحالي وتُصفر بين أقسام [Match] المتعددة. كمثال، لن تتحقق المطابقة التالية إلا إذا كان تنسيق المخرجات أحد disk أو directory والبنية أحد x86-64 أو arm64:

[Match]
Format=|disk
Format=|directory
[Match]
Architecture=|x86-64
Architecture=|arm64
    

يمكن استخدام قسم [TriggerMatch] للإشارة إلى مطابقات محفزة. هذه مطابقة للشروط المحفزة في وحدات systemd باستثناء أنها تنطبق على قسم المطابقة بأكمله بدلًا من شرط واحد فقط. كمثال، ستحقق المطابقة التالية إذا كانت التوزيعة debian والإصدارة bookworm أو إذا كانت التوزيعة ubuntu والإصدارة noble.

[TriggerMatch]
Distribution=debian
Release=bookworm
[TriggerMatch]
Distribution=ubuntu
Release=noble
    

دلالات الشروط في أقسام [TriggerMatch] هي نفسها كما في [Match]، أي أن جميع الشروط العادية تُربط بـ AND منطقي وجميع الشروط المحفزة تُربط بـ OR منطقي. عند خلط أقسام [Match] و [TriggerMatch]، تتحقق المطابقة عندما تطابق جميع أقسام [Match] ويطابق قسم واحد على الأقل من أقسام [TriggerMatch]. يُعتبر غياب أقسام المطابقة قيمة صحيحة (true). منطقيًا هذا يعني:

(⋀ᵢ Matchᵢ) ∧ (⋁ᵢ TriggerMatchᵢ)
    

هناك أيضًا دعم لأقسام [Assert] و [TriggerAssert] التي تتصرف بشكل مطابق لأقسام المطابقة باستثناء أن تحليل التكوين سيفشل إذا لم تتحقق أقسام التأكيد (assert)، أي يجب تحقق جميع أقسام [Assert] في ملف بالإضافة إلى قسم [TriggerAssert] واحد على الأقل وإلا سيفشل تحليل التكوين.

تُعرض خيارات سطر الأوامر التي لا تأخذ معطيات بدون = في نسختها الطويلة. في ملفات التكوين، يجب تحديدها بمعطى منطقي (boolean): إما 1 أو yes أو true للتمكين، أو 0 أو no أو false للتعطيل.

قسم [Distribution]¶

Distribution=, --distribution=, -d

التوزيعة المراد تثبيتها في الصورة. تأخذ أحد المعطيات التالية: fedora، debian، kali، ubuntu، arch، opensuse، mageia، centos، rhel، rhel-ubi، openmandriva، rocky، alma، azure أو custom. إذا لم تُحدد، فالمبدئي هو توزيعة المضيف أو custom إذا كانت توزيعة المضيف غير مدعومة.

Release=, --release=, -r

إصدار التوزيعة المراد تثبيتها في الصورة. تعتمد الصيغة الدقيقة للمعطى الذي تأخذه على التوزيعة المستخدمة، وهو إما سلسلة رقمية (في حالة فيدورا لينكس، CentOS، إلخ، مثل 29)، أو اسم إصدار التوزيعة (في حالة ديبيان، كالي، أوبونتو، إلخ، مثل artful). المبدئي هو إصدار حديث من التوزيعة المختارة، أو إصدار التوزيعة التي تعمل على المضيف إذا كانت تطابق التوزيعة المضبوطة.

Architecture=, --architecture=

البنية المراد بناء الصورة لها. تعتمد البنيات المدعومة فعليًا على التوزيعة المستخدمة وما إذا كانت الصورة المطلوبة قابلة للإقلاع أم لا. عند البناء لبنية أجنبية، ستحتاج أيضًا إلى تثبيت وتسجيل محاكي وضع المستخدم لتلك البنية.

Mirror=, --mirror=, -m

المرآة المستخدمة لتنزيل حزم التوزيعة. تتوقع رابط URL للمرآة كمعطى. إذا لم تُوفر، تُستخدم المرآة المبدئية للتوزيعة.

Snapshot=

تنزيل الحزم من اللقطة (snapshot) المعطاة بدلًا من تنزيل أحدث حزم التوزيعة من المرآة المعطاة. تأخذ معرف لقطة (تختلف صيغة معرف اللقطة باختلاف التوزيعة)، استخدم الفعل latest-snapshot لمعرفة أحدث لقطة متاحة.

LocalMirror=, --local-mirror=

ستُستخدم المرآة كمرآة محلية ومباشرة وبسيطة بدلًا من استخدامها كبادئة للمجموعة الكاملة من المستودعات المدعومة عادةً من التوزيعات. مفيد لعمليات البناء غير المتصلة بالإنترنت تمامًا مع مستودع واحد. مدعوم في التوزيعات القائمة على deb و rpm و pacman. يتجاوز --mirror= ولكن فقط لبناء mkosi المحلي، ولن يُضبط داخل الصورة النهائية، بل سيُضبط --mirror= (أو المستودع المبدئي) داخل الصورة النهائية بدلًا من ذلك.

RepositoryKeyCheck=, --repository-key-check=

يتحكم في فحوصات التوقيع/المفتاح عند استخدام المستودعات، وهو مُمكّن افتراضيًا. مفيد لتعطيل الفحوصات عند دمجه مع --local-mirror= واستخدام مستودع من نظام ملفات محلي فقط.

RepositoryKeyFetch=, --repository-key-fetch=

يتحكم فيما إذا كان mkosi سيجلب مفاتيح GPG الخاصة بالتوزيعة عن بُعد. مفعل مبدئيًا على Ubuntu عند عدم استخدام شجرة أدوات أو عند استخدام أشجار أدوات Ubuntu لبناء Arch Linux أو التوزيعات المعتمدة على RPM. معطل مبدئيًا في جميع التوزيعات الأخرى. عند تعطيله، يجب تثبيت مفاتيح GPG الخاصة بالتوزيعة المستهدفة محليًا على نظام المضيف إلى جانب مدير الحزم لتلك التوزيعة.

Repositories=, --repositories=

تفعيل مستودعات الحزم المعطلة مبدئيًا. يمكن استخدام هذا لتفعيل مستودعات EPEL لـ CentOS أو مكونات مختلفة من مستودعات Debian/Kali/Ubuntu.

قسم [Output]¶

Format=, --format=, -t

نوع تنسيق الصورة المراد توليدها. أحد الخيارات: directory (لتوليد صورة نظام تشغيل مباشرة في دليل محلي)، tar (مشابه، ولكن تُولد أرشيف tar لصورة نظام التشغيل)، cpio (مشابه، ولكن يُولد أرشيف cpio)، disk (صورة نظام تشغيل لجهاز كتلي مع جدول أقسام GPT)، uki (صورة نواة موحدة مع صورة نظام التشغيل في قسم PE من نوع .initrd)، esp (صورة قرص مع قسم ESP فقط، ومحمل إقلاع وربما UKI)، oci (دليل متوافق مع مواصفات صورة OCI)، أو sysext، أو confext، أو portable، أو addon، أو none (صورة نظام التشغيل مخصصة فقط كصورة بناء لإنتاج ناتج آخر).

ManifestFormat=, --manifest-format=

نوع تنسيق البيان (manifest) أو التنسيقات المراد توليدها. قائمة مفصولة بفاصلة تتكون من json (تنسيق مخرجات JSON القياسي الذي يصف الحزم المثبتة)، و changelog (تنسيق نصي قابل للقراءة البشرية مصمم للمقارنة بالفروقات). افتراضيًا لا يُولد أي بيان.

Output=, --output=, -o

الاسم المراد استخدامه لملف صورة المخرجات المولد أو الدليل. المبدئي هو image أو، إذا حُدد ImageId=، فإنه يُستخدم كاسم مخرجات مبدئي، ملحقًا اختياريًا بالإصدار المضبوط بـ ImageVersion= أو إذا بُنيت صورة محددة من mkosi.images، فيُفضل اسم الصورة على ImageId. لاحظ أن هذا الخيار لا يسمح بضبط دليل المخرجات، استخدم OutputDirectory= لذلك.

OutputExtension=, --output-extension=

استخدم الامتداد المحدد لملف الإخراج. المبدئي هو الامتداد المناسب بناءً على تنسيق الإخراج. يتضمن امتداد الملف فقط، وليس أي امتداد ضغط سيُلحق بهذا الامتداد إذا فُعل الضغط.

CompressOutput=, --compress-output=

اضبط الضغط للصورة الناتجة أو الأرشيف. يمكن أن يكون المعطى إما قيمة منطقية أو خوارزمية ضغط (xz، zstd). يُستخدم ضغط zstd افتراضيًا، باستثناء CentOS ومشتقاته حتى الإصدار 8، التي تستخدم xz افتراضيًا، وصور OCI، التي تستخدم gzip افتراضيًا. لاحظ أنه عند تطبيقه على أنواع صور الأجهزة الكتلية، فإن الضغط يعني أن الصورة لا يمكن بدؤها مباشرة ولكن يجب فك ضغطها أولًا. هذا يعني أيضًا أن الأفعال shell و boot و vm لا تتوفر عند استخدام هذا الخيار. يُعتبر مضمنًا لـ tar و cpio و uki و esp و oci و addon.

CompressLevel=, --compress-level=

اضبط مستوى الضغط المستخدم. يأخذ رقمًا صحيحًا. تعتمد القيم الممكنة على نوع الضغط المستخدم.

OutputDirectory=, --output-directory=, -O

المسار إلى دليل لوضع جميع النواتج المولدة فيه. إذا لم يُحدد هذا وكان الدليل mkosi.output/ موجودًا في الدليل المحلي، فسيُستخدم آليًا لهذا الغرض.

OutputMode=, --output-mode=

وضع الوصول لنظام الملفات المستخدم عند إنشاء ملف صورة المخرجات. يأخذ وضع وصول بالترميز الثماني. إذا لم يُضبط، تُستخدم القيم المبدئية للنظام الحالي.

ImageVersion=, --image-version=

اضبط إصدار الصورة. يقبل هذا أي سلسلة نصية، ولكن يُوصى بتحديد سلسلة من المكونات المفصولة بنقاط. يمكن أيضًا ضبط الإصدار بقراءة ملف mkosi.version (وفي هذه الحالة يمكن إدارته بسهولة عبر الفعل bump أو الخيار --auto-bump) أو بقراءة المخرج القياسي (stdout) إذا كان ملفًا تنفيذيًا (راجع قسم Scripts أدناه). عند تحديده، يُدرج إصدار الصورة في اسم ملف المخرج المبدئي، أي بدلاً من image.raw سيكون المبدئي هو image_0.1.raw للإصدار 0.1 من الصورة، وما شابه ذلك. يُمرر الإصدار أيضًا عبر المتغير $IMAGE_VERSION إلى أي سكريبتات بناء مستدعاة (والذي قد يكون مفيدًا لترقيعه داخل /usr/lib/os-release أو ما شابه، لا سيما حقل IMAGE_VERSION= فيه).

ImageId=, --image-id=

اضبط معرف الصورة. يقبل هذا سلسلة نصية حرة تُستخدم لتعريف الصورة. إذا ضُبط، سيُسمى ملف المخرج المبدئي باسمه (مع احتمال إلحاقه بالإصدار). يُمرر المعرف أيضًا عبر المتغير $IMAGE_ID إلى أي سكريبتات بناء مستدعاة. يُضاف معرف الصورة آليًا إلى /usr/lib/os-release.

SplitArtifacts=, --split-artifacts=

أنواع المصنوعات (artifacts) المراد فصلها عن الصورة النهائية. وهي قائمة مفصولة بفاصلة تتكون من uki، وkernel، وinitrd، وos-release، وprcs، وpartitions، وroothash، وkernel-modules-initrd، وrepart-definitions وtar. عند بناء صورة قابلة للإقلاع، يتوافق kernel وinitrd مع مصنوعاتهما الموجودة في الصورة (أو في UKI)، بينما ينسخ uki صورة UKI بالكامل. إذا حُدد pcrs، يُكتب ملف JSON يحتوي على خلاصات TPM2 المحسوبة مسبقًا، وفقًا لمواصفات UKI في https://uapi-group.org/specifications/specs/unified_kernel_image/#json-format-for-pcrsig ، وهو أمر مفيد للتوقيع دون اتصال بالشبكة.

RepartDirectories=, --repart-directory=

مسارات الأدلة التي تحتوي على ملفات تعريف أقسام systemd-repart التي تُستخدم عندما يستدعي mkosi الأداة systemd-repart عند بناء صورة قرص. إذا كان mkosi.repart/ موجودًا في الدليل المحلي، فسيُستخدم لهذا الغرض أيضًا. لاحظ أن mkosi يستدعي repart مع ضبط --root= على جذر صورة الجذر، لذا فإن أي مسارات مصدر في CopyFiles= داخل ملفات تعريف الأقسام ستكون نسبية لدليل جذر الصورة.

SectorSize=, --sector-size=

تجاوز حجم القطاع المبدئي الذي تستخدمه systemd-repart عند بناء صورة قرص.

Overlay=, --overlay=

عند استخدامه مع BaseTrees=، سيتكون المخرج فقط من التغييرات التي طرأت على الأشجار الأساسية المحددة. تُوصل كل شجرة أساسية كطبقة سفلى في بنية overlayfs، ويصبح المخرج هو الطبقة العليا، وتكون فارغة في البداية. وبالتالي فإن الملفات التي لم تُعدل مقارنة بالأشجار الأساسية لن تكون موجودة في المخرج النهائي.

Seed=, --seed=

يأخذ UUID كمعطى أو القيمة الخاصة random. يتجاوز البذرة (seed) التي يستخدمها systemd-repart عند بناء صورة قرص. هذا مفيد لتحقيق عمليات بناء قابلة لإعادة الإنتاج، حيث ينبغي اشتقاق معرفات UUID حتمية وبيانات أقسام وصفية أخرى في كل عملية بناء. إذا لم يُحدد صراحةً وكان ملف mkosi.seed موجودًا في الدليل المحلي، فسيُقرأ معرف UUID المستخدم منه. خلاف ذلك، يُستخدم UUID عشوائي.

CleanScripts=, --clean-script=

يأخذ قائمة مفصولة بفاصلة من المسارات إلى الملفات القابلة للتنفيذ التي تُستخدم كسكربتات تنظيف لهذه الصورة. انظر قسم SCRIPTS لمزيد من المعلومات.

قسم [Content]¶

Packages=, --package=, -p

ثبّت حزم التوزيعة المحددة (أي RPM و deb و...) في الصورة. يأخذ قائمة مفصولة بفاصلة من مواصفات الحزم. يمكن استخدام هذا الخيار عدة مرات وفي هذه الحالة تُدمج قوائم الحزم المحددة. استخدم BuildPackages= لتحديد الحزم التي يجب تثبيتها فقط في طبقة تراكب تُوصل عند تنفيذ سكريبتات التحضير مع معطى build وعند تنفيذ سكريبتات البناء.

BuildPackages=, --build-package=

مشابه لـ Packages=، ولكنه يضبط الحزم لتُثبت فقط في طبقة تراكب تُتاح فوق الصورة لسكريبتات التحضير عند تنفيذها مع معطى build وسكريبتات البناء. يجب استخدام هذا الخيار لإدراج الحزم التي تحتوي على ملفات الترويسة، والمصرفات، وأنظمة البناء، والروابط وأدوات البناء الأخرى التي تتطلبها سكريبتات mkosi.build للعمل. لاحظ أن الحزم المدرجة هنا ستكون غائبة عن الصورة النهائية.

VolatilePackages=, --volatile-package=

مشابه لـ Packages=، ولكن الحزم المضبوطة بهذا الإعداد لا تُخزن في الخبيئة عند تفعيل Incremental= وتُثبت بعد تنفيذ أي سكريبتات بناء.

PackageDirectories=, --package-directory=

حدد الأدلة التي تحتوي على حزم إضافية لتكون متاحة أثناء البناء. سيقوم mkosi بإنشاء مستودع محلي يحتوي على جميع الحزم الموجودة في هذه الأدلة وجعلها متاحة عند تثبيت الحزم أو تشغيل السكريبتات. إذا وُجد دليل mkosi.packages/ في الدليل المحلي، فسيُستخدم لهذا الغرض أيضًا.

VolatilePackageDirectories=, --volatile-package-directory=

مثل PackageDirectories=، ولكن أي تغييرات تطرأ على الحزم في هذه الأدلة لن تبطل الصور المخزنة في الخبيئة إذا فُعل Incremental=.

WithRecommends=, --with-recommends=

يضبط ما إذا كان سيُثبت التبعات الموصى بها أو الضعيفة، اعتمادًا على تسميتها بواسطة مدير الحزم المستخدم، أم لا. مبدئيًا، لا تُثبت الحزم الموصى بها. يُستخدم هذا فقط لمديري الحزم الذين يدعمون هذا المفهوم، وهم حاليًا apt و dnf و zypper.

WithDocs=, --with-docs=

ضمّن التوثيق في الصورة. مفعّل مبدئيًا. عند تعطيله، وإذا كان مدير حزم التوزيعة الأساسي يدعم ذلك، فلن يُضمن التوثيق في الصورة. يُضبط متغير البيئة $WITH_DOCS الممرر إلى سكريبتات mkosi.build على 0 أو 1 اعتمادًا على ما إذا كان هذا الخيار مفعلًا أو معطلاً.

BaseTrees=, --base-tree=

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

SkeletonTrees=, --skeleton-tree=

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

ExtraTrees=, --extra-tree=

يأخذ قائمة مفصولة بفاصلة من أزواج المسارات المفصولة بنقطتين رأسيتين. يشير المسار الأول من كل زوج إلى دليل ليُنسخ من المضيف إلى الصورة. يشير المسار الثاني من كل زوج إلى الدليل المستهدف داخل الصورة. إذا لم يُوفر المسار الثاني، فسيُنسخ الدليل فوق دليل الجذر للصورة. يُفسر المسار الثاني دائمًا كمسار مطلق. استخدم هذا لتجاوز أي ملفات إعدادات مبدئية مشحونة مع التوزيعة. إذا وُجد دليل mkosi.extra/ في الدليل المحلي، فسيُستخدم أيضًا لهذا الغرض مع دليل الجذر كهدف (راجع أيضًا قسم FILES أدناه).

RemovePackages=, --remove-package=

يأخذ قائمة مفصولة بفاصلة من مواصفات الحزم لإزالتها، بنفس صيغة Packages=. ستُنفذ الإزالة كواحدة من الخطوات الأخيرة. تُتخطى هذه الخطوة إذا استُخدم CleanPackageMetadata=no.

RemoveFiles=, --remove-files=

يأخذ قائمة مفصولة بفاصلة من الأنماط (globs). ستُحذف الملفات في الصورة التي تطابق الأنماط في النهاية.

CleanPackageMetadata=, --clean-package-metadata=

فعل/عطل إزالة قواعد بيانات مدير الحزم والبيانات الوصفية للمستودعات في نهاية التثبيت. يمكن تحديده كـ true أو false أو auto (المبدئي). مع auto، ستُزال قواعد بيانات مدير الحزم والبيانات الوصفية للمستودعات إذا كان الملف التنفيذي لمدير الحزم المعني غير موجود في نهاية التثبيت.

SourceDateEpoch=, --source-date-epoch=

يأخذ طابعًا زمنيًا بالثواني منذ حقبة يونكس (UNIX epoch) كمعطى. ستُثبت أوقات تعديل جميع الملفات على هذه القيمة. يُنشر المتغير أيضًا إلى systemd-repart والسكريبتات التي ينفذها mkosi. إذا لم يُضبط صراحةً، فسيُحاول استخدام SOURCE_DATE_EPOCH من --environment= ثم من بيئة المضيف بهذا الترتيب. هذا مفيد لجعل عمليات البناء قابلة لإعادة الإنتاج. راجع SOURCE_DATE_EPOCH  لمزيد من المعلومات.

SyncScripts=, --sync-script=

يأخذ قائمة مفصولة بفاصلة من المسارات إلى الملفات القابلة للتنفيذ التي تُستخدم كسكربتات مزامنة لهذه الصورة. انظر قسم SCRIPTS لمزيد من المعلومات.

PrepareScripts=, --prepare-script=

يأخذ قائمة مفصولة بفاصلة من المسارات إلى الملفات القابلة للتنفيذ التي تُستخدم كسكربتات تحضير لهذه الصورة. انظر قسم SCRIPTS لمزيد من المعلومات.

BuildScripts=, --build-script=

يأخذ قائمة مفصولة بفواصل من المسارات للملفات التنفيذية التي تُستخدم كبرامج بناء نصية لهذه الصورة. انظر قسم SCRIPTS لمزيد من المعلومات.

PostInstallationScripts=, --postinst-script=

يأخذ قائمة مفصولة بفواصل من المسارات للملفات التنفيذية التي تُستخدم كبرامج ما بعد التثبيت النصية لهذه الصورة. انظر قسم SCRIPTS لمزيد من المعلومات.

FinalizeScripts=, --finalize-script=

يأخذ قائمة مفصولة بفواصل من المسارات للملفات التنفيذية التي تُستخدم كبرامج الإنهاء النصية لهذه الصورة. انظر قسم SCRIPTS لمزيد من المعلومات.

PostOutputScripts=, --postoutput-script=

يأخذ قائمة مفصولة بفواصل من المسارات للملفات التنفيذية التي تُستخدم كبرامج ما بعد الإخراج النصية لهذه الصورة. انظر قسم SCRIPTS لمزيد من المعلومات.

Bootable=, --bootable=

يأخذ قيمة منطقية (boolean) أو auto. يفعل أو يعطل توليد صورة قابلة للإقلاع. إذا فُعل، فسيقوم mkosi بتثبيت محمل إقلاع EFI، وإضافة قسم ESP عند استخدام مخرج صورة القرص. إذا لم يُثبّت محمل إقلاع EFI المحدد (راجع Bootloader=) أو لم يُعثر على صور نواة، فستفشل عملية البناء. يسلك auto سلوك تفعيل الخيار، ولكن لن تفشل عملية البناء إذا لم يُعثر على صور نواة أو لم يُعثر على محمل إقلاع EFI المحدد. إذا عُطل، فلن يُثبت أي محمل إقلاع حتى لو وُجد داخل الصورة، ولن تُولد صور نواة موحدة ولن يُضاف قسم ESP إلى الصورة إذا استُخدمت صيغة مخرج القرص.

Bootloader=, --bootloader=

يأخذ واحدًا من none، أو systemd-boot، أو uki، أو grub، أو systemd-boot-signed، أو uki-signed أو grub-signed. القيمة المبدئية هي systemd-boot. إذا ضُبط على none، فلن يُثبّت أي محمل إقلاع EFI في الصورة. إذا ضُبط على systemd-boot، فسيُثبّت systemd-boot وسيتم توليد UKI لكل نواة مثبتة وتخزينها في EFI/Linux داخل قسم ESP. إذا ضُبط على uki، فسيتم توليد UKI واحدة لأحدث نواة مثبتة (التي تحمل أعلى إصدار) وتُثبت في EFI/BOOT/BOOTX64.EFI داخل قسم ESP. إذا ضُبط على grub، فسيتم توليد UKI لكل نواة مثبتة وتخزينها في EFI/Linux داخل قسم ESP. ولكل UKI مولدة، يُلحق مدخل قائمة بإعدادات grub في grub/grub.cfg داخل قسم ESP والذي يقوم بالتحميل المتسلسل (chainloads) إلى UKI. يُكتب أيضًا ملف grub.cfg وسيط (shim) إلى EFI/<distribution>/grub.cfg داخل قسم ESP والذي يحمل grub/grub.cfg في قسم ESP للتوافق مع الإصدارات الموقعة من grub التي تحمل إعدادات grub من هذا الموقع.

BiosBootloader=, --bios-bootloader=

يأخذ واحدًا من none أو grub. القيمة المبدئية هي none. إذا ضُبط على none، فلن يُثبت أي محمل إقلاع BIOS. إذا ضُبط على grub، فسيُثبت grub كمحمل إقلاع BIOS إذا طُلبت صورة قابلة للإقلاع باستخدام خيار Bootable=. إذا لم تُضبط أي ملفات تعريف أقسام repart، فسيقوم mkosi بإضافة قسم إقلاع grub BIOS وقسم نظام EFI إلى ملفات تعريف الأقسام المبدئية.

ShimBootloader=, --shim-bootloader=

يأخذ واحدًا من none، أو unsigned، أو signed. القيمة المبدئية هي none. إذا ضُبط على none، فلن يُثبت shim و MokManager في قسم ESP. إذا ضُبط على unsigned، فسيقوم mkosi بالبحث عن ثنائيات EFI لـ shim و MokManager غير الموقعة وتثبيتها. إذا فُعل SecureBoot=، فسيقوم mkosi بتوقيع ثنائيات EFI غير الموقعة قبل تثبيتها. إذا ضُبط على signed، فسيقوم mkosi بالبحث عن ثنائيات EFI الموقعة وتثبيتها. حتى لو فُعل SecureBoot=، فلن يعيد mkosi توقيع هذه الثنائيات.

UnifiedKernelImages=, --unified-kernel-images=

يحدد ما إذا كان سيتم استخدام صور نواة موحدة أم لا عندما يكون Bootloader= مضبوطًا على systemd-boot أو grub. يأخذ واحدًا من none، أو unsigned، أو signed أو auto. القيمة المبدئية هي auto. إذا ضُبط على unsigned أو signed، تُستخدم صور النواة الموحدة دائمًا وستفشل عملية البناء إذا كانت أي من المكونات المطلوبة لبناء صور النواة الموحدة مفقودة. إذا ضُبط على auto، فستُستخدم صور النواة الموحدة إذا كانت جميع المكونات الضرورية متاحة. خلاف ذلك، ستُستخدم مداخل النوع 1 (Type 1) كما هو محدد في مواصفات محمل الإقلاع (Boot Loader Specification). إذا عُطل، فستُستخدم مداخل النوع 1 دائمًا. إذا ضُبط Bootloader= على أحد المتغيرات الموقعة، فسيتم البحث عن UKI مبنية مسبقًا وستفشل عملية البناء إذا تعذر العثور عليها، ما لم يتم ضبط UnifiedKernelImages= على unsigned، وفي هذه الحالة سيتم بناء UKI محليًا. هذا مفيد عند دمجه مع خيار وقت التشغيل Firmware= المضبوط على custom بحيث يتم إدراج مفتاح التوقيع المحلي في قاعدة بيانات UEFI (UEFI db).

UnifiedKernelImageFormat=, --unified-kernel-image-format=

يأخذ اسم ملف دون أي مكونات مسار لتحديد الصيغة التي يجب تثبيت صور النواة الموحدة بها. قد يتضمن ذلك كلاً من المحددات العادية (راجع Specifiers) والمحددات المؤجلة الخاصة التي تُوسع أثناء تثبيت الملفات، والموضحة أدناه. الصيغة المبدئية لهذا المعامل هي &e-&k مع إلحاق -&h إذا وُجدت القيمة roothash= أو usrhash= في سطر أوامر النواة، وإلحاق +&c إذا وُجد /etc/kernel/tries في الصورة.

UnifiedKernelImageProfiles=, --uki-profile=

ابنِ تشكيلات (profiles) نواة موحدة (UKI) إضافية. يأخذ قائمة مفصولة بفاصلة من المسارات إلى ملفات إعداد تشكيلات UKI. يمكن استخدام هذا الخيار عدة مرات وفي هذه الحالة تُبنى كل إعدادات في تشكيلة UKI المقابلة. تُلتقط ملفات الإعداد في دليل mkosi.uki-profiles/ آليًا. تُضاف جميع تشكيلات UKI المضبوطة كتشكيلات إضافية لكل UKI يبنيها mkosi.

Initrds=, --initrd=

استخدام ملفات initrd التي يوفرها المستخدم. يأخذ قائمة مفصولة بفواصل من المسارات لملفات initrd. يمكن استخدام هذا الخيار عدة مرات وفي هذه الحالة تُدمج قوائم initrd. إذا لم تُحدد أي ملفات initrd وطُلبت صورة قابلة للإقلاع، سيقوم mkosi آليًا ببناء initrd مبدئي.

InitrdProfiles=, --initrd-profile=

ضبط التشكيلات لتفعيلها في initrd المبدئي. يأخذ قائمة تشكيلات مفصولة بفواصل. تكون كافة التشكيلات معطلة مبدئيًا.

InitrdPackages=, --initrd-package=

حزم إضافية لتثبيتها في initrd المبدئي. يأخذ قائمة مفصولة بفواصل لمواصفات الحزم. يمكن استخدام هذا الخيار عدة مرات وفي هذه الحالة تُدمج قوائم الحزم المحددة.

InitrdVolatilePackages=, --initrd-volatile-package=

مشابه لـ VolatilePackages=، إلا أنه ينطبق على initrd المبدئي.

Devicetrees=, --devicetrees=

قائمة بأنماط شجرة الأجهزة (devicetree) مفصولة بفواصل للاختيار الآلي المبني على الأجهزة. الأنماط هي تعابير مطابقة (glob). يبحث mkosi عن ملفات شجرة الأجهزة في المواقع القياسية بالنسبة لـ /usr/lib/modules/<kver>/dtb/، و /usr/lib/firmware/<kver>/device-tree/، و /usr/lib/linux-image-<kver>/.

Splash=, --splash=

عند ضبطه، سيتم جلب شاشة البداية (boot splash) لأي صورة نواة موحدة يبنيها mkosi من المسار المعطى داخل الصورة.

MicrocodeHost=, --microcode-host=

عند ضبطه إلى true، يضمن فقط الرمز الدقيق (microcode) لوحدة المعالجة المركزية للمضيف في الصورة.

KernelCommandLine=, --kernel-command-line=

استخدام سطر أوامر النواة المحدد عند بناء الصور.

KernelModules=, --kernel-modules=

يأخذ قائمة من أنماط المظاهرة (glob) التي تحدد وحدات النواة التي يجب تضمينها في الصورة. يمكن بادئة كل وسيط بشرطة (-)، لـ استثناء الوحدات المطابقة. تُقيم الوسائط بالترتيب، ويحدد آخر نمط مطابق (إيجابي أو سلبي) النتيجة. تُضمن الوحدات التي طابقت آخر نمط إيجابي في الصورة، بالإضافة إلى تبعات الوحدات والبرمجيات الثابتة الخاصة بها.

KernelModulesInitrd=, --kernel-modules-initrd=

قيمة منطقية، مفعلة (true) مبدئيًا. إذا فُعلت، سيقوم mkosi عند بناء صورة قابلة للإقلاع بتوليد initrd إضافي لكل صورة نواة موحدة يجمعها. يحتوي هذا الـ initrd فقط على الوحدات وربما البرمجيات الثابتة، ثم يُلحق بـ initrd الأساسي لتشكيل ملف initrd النهائي. يحافظ هذا على استقلالية initrd الأساسي عن النواة، ويقوم فقط بتعزيزه بالوحدات اللازمة والخاصة بإصدار النواة عند تجميع صورة النواة الموحدة (UKI).

KernelInitrdModules=, --kernel-modules-initrd-include=

مثل KernelModules=، لكنه يحدد وحدات النواة لتضمينها في initrd.

FirmwareFiles=, --firmware-files=

يأخذ قائمة بأنماط المطابقة التي تحدد ملفات البرمجيات الثابتة (firmware) لتضمينها في الصورة. تُفسر الأنماط بنفس الطريقة المستخدمة في إعدادات KernelModules=، باستثناء أن المسارات تكون نسبية لـ /usr/lib/firmware/<subdir>. تُتجاهل لاحقة الضغط ويجب عدم تضمينها في النمط.

Locale=, --locale=, LocaleMessages=, --locale-messages=, Keymap=, --keymap=, Timezone=, --timezone=, Hostname=, --hostname=, RootShell=, --root-shell=

الإعدادات Locale=، --locale=، LocaleMessages=، --locale-messages=، Keymap=، --keymap=، Timezone=، --timezone=، Hostname=، --hostname=، RootShell=، --root-shell= تقابل خيارات systemd-firstboot التي تحمل نفس الاسم. انظر systemd-firstboot(1) لمزيد من المعلومات. بالإضافة إلى ذلك، حيثما أمكن، تُكتب اعتمادات systemd المقابلة لهذه الإعدادات في /usr/lib/credstore، لكي تنطبق حتى لو شُحن /usr فقط في الصورة.

RootPassword=, --root-password=,

اضبط كلمة سر جذر النظام. إذا لم يُستخدم هذا الخيار، ووُجد ملف mkosi.rootpw في الدليل المحلي، فستُقرأ كلمة السر منه آليًا أو إذا كان الملف قابلاً للتنفيذ فسيُشغل ككراسة ويُقرأ الخرج القياسي بدلاً من ذلك (انظر قسم SCRIPTS أدناه). إذا بدأت كلمة السر بـ hashed:، فستُعامل ككلمة سر جذر معمّاة مسبقًا. تُخزن كلمة سر الجذر أيضًا في /usr/lib/credstore تحت اعتماد systemd المناسب لكي تنطبق حتى لو شُحن /usr فقط في الصورة. لإنشاء حساب غير مقفل بدون أي كلمة سر استخدم hashed: بدون تعمية.

Autologin=, --autologin=, -a

فعل الولوج الآلي للمستخدم root على /dev/pts/0 (nspawn)، و /dev/tty1 و /dev/hvc0.

MakeInitrd=, --make-initrd=

أضف /etc/initrd-release و /init إلى الصورة لكي يمكن استخدامها كـ initramfs.

Ssh=, --ssh=

يحدد ما إذا كان يجب تثبيت وحدة مقبس sshd والخدمة المطابقة لها في الصورة النهائية. يأخذ أحد القيم always أو never أو auto أو runtime. القيمة المبدئية هي auto.

SELinuxRelabel=, --selinux-relabel=

يحدد ما إذا كان يجب إعادة وسم الملفات لتطابق سياسة SELinux الخاصة بالصورة. يأخذ قيمة منطقية أو auto. القيمة المبدئية هي auto. إذا عُطّل، لن تُعاد وسم الملفات. إذا فُعّل، يجب تثبيت سياسة SELinux في الصورة ويجب أن يكون setfiles متاحًا لإعادة وسم الملفات. إذا حدثت أي أخطاء أثناء setfiles، سيفشل البناء. إذا ضُبط إلى auto، ستُعاد وسم الملفات إذا كان mkosi لا يبني صورة دليل، وكانت سياسة SELinux مثبتة في الصورة و setfiles متاحًا. ستُتجاهل أي أخطاء تحدث أثناء setfiles.

MachineId=, --machine-id=

يأخذ UUID أو القيمة الخاصة random. يضبط معرف الآلة (machine ID) للصورة إلى UUID المحدد. إذا ضُبط إلى random، فسيُكتب UUID عشوائي إلى /etc/machine-id. إذا لم يُحدد صراحةً ووُجد الملف mkosi.machine-id في الدليل المحلي، فسيُقرأ UUID المستخدم منه. خلاف ذلك، ستُكتب القيمة uninitialized إلى /etc/machine-id.

قسم [التحقق]¶

SecureBoot=, --secure-boot=

توقيع systemd-boot (إذا لم يكن موقعًا بعد) وأي صور نواة موحدة مولدة لـ UEFI SecureBoot (الإقلاع الآمن).

SecureBootAutoEnroll=, --secure-boot-auto-enroll=

قم بإعداد التسجيل الآلي لمفاتيح الإقلاع الآمن في الآلات الافتراضية كما هو موثق في systemd-boot(7) إذا استُخدم SecureBoot=. لاحظ أن systemd-boot سيقوم بالتسجيل الآلي فقط في الآلات الافتراضية بدءًا من systemd v253. للقيام بالتسجيل الآلي في إصدار systemd v252 أو على الأجهزة الحقيقية، اكتب ملف ضبط systemd-boot إلى /efi/loader/loader.conf باستخدام شجرة إضافية تحتوي على secure-boot-enroll force أو secure-boot-enroll manual. التسجيل الآلي غير مدعوم في إصدارات systemd أقدم من v252. القيمة المبدئية هي yes.

SecureBootKey=, --secure-boot-key=

مسار ملف PEM الذي يحتوي على المفتاح السري لتوقيع صورة نواة UEFI إذا استُخدم SecureBoot= وتوقيعات PCR عند استخدام SignExpectedPcr= أيضًا. عند تحديد SecureBootKeySource=، يعتمد نوع الإدخال على المصدر.

SecureBootCertificate=, --secure-boot-certificate=

مسار ملف X.509 الذي يحتوي على شهادة صورة نواة UEFI الموقعة، إذا استُخدم SecureBoot=.

SecureBootSignTool=, --secure-boot-sign-tool=

الأداة المستخدمة لتوقيع ثنائيات PE للإقلاع الآمن. تأخذ أحد القيم systemd-sbsign أو sbsign أو auto. القيمة المبدئية هي auto. إذا ضُبطت إلى auto، ستُستخدم إما systemd-sbsign أو sbsign إذا توفرتا، مع تفضيل systemd-sbsign.

Verity=, --verity=

ما إذا كان يجب فرض أو تعطيل verity لصور الامتدادات. يأخذ أحد القيم signed أو hash أو defer أو auto أو قيمة منطقية. إذا ضُبط إلى signed، فيجب توفر مفتاح وشهادة verity وسيفشل البناء إذا لم نكتشف أي أقسام verity في صورة القرص الناتجة عن systemd-repart. إذا عُطّل، ستُستبعد أقسام verity من صور الامتدادات. إذا ضُبط إلى hash، سيضبط mkosi أداة systemd-repart لإنشاء قسم بصمة verity، ولكن بدون قسم توقيع. إذا ضُبط إلى defer، فسيُخصص مسار لقسم توقيع verity ولكنه لن يُملأ بعد. إذا ضُبط إلى auto ووُجد مفتاح وشهادة verity، سيمررهما mkosi إلى systemd-repart ويتوقع احتواء الصورة على أقسام verity، لكن البناء لن يفشل إذا لم توجد.

VerityKey=, --verity-key=

مسار ملف PEM الذي يحتوي على المفتاح السري لتوقيع توقيع verity، إذا أُضيف قسم توقيع verity باستخدام systemd-repart. عند تحديد VerityKeySource=، يعتمد نوع الإدخال على المصدر.

VerityCertificate=, --verity-certificate=

المسار إلى ملف X.509 الذي يحتوي على الشهادة لتوقيع توقيع verity، إذا أُضيف قسم توقيع verity باستخدام systemd-repart.

SignExpectedPcr=, --sign-expected-pcr=

قياس مكونات صورة النواة الموحدة (UKI) باستخدام systemd-measure ودمج توقيع PCR داخل صورة النواة الموحدة. يأخذ هذا الخيار قيمة منطقية أو القيمة الخاصة auto، وهي المبدئية، وتساوي القيمة true إذا كانت ثنائية systemd-measure موجودة في PATH. يعتمد على تفعيل SecureBoot= والمفتاح من SecureBootKey=.

SignExpectedPcrKey=, --sign-expected-pcr-key=

مسار ملف PEM الذي يحتوي على المفتاح السري لتوقيع توقيعات PCR المتوقعة. عند تحديد SignExpectedPcrKeySource=، يعتمد نوع الإدخال على المصدر.

SignExpectedPcrCertificate=, --sign-expected-pcr-certificate=

المسار إلى ملف X.509 الذي يحتوي على الشهادة لتوقيع توقيعات PCR المتوقعة.

SecureBootKeySource=, --secure-boot-key-source=, VerityKeySource=, --verity-key-source=, SignExpectedPcrKeySource=, --sign-expected-key-source=

مصدر المفتاح الخاص المقابل، لدعم محركات ومزودي OpenSSL، مثلاً --secure-boot-key-source=engine:pkcs11 أو --secure-boot-key-source=provider:pkcs11.

SecureBootCertificateSource=, --secure-boot-certificate-source=, VerityCertificateSource=, --verity-certificate-source=, SignExpectedPcrCertificateSource=, --sign-expected-certificate-source=

مصدر الشهادة المقابلة، لدعم مزودي OpenSSL، مثلاً --secure-boot-certificate-source=provider:pkcs11. لاحظ أن المحركات غير مدعومة.

Passphrase=, --passphrase=

حدد المسار إلى ملف يحتوي على عبارة المرور لاستخدامها في تعمية LUKS. يجب أن يحتوي على عبارة المرور حرفيًا، وألا ينتهي بحرف سطر جديد (أي بنفس التنسيق الذي يتوقعه cryptsetup و /etc/crypttab). يجب أن يكون للملف وضع وصول 0600 أو أقل.

Checksum=, --checksum=

ولد ملف <output>.SHA256SUMS لكل المصنوعات المولدة بعد اكتمال البناء.

Sign=، --sign=

وقّع ملف SHA256SUMS المولد باستخدام gpg بعد الانتهاء.

OpenPGPTool=، --openpgp-tool=

تطبيق OpenPGP المراد استخدامه للتوقيع. يُعد gpg هو المبدئي. سيؤدي اختيار قيمة تختلف عن القيمة المبدئية إلى استخدام أداة OpenPGP عديمة الحالة (SOP) المعطاة لتوقيع ملف SHA256SUMS.

Key=، --key=

اختر مفتاح gpg لاستخدامه في توقيع SHA256SUMS. يجب أن يكون هذا المفتاح موجودًا بالفعل في حلقة مفاتيح gpg.

قسم [البناء]¶

ToolsTree=، --tools-tree=

إذا حدد، فسيُبحث عن البرامج التي ينفذها mkosi لبناء الصورة وإقلاعها داخل الشجرة المعطاة بدلاً من النظام المضيف. استخدم هذا الخيار لجعل عمليات بناء الصور أكثر قابلية للتكرار عبر استخدام نفس إصدارات البرامج دائمًا لبناء الصورة النهائية بدلاً من أي إصدار مثبت على النظام المضيف. إذا لم يُستخدم هذا الخيار، ولكن وُجد دليل mkosi.tools/ في الدليل المحلي، فسيُستخدم آليًا لهذا الغرض مع اعتبار الدليل الجذر هدفًا.

ToolsTreeDistribution=، --tools-tree-distribution=

اضبط التوزيعة المراد استخدامها لشجرة الأدوات المبدئية. القيمة المبدئية هي توزيعة المضيف باستثناء Ubuntu التي تعود مبدئيًا إلى Debian، و RHEL و CentOS و Alma و Rocky التي تعود مبدئيًا إلى Fedora، أو custom إذا لم تكن توزيعة المضيف مدعومة.

ToolsTreeRelease=، --tools-tree-release=

اضبط إصدارة التوزيعة لاستخدامها في شجرة الأدوات المبدئية. مبدئيًا، تُستخدم الإصدارة المبدئية المضمنة في mkosi للتوزيعة.

ToolsTreeProfiles=، --tools-tree-profile=

اضبط التشكيلات المراد تفعيلها لشجرة الأدوات المبدئية. يأخذ قائمة مفصولة بفواصل تتكون من devel و misc و package-manager و runtime. مبدئيًا، تُفعل كل التشكيلات باستثناء devel.

ToolsTreeMirror=، --tools-tree-mirror=

اضبط المرآة لاستخدامها في شجرة الأدوات المبدئية. مبدئيًا، تُستخدم المرآة المبدئية لتوزيعة شجرة الأدوات.

ToolsTreeRepositories=، --tools-tree-repository=

مثل Repositories= ولكن لشجرة الأدوات المبدئية.

ToolsTreeSandboxTrees=، --tools-tree-sandbox-tree=

مثل SandboxTrees= ولكن لشجرة الأدوات المبدئية.

ToolsTreePackages=، --tools-tree-package=

حزم إضافية لتثبيتها في شجرة الأدوات المبدئية. تأخذ قائمة مفصولة بفاصلة من مواصفات الحزم. يمكن استخدام هذا الخيار عدة مرات وفي هذه الحالة تُدمج قوائم الحزم المحددة.

ToolsTreePackageDirectories=، --tools-tree-package-directory=

مثل PackageDirectories=، ولكن لشجرة الأدوات المبدئية.

ToolsTreeCertificates=، --tools-tree-certificates=

حدد ما إذا كان سيتم استخدام الشهادات والمفاتيح من شجرة الأدوات. مُفعل مبدئيًا. إذا فُعل، فستُستخدم المسارات /etc/pki/ca-trust و /etc/pki/tls و /etc/ssl و /etc/ca-certificates و /var/lib/ca-certificates من شجرة الأدوات. بخلاف ذلك، تُجلب هذه الأدلة من المضيف.

ExtraSearchPaths=، --extra-search-path=

قائمة مسارات مفصولة بنقطتين للبحث عن الأدوات فيها قبل استخدام مسار البحث $PATH العادي.

Incremental=، --incremental=، -i

يأخذ إما strict أو قيمة منطقية كمعامل له. يُفعل وضع البناء التزايدي. في هذا الوضع، تُنشأ نسخة من صورة نظام التشغيل فور تثبيت جميع حزم النظام وتنفيذ سكربتات التحضير ولكن قبل استدعاء سكربتات mkosi.build (أو أي شيء يحدث بعدها). في الاستدعاءات اللاحقة لـ mkosi مع مفتاح -i، قد تُستخدم هذه الصورة المخبأة لتخطي تثبيت حزم النظام، مما يسرع أوقات البناء المتكررة بشكل كبير. لاحظ أنه على الرغم من وجود بعض الآليات البدائية لإبطال الخبيئة، إلا أنها ليست مثالية بالتأكيد. لإجبار إعادة بناء الصورة المخبأة، ادمج -i مع -ff لضمان إزالة الصورة المخبأة أولاً ثم إعادة إنشائها.

CacheOnly=، --cache-only=

يأخذ أحد القيم auto، أو metadata، أو always، أو never. القيمة المبدئية هي auto. إذا ضُبط على always، يُوجّه مدير الحزم بعدم التراسل مع الشبكة. يوفر هذا مستوى أدنى من قابلية التكرار، طالما أن خبيئة الحزم مملوءة بالكامل بالفعل. إذا ضُبط على metadata، يمكن لمدير الحزم تنزيل الحزم، لكننا لن نمامن بيانات المستودع الوصفية. إذا ضُبط على auto، فستُزامن بيانات المستودع الوصفية ما لم يكن لدينا صورة مخبأة (انظر Incremental=) ويمكن تنزيل الحزم أثناء البناء. إذا ضُبط على never، فستُزامن بيانات المستودع الوصفية دائمًا ويمكن تنزيل الحزم أثناء البناء.

SandboxTrees=، --sandbox-tree=

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

WorkspaceDirectory=، --workspace-directory=

مسار إلى دليل لتخزين البيانات المطلوبة مؤقتًا أثناء بناء الصورة. يجب أن يتوفر في هذا الدليل مساحة كافية لتخزين صورة نظام التشغيل الكاملة، رغم أن مساحة القرص المستخدمة فعليًا في معظم الأوضاع تكون أصغر. إذا لم يُحدد، فسيُستخدم دليل فرعي من $XDG_CACHE_HOME (إذا ضُبط)، أو $CACHE_DIRECTORY (إذا ضُبط)، أو $HOME/.cache (إذا ضُبط)، أو /var/tmp.

CacheDirectory=، --cache-directory=

يأخذ مسارًا لدليل لاستخدامه كدليل خبيئة تزايدي للصور التزايدية الناتجة عند تفعيل خيار Incremental=. إذا لم يُستخدم هذا الخيار، ولكن وُجد دليل mkosi.cache/ في الدليل المحلي، فسيُستخدم آليًا لهذا الغرض.

CacheKey=، --cache-key=

يحدد الدليل الفرعي داخل دليل الخبيئة حيث تُخزن الصورة المخبأة. قد يشمل ذلك كلاً من المحددات العادية (انظر Specifiers) والمحددات المؤجلة الخاصة، التي تُوسع بعد انتهاء تحليل الضبط بدلاً من أثنائه، والموصوفة أدناه. التنسيق المبدئي لهذا المعامل هو &d~&r~&a~&I.

PackageCacheDirectory=، --package-cache-dir=

يأخذ مسارًا لدليل لاستخدامه كدليل خبيئة للحزم لمدير حزم التوزيعة المستخدم. إذا لم يُضبط، ولكن وُجد دليل mkosi.pkgcache/ في الدليل المحلي، فسيُستخدم آليًا لهذا الغرض، وإلا فسيُستخدم دليل مناسب في دليل المنزل للمستخدم أو في النظام.

BuildDirectory=، --build-directory=

يأخذ مسارًا لدليل لاستخدامه كدليل بناء لأنظمة البناء التي تدعم البناء خارج الشجرة (مثل Meson). الدليل المستخدم بهذه الطريقة يُشارك بين عمليات البناء المتكررة، ويسمح لنظام البناء بإعادة استخدام النواتج (مثل ملفات الكائنات، والملفات التنفيذية، ...) المولدة في الاستدعاءات السابقة. يمكن لسكربتات البناء العثور على مسار هذا الدليل في متغير البيئة $BUILDDIR. يُوصل هذا الدليل في الدليل الجذر للصورة عند استدعاء mkosi-chroot أثناء تنفيذ سكربتات البناء. إذا لم يُحدد هذا الخيار، ولكن وُجد دليل mkosi.builddir/ في الدليل المحلي، فسيُستخدم آليًا لهذا الغرض (انظر أيضًا قسم FILES أدناه).

BuildKey=، --build-key=

يحدد الدليل الفرعي داخل دليل البناء حيث تُخزن نواتج البناء التزايدية. قد يشمل ذلك كلاً من المحددات العادية (انظر Specifiers) والمحددات المؤجلة الخاصة، التي تُوسع بعد انتهاء تحليل الضبط بدلاً من أثنائه، وهي نفس المحددات المؤجلة التي يدعمها CacheKey=. التنسيق المبدئي لهذا المعامل هو &d~&r~&a.

UseSubvolumes=، --use-subvolumes=

يأخذ قيمة منطقية أو auto. يُفعل أو يُعطل استخدام مجلدات btrfs الفرعية لمخرجات شجرة الأدلة. إذا فُعل، فسيقوم mkosi بإنشاء الدليل الجذر كمجلد فرعي لـ btrfs ويستخدم لقطات مجلدات btrfs الفرعية حيثما أمكن لنسخ الأشجار الأساسية أو المخبأة، وهو ما يعد أسرع بكثير من إجراء نسخ تكراري. إذا فُعل صراحةً وكان btrfs غير مثبت أو تعذر إنشاء مجلدات فرعية، فسيُرفع خطأ. إذا ضُبط على auto، فسيُتجاهل غياب btrfs أو الإخفاق في إنشاء المجلدات الفرعية.

RepartOffline=، --repart-offline=

يحدد ما إذا كان سيتم بناء صور القرص باستخدام أجهزة الحلقة (loopback). مُفعل مبدئيًا. عند التفعيل، لن يستخدم systemd-repart أجهزة الحلقة لبناء صور القرص. عند التعطيل، سيستخدم systemd-repart دائمًا أجهزة الحلقة لبناء صور القرص.

History=، --history=

يأخذ قيمة منطقية. إذا فُعل، فسيقوم mkosi بكتابة الضبط المقدم عبر واجهة سطر الأوامر لآخر عملية بناء في الدليل الفرعي .mkosi-private في الدليل الذي استُدعي منه. تُعاد استخدام هذه المعاملات طالما لم تُعد بناء الصورة لتجنب الاضطرار إلى تحديدها مرارًا وتكرارًا.

BuildSources=، --build-sources=

يأخذ قائمة مفصولة بفواصل من أزواج مسارات مفصولة بنقطتين. يشير المسار الأول من كل زوج إلى دليل لوصله من المضيف. يشير المسار الثاني من كل زوج إلى الدليل الذي يجب وصل دليل المصدر فيه عند تشغيل السكربتات. يسبق كل مسار هدف بالبادئة /work/src وتُفرز جميع مصادر البناء معجميًا حسب هدفها قبل الوصل، بحيث تُوصل مسارات المستوى الأعلى أولاً. إذا لم تُضبط صراحة، يُوصل دليل العمل الحالي إلى /work/src.

BuildSourcesEphemeral=، --build-sources-ephemeral=

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

Environment=، --environment=

يضيف متغيرات إلى البيئة التي يتم تنفيذ مديري الحزم وبرامج الإعداد/البناء/ما بعد التثبيت/الإنهاء النصية بها. يأخذ قائمة مفصولة بمسافات من تعيينات المتغيرات أو مجرد أسماء المتغيرات. في الحالة الأخيرة، ستُمرر قيم تلك المتغيرات من البيئة التي استُدعي فيها mkosi. قد يُحدد هذا الخيار أكثر من مرة، وفي هذه الحالة ستُضبط جميع المتغيرات المدرجة. إذا ضُبط نفس المتغير مرتين، فإن الضبط الأخير يتجاوز السابق.

EnvironmentFiles=، --env-file=

يأخذ قائمة مفصولة بفواصل من مسارات الملفات التي تحتوي على تعريفات متغيرات البيئة لإضافتها إلى بيئة السكربتات. يستخدم mkosi.env إذا وُجد في الدليل المحلي. تُقرأ المتغيرات أولاً من mkosi.env إن وجد، ثم من قائمة الملفات المعطاة ثم من إعدادات Environment=.

WithTests=، --with-tests=، -T

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

WithNetwork=، --with-network=

عندما تكون القيمة صواب، يُفعل الاتصال بالشبكة أثناء استدعاء سكربتات البناء mkosi.build. مبدئيًا، تعمل سكربتات البناء مع إيقاف الشبكة. يُمرر متغير البيئة $WITH_NETWORK إلى سكربتات بناء mkosi.build للإشارة إلى ما إذا كان البناء يتم بوجود شبكة أو بدونها.

ProxyUrl=، --proxy-url=

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

ProxyExclude=، --proxy-exclude=

اضبط أسماء المضيفين التي يجب ألا تمر طلباتها عبر الوكيل. يأخذ قائمة مفصولة بفاصلة من أسماء المضيفين.

ProxyPeerCertificate=، --proxy-peer-certificate=

اضبط ملفًا يحتوي على شهادات تُستخدم للتحقق من الوكيل. القيمة المبدئية هي مخزن الشهادات على مستوى النظام.

ProxyClientCertificate=، --proxy-client-certificate=

اضبط ملفًا يحتوي على الشهادة المستخدمة لاستيثاق العميل مع الوكيل.

ProxyClientKey=، --proxy-client-key=

اضبط ملفًا يحتوي على المفتاح الخاص المستخدم لاستيثاق العميل مع الوكيل. المبدئي هو شهادة عميل الوكيل إن وُفرت.

قسم [Runtime] (المعروف سابقًا بقسم [Host])¶

NSpawnSettings=، --settings=

يحدد ملف إعدادات .nspawn ليستخدمه systemd-nspawn في الفعلين boot و shell، ولوضعه بجانب ملف الصورة المولد. هذا مفيد لضبط بيئة systemd-nspawn عند تشغيل الصورة. إذا لم يُستخدم هذا الإعداد ولكن وُجد ملف mkosi.nspawn في الدليل المحلي، فسيُستخدم آليًا لهذا الغرض.

VirtualMachineMonitor=، --vmm=

يضبط مراقب الآلة الافتراضية المراد استخدامه. يأخذ أحد القيمتين qemu أو vmspawn. القيمة المبدئية هي qemu.

Console=، --console=

يضبط كيفية إعداد الطرفية للآلة الافتراضية. يأخذ أحد القيم interactive، أو read-only، أو native، أو gui. القيمة المبدئية هي interactive. توفر interactive واجهة طرفية تفاعلية للآلة الافتراضية. أما read-only فهي مشابهة لكنها للقراءة فقط تمامًا، أي أنها لا تقبل أي مدخلات من المستخدم. توفر native أيضًا واجهة تعتمد على TTY، لكنها تستخدم التطبيق الأصلي لـ qemu (مما يعني توفر مراقب qemu). وتظهر gui واجهة المستخدم الرسومية لـ qemu.

CPUs=، --cpus=

يضبط عدد نوى المعالج لتخصيصها للضيف عند إقلاع آلة افتراضية. القيمة المبدئية هي 2.

RAM=، --ram=

يضبط مقدار ذاكرة الوصول العشوائي المخصصة للضيف عند إقلاع آلة افتراضية. القيمة المبدئية هي 2G.

MaxMem=، --maxmem=

يضبط أقصى مقدار من الذاكرة يمكن للضيف نشره إجمالاً (ذاكرة الوصول العشوائي + أجهزة الذاكرة القابلة للتوصيل السريع). المبدئي هو مقدار ذاكرة الوصول العشوائي المضبوطة.

KVM=، --kvm=

يضبط ما إذا كان يجب استخدام تسريع KVM عند إقلاع آلة افتراضية. يأخذ قيمة منطقية أو auto. القيمة المبدئية هي auto.

CXL=، --cxl=

يضبط ما إذا كانت أجهزة CXL مفعلة لآلة معينة. صالح فقط إذا كانت البنية تدعم cxl. يأخذ قيمة منطقية. القيمة المبدئية هي false.

VSock=، --vsock=

يضبط ما إذا كان سيتم توفير vsock عند إقلاع آلة افتراضية. يأخذ قيمة منطقية أو auto. القيمة المبدئية هي auto.

VSockCID=، --vsock-cid=

يضبط معرف اتصال vsock لاستخدامه عند إقلاع آلة افتراضية. يأخذ رقمًا في المدى [3, 0xFFFFFFFF) أو hash أو auto. القيمة المبدئية هي auto. عند الضبط على hash، سيُشتق معرف الاتصال من المسار الكامل للصورة. وعند الضبط على auto، سيحاول mkosi العثور على معرف اتصال حر آليًا. وبخلاف ذلك، سيُستخدم الرقم المقدم كما هو.

TPM=، --tpm=

اضبط ما إذا كان سيتم استخدام وحدة نظام أمان افتراضية (TPM) عند إقلاع آلة افتراضية. يأخذ قيمة منطقية أو auto. القيمة المبدئية هي auto.

Removable=، --removable=

يضبط ما إذا كان سيتم إرفاق الصورة كجهاز قابل للفصل عند إقلاع آلة افتراضية. يأخذ قيمة منطقية. القيمة المبدئية هي no.

Firmware=، --firmware=

يضبط البرمجيات الثابتة (firmware) للآلة الافتراضية. يأخذ أحد القيم uefi، أو uefi-secure-boot، أو bios، أو linux، أو linux-noinitrd، أو auto. القيمة المبدئية هي auto. عند الضبط على uefi، تُستخدم برمجية OVMF بدون دعم الإقلاع الآمن. وعند الضبط على uefi-secure-boot، تُستخدم برمجية OVMF مع دعم الإقلاع الآمن. وعند الضبط على bios، تُستخدم برمجية SeaBIOS المبدئية. وعند الضبط على linux، يُستخدم إقلاع النواة المباشر. انظر خيار Linux= لمزيد من التفاصيل حول أي صورة نواة تُستخدم مع إقلاع النواة المباشر. linux-noinitrd مماثل لـ linux باستثناء عدم استخدام initrd. وعند الضبط على auto، يُستخدم uefi-secure-boot إن أمكن، وإلا فـ linux.

FirmwareVariables=، --firmware-variables=

يضبط المسار إلى ملف متغيرات البرمجيات الثابتة للآلة الافتراضية. حاليًا، يُؤخذ هذا الخيار في الاعتبار فقط عند استخدام البرمجيات الثابتة uefi أو uefi-secure-boot. إذا لم يُحدد، سيبحث mkosi عن ملف المتغيرات المبدئي ويستخدمه بدلاً من ذلك.

Linux=، --linux=

اضبط صورة النواة لاستخدامها في إقلاع النواة المباشر لـ qemu. إذا لم تُحدد، فسيستخدم mkosi النواة المقدمة عبر سطر الأوامر (خيار -kernel) أو أحدث نواة ثُبتت في الصورة (أو سيخفق إذا لم تُثبت أي نواة في الصورة).

Drives=، --drive=

أضف قرصًا. يأخذ سلسلة نصية مفصولة بنقطتين بالتنسيق <المعرف>:<الحجم>[:<الدليل>[:<الخيارات>[:<معرف-الملف>[:<الأعلام>]]]]. يحدد id المعرف المخصص للقرص. يمكن استخدام هذا كخاصية drive= في أجهزة qemu المختلفة. يحدد size حجم القرص، ويأخذ الحجم بالبايت. بالإضافة إلى ذلك، يمكن استخدام اللاحقات K و M و G لتحديد الحجم بالكيلوبايت والميجابايت والجيجابايت على التوالي. يحدد directory اختياريًا الدليل الذي سيُنشأ فيه الملف الساند للقرص؛ إذا لم يُضبط، سيُنشأ الملف تحت /var/tmp. تحدد options اختياريًا خصائص إضافية مفصولة بفواصل تُمرر كما هي إلى خيار -blockdev في qemu. يحدد file-id معرف الملف الساند للقرص؛ وإذا لم يُضبط، فإنه يعود مبدئيًا إلى معرف القرص. ستتشارك الأقراص التي لها نفس معرف الملف في الملف الساند نفسه. سيُحدد دليل الملف وحجمه من أول قرص يحمل معرف ملف معين. تأخذ flags قائمة مفصولة بفواصل من أعلام القرص التي تدعم حاليًا persist فقط. يحدد persist ما إذا كان القرص سيستمر عبر استدعاءات qemu. ستُنشأ الملفات الساندة للأقراص وفق النمط /<الدليل>/mkosi-drive-<اسم-الآلة-أو-الصورة>-<معرف-الملف>. يمكنك تخطي القيم بضبطها على سلسلة فارغة، فمثلاً تحديد myfs:1G::::persist سيُنشئ قرصًا مستمرًا تحت /var/tmp/mkosi-drive-main-myfs.

QemuArgs=

قائمة مفصولة بمسافات من المعاملات الإضافية لتمريرها عند استدعاء qemu.

Ephemeral=، --ephemeral=

عند الاستخدام مع الأفعال shell أو boot أو vm، يقوم هذا الخيار بتشغيل الفعل المحدد على لقطة مؤقتة لصورة المخرجات تُزال فور انتهاء الحاوية. أخذ لقطة مؤقتة يكون أكثر كفاءة في أنظمة الملفات التي تدعم الروابط المرجعية (reflinks) بشكل أصيل (btrfs أو xfs) مقارنة بأنظمة الملفات التقليدية التي لا تدعمها (ext4).

Credentials=، --credential=

اضبط الاعتمادات المراد تمريرها إلى systemd-nspawn أو الآلة الافتراضية على التوالي عند استخدام mkosi shell/boot أو mkosi vm. يأخذ هذا الخيار قائمة قيم مفصولة بمسافات يمكن أن تكون إما أزواج مفتاح=قيمة أو مسارات. إذا قُدم مسار وكان ملفًا، فسيكون اسم الاعتماد هو اسم الملف. وإذا كان الملف تنفيذيًا، فستكون قيمة الاعتماد هي مخرجات تنفيذ الملف. وبخلاف ذلك، ستكون قيمة الاعتماد هي محتويات الملف. وإذا كان المسار دليلاً، فسيُطبق نفس المنطق على كل ملف في الدليل.

KernelCommandLineExtra=، --kernel-command-line-extra=

اضبط مدخلات سطر أوامر نواة إضافية تُلحق بسطر أوامر النواة في وقت التشغيل عند إقلاع الصورة. عند الإقلاع في حاوية، تُمرر كمعاملات إضافية إلى systemd. عند الإقلاع في آلة افتراضية، تُلحق بسطر أوامر النواة عبر سلسلة SMBIOS OEM المسماة io.systemd.stub.kernel-cmdline-extra. لن تُلتقط هذه إلا بواسطة إصدارات systemd-boot وsystemd-stub الأحدث من أو المساوية لـ v254.

RuntimeTrees=، --runtime-tree=

يأخذ زوجًا من المسارات مفصولاً بنقطتين. يشير المسار الأول إلى دليل لوصله في أي آلة (حاوية أو آلة افتراضية) يبدؤها mkosi. ويشير المسار الثاني إلى الدليل الهدف داخل الآلة. إذا لم يُوفر المسار الثاني، فسيُوصل الدليل عند /root/src في الآلة. وإذا كان المسار الثاني نسبيًا، فسيُفسر بالنسبة إلى /root/src في الآلة.

RuntimeSize=، --runtime-size=

إذا حُدد، ستُوسع صور الأقراص إلى الحجم المحدد عند إقلاعها باستخدام mkosi boot أو mkosi vm. يأخذ الحجم بالبايت. بالإضافة إلى ذلك، يمكن استخدام اللاحقات K و M و G لتحديد الحجم بالكيلوبايت والميجابايت والجيجابايت على التوالي.

RuntimeNetwork=، --runtime-network=

يأخذ أحد القيم user أو interface أو none. القيمة المبدئية هي user. يحدد الشبكة المراد إعدادها عند إقلاع الصورة. user يقوم بإعداد شبكة وضع المستخدم. interface يقوم بإعداد اتصال شبكة افتراضي بين المضيف والصورة، ويترجم هذا إلى واجهة veth لـ mkosi shell و mkosi boot، وواجهة tap لـ mkosi vm و mkosi vmspawn.

RuntimeBuildSources=، --runtime-build-sources=

صِل مصادر البناء المضبطة عبر BuildSources= ودليل البناء (إذا ضُبط) في نفس المواقع في /work التي وُصلت فيها عند تشغيل سكربت البناء، وذلك عند استخدام mkosi boot أو mkosi vm.

BindUser=، --bind-user=

ربط دليل المنزل للمستخدم الحالي داخل الحاوية أو الآلة الافتراضية. تقبل قيمة منطقية. معطلة مبدئياً.

UnitProperties=، --unit-property=

اضبط خصائص وحدات systemd لإضافتها إلى نطاقات systemd المخصصة عند استخدام mkosi boot أو mkosi vm. تُمرر هذه الخصائص مباشرة إلى خيارات --property= الخاصة بـ systemd-nspawn و systemd-run على التوالي.

SshKey=، --ssh-key=

المسار إلى المفتاح الخاص X.509 بتنسيق PEM لاستخدامه للاتصال بآلة افتراضية بُدئت باستخدام mkosi vm وبُنيت مع تفعيل خيار Ssh= (أو مع تثبيت systemd-ssh-generator) عبر أمر mkosi ssh. إذا لم يُضبط ووجد ملف mkosi.key في دليل العمل، فسيُستخدم آليًا لهذا الغرض. نفذ mkosi genkey لتوليد مفتاح آليًا في mkosi.key.

SshCertificate=، --ssh-certificate=

المسار إلى شهادة X.509 بتنسيق PEM لتوفيرها كمفتاح SSH عام في الآلات الافتراضية التي تُبدأ باستخدام mkosi vm. إذا لم تُضبط ووجد ملف mkosi.crt في دليل العمل، فسيُستخدم آليًا لهذا الغرض. نفذ mkosi genkey لتوليد شهادة آليًا في mkosi.crt.

Machine=، --machine=

حدد اسم الآلة المراد استخدامه عند إقلاع الصورة. يمكن استخدامه أيضًا للإشارة إلى صورة محددة عند الدخول عبر SSH إلى صورة (مثلاً mkosi --image=myimage ssh).

Register=, --register=

تقبل قيمة منطقية (boolean) أو auto (آلي). تحدد ما إذا كان سيُسجل الحاسوب الافتراضي/الحاوية لدى systemd-machined. في حال تفعيلها، ستفشل أداة mkosi إذا لم تستطع تسجيل الحاسوب الافتراضي/الحاوية لدى systemd-machined. وإذا عُطلت، فلن تسجل mkosi الحاسوب الافتراضي/الحاوية. أما إذا كانت القيمة auto، فستسجل mkosi الحاسوب الافتراضي/الحاوية لدى systemd-machined إن كان متاحًا. القيمة المبدئية هي auto.

ForwardJournal=, --forward-journal=

تحدد المسار الذي يجب تحويل سجلات اليومية (journal logs) من الحاويات والحواسيب الافتراضية إليه. إذا كان للمسار الامتداد .journal، فسيُفسر على أنه ملف يجب كتابة السجل فيه. وخلاف ذلك، يُفسر المسار على أنه دليل يجب كتابة السجل فيه.

StorageTargetMode=, --storage-target-mode=

تحدد ما إذا كان يجب على الأمر serve تشغيل systemd-storagetm لتقديم صور الأقراص عبر NVME-TCP. تقبل قيمة منطقية أو auto. في حال التفعيل، يُشغل systemd-storagetm دائمًا وستفشل mkosi إذا لم تتمكن من تشغيله. وفي حال التعطيل، لا يُشغل systemd-storagetm أبدًا. أما في حالة auto، فسيُشغل systemd-storagetm إذا كانت صورة القرص قيد البناء، وكان ملف systemd-storagetm التنفيذي موجودًا، واستُدعي mkosi serve بصلاحيات المستخدم الجذر.

SysupdateDirectory=, --sysupdate-directory=

المسار إلى دليل يحتوي على ملفات تعريف النقل لـ systemd-sysupdate والتي تستخدمها mkosi sysupdate. إذا وُجد mkosi.sysupdate/ في الدليل المحلي، فسيُستخدم لهذا الغرض أيضًا.

قسم [Match]¶

Profiles=

يطابق التشكيلات المضبوطة.

التوزيعة=

يطابق التوزيعة المضبوطة.

الإصدار=

يطابق إصدارة التوزيعة المضبوطة. إذا استُخدم هذا الشرط ولم تُضبط أي توزيعة صراحة بعد، فتُستخدم توزيعة المضيف وإصدارته.

البنية=

تطابق المعمارية المضبوطة. إذا استُخدم هذا الشرط ولم تكن هناك معمارية قد ضُبطت صراحة بعد، فستُستخدم معمارية المضيف. يمكن استخدام Architecture=uefi للمطابقة مع أي معمارية تدعم UEFI.

Repositories=

تطابق المستودعات المفعلة عبر إعداد Repositories=. تقبل اسم مستودع واحد.

PathExists=

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

معرف_الصورة=

يطابق معرف الصورة المضبوط، ويدعم أنماط المطابقة (globs). إذا استُخدم هذا الشرط ولم يُضبط معرف الصورة صراحة بعد، فسيفشل هذا الشرط.

إصدار_الصورة=

تطابق إصدار الصورة المضبوط. يمكن أن تُسبق إصدارات الصور بالمعاملات ==، أو !=، أو >=، أو <=، أو <، أو > لإجراء مقارنات إصدارات غنية وفقًا لمواصفة تنسيق إصدار مجموعة UAPI. إذا لم يُسبق بمعامل، يُفترض معامل المساواة مبدئيًا. إذا استُخدم هذا الشرط ولم يكن قد ضُبط إصدار للصورة صراحة بعد، فسيفشل هذا الشرط.

Bootable=

تطابق القيمة المضبوطة لميزة Bootable=. تقبل قيمة منطقية أو auto.

Format=

تطابق القيمة المضبوطة لخيار Format=. تقبل تنسيق مخرجات (انظر خيار Format=).

SystemdVersion=

تطابق إصدار systemd على المضيف (كما يوردها أمر systemctl --version). يمكن أن تُسبق القيم بالمعاملات ==، أو !=، أو >=، أو <=، أو <، أو > لمقارنات الإصدارات وفقًا لمواصفة تنسيق إصدار مجموعة UAPI. إذا لم يُسبق بمعامل، يُفترض معامل المساواة مبدئيًا.

BuildSources=

تقبل مسار هدف لمصدر بناء (انظر BuildSources=). يتحقق هذا التطابق إذا كان أي من مصادر البناء المضبوطة يستخدم مسار الهدف هذا. على سبيل المثال، إذا كان لدينا ملف mkosi.conf يحتوي على:

HostArchitecture=

تطابق المعمارية الأصلية للمضيف. انظر إعداد Architecture= للاطلاع على قائمة بالقيم الممكنة.

ToolsTreeDistribution=

يطابق توزيعة شجرة الأدوات المضبوطة.

ToolsTreeRelease=

يطابق إصدارة شجرة الأدوات المضبوطة.

Environment=

تطابق زوج مفتاح/قيمة محدد ضُبط باستخدام Environment=. إذا لم تُوفر قيمة، فسيُتحقق مما إذا كان المفتاح المعطى موجودًا في البيئة بغض النظر عن قيمته.

Image=

تطابق اسم الصورة (أو الصورة الفرعية) الحالية. اسم الصورة الفرعية هو اسمها في mkosi.images/ (بدون لاحقة .conf). اسم الصورة في المستوى الأعلى هو main. حالة الاستخدام الرئيسة هي السماح بوجود تكوين مشترك يمكن تضمينه من قِبل كل من الصورة في المستوى الأعلى والصور الفرعية عبر حجب الإعدادات الشاملة خلف مطابقة Image=main.

يوضح هذا الجدول أي أدوات المطابقة تدعم أنماط المطابقة (globs)، والمقارنات الثرية، والقيمة المبدئية التي يُطابق معها إذا لم يُضبط أي قيمة وقت قراءة ملف الضبط:

[Include]¶

Include=, --include=, -I

تضمين إعدادات إضافية من الملف أو الدليل المعطى. تُضمن الإعدادات الإضافية مباشرة بعد تحليل الإعداد، إلا عند استخدامها في سطر الأوامر، ففي تلك الحالة تُضمن الإعدادات الإضافية بعد تحليل جميع وسائط سطر الأوامر.

قسم [Config]¶

Profiles=, --profile=

تحدد التشكيلات المعطاة. التشكيلة هي ملف تكوين أو دليل في دليل mkosi.profiles/. تُضمن ملفات التكوين وأدلة كل تشكيلة بعد تحليل التكوينات التكميلية في mkosi.conf.d/*.conf.

Dependencies=, --dependency=

الصور التي تعتمد عليها هذه الصورة، وتُحدد كقائمة مفصولة بفاصلة. جميع الصور المضبوطة في هذا الخيار ستُبنى قبل هذه الصورة.

MinimumVersion=, --minimum-version=

أدنى إصدارة من mkosi مطلوبة لبناء هذا الضبط. إذا حُددت عدة مرات، تُستخدم أعلى إصدارة محددة.

ConfigureScripts=, --configure-script=

يقبل قائمة مفصولة بفاصلة من المسارات للملفات التنفيذية التي تُستخدم كنصوص ضبط برمجية لهذه الصورة. راجع قسم SCRIPTS لمزيد من المعلومات.

PassEnvironment=, --pass-environment=

تقبل قائمة بأسماء متغيرات البيئة مفصولة بمسافات. عند بناء صور متعددة، تُمرر متغيرات البيئة المدرجة إلى كل صورة فرعية على حدة كما لو كانت إعدادات "شاملة". انظر قسم BUILDING MULTIPLE IMAGES لمزيد من المعلومات.

قسم [UKIProfile]¶

يمكن استخدام قسم UKIProfile في ملفات تكوين تشكيلة UKI التي تُمرر لإعداد UnifiedKernelImageProfiles=. يمكن تحديد الإعدادات التالية في قسم UKIProfile:

Profile=

محتويات قسم .profile في تشكيلة UKI. تقبل قائمة من أزواج مفتاح/قيمة مفصولة بـ =. يجب تحديد المفتاح ID=. انظر مواصفة UKI https://uapi-group.org/specifications/specs/unified_kernel_image/#multi-profile-ukis للاطلاع على قائمة كاملة بالمفاتيح الممكنة.

Cmdline=

خيارات إضافية لسطر أوامر النواة لتشكيلة UKI. تقبل قائمة مفصولة بمسافات من وسائط سطر أوامر النواة الإضافية. لاحظ أن قسم .cmdline النهائي سيكون مزيجًا من قسم .cmdline الأساسي ووسائط سطر أوامر النواة الإضافية المحددة بهذا الإعداد.

SignExpectedPcr=

توقيع قياسات PCR المتوقعة لتشكيلة UKI هذه. يقبل قيمة منطقية. مفعّل مبدئياً.

المحددات¶

يمكن الوصول إلى القيمة الحالية لمختلف الإعدادات عند تحليل ملفات التكوين باستخدام المحددات (specifiers). لكتابة حرف % حرفيًا في ملف تكوين دون معاملته كمحدد، استخدم %%. المحددات التالية مدعومة:

توجد أيضاً محددات مستقلة عن الإعدادات:

أخيراً، هناك محددات مشتقة من أحد الإعدادات:

لاحظ أن دليل العمل الحالي يتغير أثناء قيام mkosi بتحليل تكوينها. تحديدًا، في كل مرة تحلل فيها mkosi دليلاً يحتوي على ملف mkosi.conf، تغير mkosi دليل عملها إلى ذلك الدليل.

لاحظ أن الدليل الذي استُدعيت منه mkosi يتأثر بوسيط سطر الأوامر --directory=.

يوضح الجدول التالي أمثلة لقيم محددات الأدلة المدرجة أعلاه:

التوزيعات المدعومة¶

يمكن إنشاء صور تحتوي على تثبيتات للتوزيعات التالية:

•

فيدورا لينكس

•

دبيان

•

كالي لينكس

•

أوبونتو

•

آرتش لينكس

•

أوبن سوزي

•

ماجيا

•

سنت أو إس

•

RHEL

•

RHEL UBI

•

OpenMandriva

•

Rocky Linux

•

Alma Linux

•

Azure Linux

•

postmarketOS

•

بلا (يتطلب من المستخدم توفير نظام ملفات جذر (rootfs) مبني مسبقًا)

نظريًا، يمكن استخدام أي توزيعة على المضيف لبناء صور تحتوي على أي توزيعة أخرى، طالما أن الأدوات اللازمة متاحة. تحديدًا، أي توزيعة توفر حزمة apt يمكن استخدامها لبناء صور Debian أو Kali أو Ubuntu. وأي توزيعة توفر حزمة dnf يمكن استخدامها لبناء صور لأي من التوزيعات القائمة على RPM. وأي توزيعة توفر حزمة pacman يمكن استخدامها لبناء صور Arch Linux. وأي توزيعة توفر حزمة zypper يمكن استخدامها لبناء صور openSUSE. التوزيعات الأخرى وأدوات أتمتة البناء لأنظمة لينكس المضمنة مثل Buildroot وOpenEmbedded وYocto Project يمكن استخدامها باختيار التوزيعة custom (مخصصة)، وملء نظام الملفات الجذر (rootfs) عبر مزيج من الأشجار الأساسية، والأشجار الهيكلية، وسكربتات التحضير.

حاليًا، تحزم Fedora Linux جميع الأدوات ذات الصلة بدءًا من إصدارة Fedora 28.

لاحظ أنه عند عدم استخدام مرآة مخصصة، لا يمكن بناء صور RHEL إلا من نظام مضيف لديه اشتراك RHEL (يُنشأ باستخدام subscription-manager على سبيل المثال).

طرق مختلفة للإقلاع باستخدام vm¶

أسهل طريقة لإقلاع آلة افتراضية هي بناء صورة بالمكونات المطلوبة وترك mkosi يستدعي qemu بجميع الخيارات الصحيحة:

$ mkosi -d fedora -p systemd-udev,systemd-boot,kernel-core build
$ mkosi -d fedora vm
...
fedora login: root (ولوج آلي)
[root@fedora ~]#
    

يتمثل السلوك المبدئي في الإقلاع باستخدام معراض نصي فقط. في هذا النمط، تستخدم رسائل محمل الإقلاع، والنواة، وsystemd، ولاحقاً محث ولوج getty والصدفة نفس الطرفية. يمكن التبديل بين معراض qemu والمراقب بالضغط على Ctrl-a c. يمكن استخدام مراقب qemu على سبيل المثال لحقن مفاتيح خاصة أو إغلاق الحاسوب بسرعة. وبدلاً من ذلك، يمكن إغلاق الحاسوب باستخدام Ctrl-a x.

للإقلاع بنوافذ رسومية، أضف --console=gui:

$ mkosi -d fedora --console=gui qemu
    

يمكن إقلاع النواة مباشرة باستخدام mkosi vm -kernel ... -initrd ... -append '...'. يعد هذا أسرع قليلاً لعدم استخدام محمل إقلاع، كما يسهل تجربة نوى مختلفة وأسطر أوامر النواة. لاحظ أنه رغم الاسم، فإن خيار -append في qemu يستبدل سطر أوامر النواة المبدئي المضمن في النواة وأي مواصفات -append سابقة.

يُنسخ UKI أيضًا إلى دليل المخرجات ويمكن إقلاعه مباشرة:

$ mkosi vm -- -kernel mkosi.output/fedora~38/image.efi
    

عند الإقلاع باستخدام نواة خارجية، لا نحتاج لوجود النواة داخل الصورة، ولكننا لا نزال نريد تثبيت وحدات النواة.

من الممكن أيضًا إجراء إقلاع نواة مباشر إلى محمل إقلاع، بالاستفادة من حقيقة أن systemd-boot(7) هو ملف UEFI ثنائي صالح:

$ mkosi vm -- -kernel /usr/lib/systemd/boot/efi/systemd-bootx64.efi
    

في هذا السيناريو، تُحمل النواة من ESP في الصورة بواسطة systemd-boot.