SYSTEMD-MACHINE-ID-SETUP(1)

الاسم
systemd-machine-id-setup - تهيئة معرف الجهاز في /etc/machine-id

موجز

systemd-machine-id-setup

الوصف

يمكن لأدوات تثبيت النظام استخدام systemd-machine-id-setup لتهيئة معرف الجهاز المخزن في /etc/machine-id وقت التثبيت، باستخدام معرف مقدم أو مولد عشوائياً. انظر machine-id(5) لمزيد من المعلومات حول هذا الملف.

إذا استدعيت الأداة بدون مفتاح --commit، يهيأ /etc/machine-id بمعرف جهاز جديد وصالح إذا كان مفقوداً أو فارغاً. يحصل المعرف الجديد بالطريقة التالية:

    1. إذا خزن معرف جهاز صالح في /run/machine-id، ينسخ معرف الجهاز ويستخدم لتهيئة معرف الجهاز في /etc/machine-id. تتجاوز هذه الخطوة إذا حدد --root= أو شغل في بيئة chroot.

    2. إذا كان معرف جهاز D-Bus صالح مهيأ مسبقاً للنظام، ينسخ معرف جهاز D-Bus ويستخدم لتهيئة معرف الجهاز في /etc/machine-id.

    3. إذا قدم معرف جهاز صالح عبر صلاحية system.machine_id، ينسخ معرف الجهاز ويستخدم لتهيئة معرف الجهاز في /etc/machine-id. تتجاوز هذه الخطوة إذا حدد --root= أو شغل في بيئة chroot.

    4. إذا شغل داخل آلة افتراضية KVM وكون UUID مهيأ (عبر خيار -uuid)، يستخدم هذا UUID لتهيئة معرف الجهاز. يجب على المستدعي ضمان أن UUID الممرر فريد كفاية ومختلف لكل نسخة مشغلة من VM. تتجاوز هذه الخطوة إذا حدد --root= أو شغل في بيئة chroot.

    5. بالمثل، إذا شغل داخل بيئة حاوية Linux وكون UUID مهيأ للحاوية، يستخدم هذا لتهيئة معرف الجهاز. للتفاصيل، انظر توثيق واجهة الحاوية[1]. تتجاوز هذه الخطوة إذا حدد --root= أو شغل في بيئة chroot.

    6. وإلا، يولد معرف جديد عشوائياً.

يمكن استخدام مفتاح --commit لإيداع معرف جهاز عابر على القرص، مما يجعله دائماً. للتفاصيل، انظر أدناه.

استخدم systemd-firstboot(1) لتهيئة معرف الجهاز على صور النظام الموصولة (ولكن غير المشغلة).

الخيارات

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

--root=path
    يأخذ مسار دليل كوسيطة. تسبق جميع المسارات المشغلة بمسار root البديل المعطى، بما في ذلك مسار /etc/machine-id نفسه.

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

--image=مسار
    يأخذ مساراً لعقدة جهاز أو ملف عادي كوسيطة. هذا مشابه لـ --root= كما وصف أعلاه، لكنه يعمل على صورة قرص بدلاً من شجرة أدلة.

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

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

--commit
    يودع معرف جهاز عابر على القرص. يمكن استخدام هذا الأمر لتحويل معرف جهاز عابر إلى معرف دائم. ملف معرف الجهاز العابر هو ملف وصل ربطاً من نظام ملفات ذاكرة (عادة "tmpfs") إلى /etc/machine-id خلال المرحلة المبكرة من عملية الإقلاع. قد يحدث هذا لأن /etc/ للقراءة فقط مبدئياً وكان يفتقر لملف معرف جهاز صالح في تلك النقطة.

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

    يستخدم هذا الأمر بشكل رئيسي بواسطة خدمة الإقلاع المبكر systemd-machine-id-commit.service(8).

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

--print
    يطبع معرف الجهاز المولد أو المودع بعد اكتمال العملية.

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

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

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

حالة الخروج

عند النجاح، يُعاد الرقم 0، وإلا فيُعاد رمز فشل غير صفري.

انظر أيضًا

systemd(1), machine-id(5), systemd-machine-id-commit.service(8), dbus-uuidgen(1), systemd-firstboot(1)

ملاحظات

1.  واجهة الحاويات
    https://systemd.io/CONTAINER_INTERFACE

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

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

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