HOSTNAMECTL(1)

الاسم
hostnamectl - التحكم في اسم مضيف النظام

موجز

hostnamectl [OPTIONS...] {COMMAND}

الوصف

يمكن استخدام hostnamectl للاستعلام عن اسم مضيف النظام والإعدادات ذات الصلة وتغييرها.

تُميز systemd-hostnamed.service(8) وهذه الأداة بين ثلاثة أسماء مضيفين مختلفة: اسم المضيف "الجميل" (pretty) عالي المستوى والذي قد يتضمن جميع أنواع المحارف الخاصة (مثل "حاسوب لينارت المحمول")، واسم المضيف "الثابت" (static) وهو اسم المضيف الذي ضبطه المستخدم (مثل "lennarts-laptop")، واسم المضيف العابر (transient) وهو قيمة احتياطية وُصلت من تهيئة الشبكة (مثل "node12345678"). إذا ضُبط اسم المضيف الثابت على قيمة صالحة، فلن يُستخدم اسم المضيف العابر.

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

استخدم systemd-firstboot(1) لتهيئة اسم مضيف النظام لصور النظام الموصولة (ولكن لم يُقلع منها).

الأوامر

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

status
    يعرض اسم مضيف النظام والمعلومات ذات الصلة. إذا لم يُحدد أي أمر، فهذا هو الخيار المبدئي الضمني.

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

hostname [NAME]
    إذا لم يُعطَ أي وسيط، فيطبع اسم مضيف النظام. إذا وُفر وسيط اختياري NAME فإن الأمر يغير اسم مضيف النظام إلى NAME. مبدئيًا، سيغير هذا أسماء المضيفين الجميل والثابت والعابر على حد سواء؛ ومع ذلك، إذا استُخدم واحد أو أكثر من --static أو --transient أو --pretty، فستُغير أسماء المضيفين المحددة فقط. إذا ضُبط اسم المضيف الجميل، وضُبط الثابت أو العابر أيضًا، فسيُبسط اسم المضيف المحدد فيما يتعلق بمجموعة المحارف المستخدمة قبل تحديث الأخيرين. يتم ذلك عن طريق إزالة المحارف الخاصة والمسافات. يضمن ذلك أن اسم المضيف الجميل والثابت مرتبطان دائمًا بشكل وثيق مع الاستمرار في اتباع قواعد الصلاحية للاسم المحدد. لا يتم هذا التبسيط لسلسلة اسم المضيف إذا ضُبطت أسماء المضيفين العابرة و/أو الثابتة فقط، وتُرك اسم المضيف الجميل دون تغيير.

    يجب أن يكون كل من اسمي المضيف الثابت والعابر إما لصيقة DNS واحدة (سلسلة مكونة من محارف ASCII صغيرة بـ 7 بتات وبدون مسافات أو نقاط، ومقتصرة على التنسيق المسموح به للصائق أسماء نطاقات DNS)، أو تسلسل من هذه اللصائق مفصولة بنقاط فردية تشكل FQDN DNS صالحًا. يجب ألا يزيد طول اسم المضيف عن 64 محرفًا، وهو قيد من قيود لينكس (يسمح نظام DNS بأسماء أطول).

    إذا ظهرت علامة الاستفهام "?" في اسم المضيف، فسيُستبدل آليًا برمز ست عشري مشتق من machine-id(5) عند التطبيق، بشكل آمن وحتمي عبر التجزئة التعموية. مثال: ستُوسع "foobar-????-????" آليًا إلى "foobar-92a9-061c" أو ما شابه، اعتمادًا على معرف الجهاز المحلي.

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

icon-name [NAME]
    إذا لم يُعطَ أي وسيط، فيطبع اسم أيقونة النظام. إذا وُفر وسيط اختياري NAME فإن الأمر يغير اسم الأيقونة إلى NAME. تستخدم بعض التطبيقات الرسومية اسم الأيقونة لتصور هذا المضيف. يجب أن يتبع اسم الأيقونة مواصفة تسمية الأيقونات[1].

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

chassis [TYPE]
    إذا لم يُعطَ أي وسيط، فيطبع نوع الهيكل. إذا وُفر وسيط اختياري TYPE فإن الأمر يغير نوع الهيكل إلى TYPE. يُستخدم نوع الهيكل بواسطة بعض التطبيقات الرسومية لتصور المضيف أو تغيير تفاعل المستخدم. حاليًا، تُعرف أنواع الهياكل التالية: "desktop" و "laptop" و "convertible" و "server" و "tablet" و "handset" و "watch" و "embedded"، بالإضافة إلى أنواع الهياكل الخاصة "vm" و "container" للأنظمة الافتراضية التي تفتقر إلى هيكل مادي مباشر.

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

deployment [ENVIRONMENT]
    إذا لم يُعطَ أي وسيط، فيطبع بيئة النشر. إذا وُفر وسيط اختياري ENVIRONMENT فإن الأمر يغير بيئة النشر إلى ENVIRONMENT. يجب أن يكون الوسيط ENVIRONMENT كلمة واحدة دون أي محارف تحكم. يُقترح أحد ما يلي: "development"، "integration"، "staging"، "production".

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

location [LOCATION]
    إذا لم يُعطَ أي وسيط، فيطبع سلسلة الموقع للنظام. إذا وُفر وسيط اختياري LOCATION فإن الأمر يغير سلسلة الموقع للنظام إلى LOCATION. يجب أن يكون الوسيط LOCATION سلسلة نصية حرة سهلة القراءة تصف الموقع المادي للنظام، إذا كان معروفًا وقابلًا للتطبيق. قد يكون هذا عامًا مثل "Berlin, Germany" أو محددًا مثل "Left Rack, 2nd Shelf".

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

tags [وسم...]
    إذا لم يُعطَ أي معامل، تُطبع وسوم الآلة المُهيأة حاليًا كقائمة مفصولة بنقطتين. إذا وُفر معامل أو أكثر من TAG، يستبدل الأمر الوسوم المُهيأة بتلك المُحددة. قد يكون كل معامل بذاته قائمة مفصولة بنقطتين من الوسوم، لذا يمكن تحديد الوسوم إما كمعاملات متعددة أو كمعامل واحد مفصول بنقطتين، أو أي مزيج منها. تُزال الوسوم المكررة وتُفرز القائمة الناتجة قبل تخزينها. لإزالة جميع الوسوم، استدعِ الأمر بمعامل سلسلة محارف فارغة واحدة.

    وسوم الآلة هي تسميات قصيرة قد تُستخدم لتصنيف وتجميع الآلات لأغراض الإدارة، مثل تحديد الدور الذي تؤديه آلة في نشر، أو الأسطول أو الوحدة التنظيمية التي تنتمي إليها، أو أي سمة أخرى يُعرفها المسؤول. يجب أن يتراوح طول كل وسم فردي بين 1...255 حرفًا ويتكون فقط من محارف ASCII أبجدية رقمية، "-" و".". تُخزن الوسوم في حقل TAGS= من /etc/machine-info؛ انظر machine-info(5) للتفاصيل. قد تُطابق أيضًا مع إعدادات الوحدة ConditionMachineTag=/AssertMachineTag=، انظر systemd.unit(5).

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

الخيارات

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

--static, --transient, --pretty
    إذا استُدعي status (أو لم يُعطَ أي أمر صريح) وحُدد أحد هذه المفاتيح، فسيطبع hostnamectl اسم المضيف المحدد هذا فقط.

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

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

-H، --host=
    نفّذ العملية عن بُعد. حدد اسم مضيف، أو اسم مستخدم واسم مضيف يفصل بينهما "@" للاتصال به. يمكن اختيارياً إلحاق اسم المضيف بمنفذ يستمع إليه ssh، مفصولاً بـ ":"، ثم اسم حاوية، مفصولاً بـ "/"، مما يوصل مباشرة بحاوية معينة على المضيف المحدد. سيستخدم هذا SSH للتحدث إلى نسخة مدير الحاسوب البعيد. يمكن سرد أسماء الحاويات باستخدام machinectl -H المضيف. ضع عناوين IPv6بين قوسين.

-M، --machine=
    نفّذ العملية على حاوية محلية. حدد اسم الحاوية للاتصال بها، مسبوقًا اختياريًا باسم مستخدم للاتصال به وحرف "@" كفاصل. إذا استُخدمت السلسلة الخاصة ".host" بدلاً من اسم الحاوية، فسيُجرى اتصال بالنظام المحلي (وهو أمر مفيد للاتصال بناقل مستخدم معين: "--user --machine=lennart@.host"). إذا لم تُستخدم صيغة "@"، فسيُتصل كمستخدم جذر (root). إذا استُخدمت صيغة "@"، فيمكن حذف الجانب الأيسر أو الأيمن (ولكن ليس كلاهما) وفي هذه الحالة يُفترض اسم المستخدم المحلي و ".host".

--no-ask-password
    لا تسأل المستخدم عن الاستيثاق للعمليات ذات الامتيازات.

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

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

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

-j
    يكافئ --json=pretty إذا كان يعمل على طرفية، و --json=short في الحالات الأخرى.

حالة الخروج

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

انظر أيضًا

systemd(1), hostname(1), hostname(5), machine-info(5), systemctl(1), systemd-hostnamed.service(8), systemd-firstboot(1)

ملاحظات

1.  مواصفة تسمية الأيقونات
    https://specifications.freedesktop.org/icon-naming/latest

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

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

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