MACHINE-INFO(5) machine-info MACHINE-INFO(5)

machine-info - فایل اطلاعات متادیتای محلی ماشین

/etc/machine-info

فایل /etc/machine-info حاوی متادیتای ماشین است.

قالب machine-info فهرستی از انتساب متغیرهای سازگار با شل و مشابه متغیرهای محیطی است که با خط جدید از هم جدا شده‌اند، و در آن خطوط خالی و کامنت‌ها نادیده گرفته می‌شوند. امکان فراخوانی (source کردن) این پیکربندی از اسکریپت‌های شل وجود دارد، با این حال، فراتر از انتساب ساده متغیرها، هیچ قابلیت شل دیگری پشتیبانی نمی‌شود، که به برنامه‌ها اجازه می‌دهد این فایل را بدون پیاده‌سازی موتور اجرایی سازگار با شل بخوانند. برای توضیحات دقیق درباره این قالب به os-release(5) مراجعه کنید.

فایل /etc/machine-info حاوی متادیتا درباره ماشین است که توسط کاربر یا مدیر سیستم تنظیم می‌شود. تنظیمات پیکربندی‌شده در اینجا بالاترین اولویت را دارند. در صورت عدم تنظیم، مقادیر مناسب ممکن است به‌طور خودکار بر اساس اطلاعات سخت‌افزار یا سایر فایل‌های پیکربندی تعیین شوند. بنابراین عدم وجود این فایل کاملاً بی‌اشکال است.

می‌توانید از hostnamectl(1) برای تغییر تنظیمات این فایل از خط فرمان استفاده کنید.

پارامترهای متادیتای ماشین زیر را می‌توان با استفاده از /etc/machine-info تنظیم کرد:

PRETTY_HOSTNAME=

یک رشته شناسه ماشین زیبا، خوانا برای انسان و با کدگذاری UTF-8 است. این رشته باید شامل نامی مانند "Lennart's Laptop" باشد که برای نمایش به کاربر مناسب است و از محدودیت‌های نحوی نام‌های دامنه اینترنتی تأثیر نمی‌پذیرد. در صورت امکان، نام میزبان اینترنتی که در /etc/hostname پیکربندی شده است باید مشابه این نام نگه داشته شود. مثال: اگر این مقدار "Lennart's Computer" باشد، یک نام میزبان اینترنتی مانند "lennarts-computer" می‌تواند انتخاب مناسبی باشد. اگر این پارامتر تنظیم نشود، برنامه باید برای مقاصد نمایشی به نام میزبان اینترنتی رجوع کند.

ICON_NAME=

یک آیکون که این ماشین را مطابق با XDG Icon Naming Specification[1] مشخص می‌کند. اگر این پارامتر تنظیم نشود، برنامه باید به "computer" یا نام آیکون مشابهی رجوع کند.

CHASSIS=

نوع شاسی دستگاه. در حال حاضر، انواع شاسی زیر تعریف شده‌اند: "desktop" (رایانه رومیزی)، "laptop" (لپ‌تاپ)، "convertible" (تبدیل‌پذیر)، "server" (سرور)، "tablet" (تبلت)، "handset" (گوشی همراه)، "watch" (ساعت هوشمند)، و "embedded" (تعبیه‌شده)، و همچنین انواع شاسی ویژه "vm" (ماشین مجازی) و "container" (کانتینر) برای سیستم‌های مجازی‌سازی‌شده که فاقد شاسی فیزیکی بی‌واسطه هستند.

توجه داشته باشید که اکثر سیستم‌ها امکان تشخیص خودکار نوع شاسی را فراهم می‌کنند (بر اساس اطلاعات سفت‌افزار یا موارد مشابه). این تنظیم تنها باید برای بازنویسی یک تشخیص نادرست یا برای پیکربندی دستی نوع شاسی در جایی که تشخیص خودکار در دسترس نیست استفاده شود.

افزوده‌شده در نسخه ۱۹۷.

DEPLOYMENT=

محیط استقرار سیستم را توصیف می‌کند. یکی از موارد زیر پیشنهاد می‌شود: "development" (توسعه)، "integration" (ادغام)، "staging" (پیش‌تولید)، "testing" (آزمایش)، "production" (تولید).

افزوده‌شده در نسخه ۲۱۶.

LOCATION=

مکان سیستم را در صورت کاربرد داشتن و مشخص بودن توصیف می‌کند. یک رشته آزاد و کاربرپسند می‌پذیرد. این مقدار می‌تواند به صورت کلی مانند "Berlin, Germany" یا دقیق مانند "Left Rack, 2nd Shelf" باشد.

افزوده‌شده در نسخه ۲۱۶.

TAGS=

فهرستی از برچسب‌ها که با دو‌نقطه (colon) از هم جدا شده‌اند و به این ماشین الصاق می‌شوند. برچسب‌ها برچسب‌های کوتاهی هستند که می‌توانند برای دسته‌بندی و گروه‌بندی ماشین‌ها برای اهداف مدیریتی استفاده شوند، به عنوان مثال برای شناسایی نقشی که یک ماشین در یک استقرار ایفا می‌کند ("webserver" یا "database")، ناوگان یا واحد سازمانی که به آن تعلق دارد، یا هر ویژگی دیگری که توسط مدیر سیستم تعریف شده است. مثال: "TAGS=webserver:frontend:berlin".

هر برچسب جداگانه باید بین ۱ تا ۲۵۵ نویسه طول داشته باشد و فقط می‌تواند شامل نویسه‌های الفبایی-عددی ASCII، "-" و "." باشد.

برچسب‌های پیکربندی‌شده را می‌توان با تنظیمات واحد ConditionMachineTag= و AssertMachineTag= تطبیق داد؛ برای جزئیات به systemd.unit(5) مراجعه کنید. آن‌ها را می‌توان با دستور tags از hostnamectl(1) پرس‌وجو کرد و تغییر داد.

افزوده‌شده در نسخه ۲۶۱.

HARDWARE_VENDOR=

تولیدکننده سخت‌افزار را مشخص می‌کند. در صورت نامشخص بودن، تولیدکننده سخت‌افزار تنظیم‌شده در DMI یا hwdb(7) استفاده خواهد شد.

افزوده‌شده در نسخه ۲۵۱.

HARDWARE_MODEL=

مدل سخت‌افزار را مشخص می‌کند. در صورت نامشخص بودن، مدل سخت‌افزار تنظیم‌شده در DMI یا hwdb(7) استفاده خواهد شد.

افزوده‌شده در نسخه ۲۵۱.

HARDWARE_SKU=

شناسه SKU (واحد نگهداری موجودی) سخت‌افزار را مشخص می‌کند. در صورت نامشخص بودن، SKU سخت‌افزار تنظیم‌شده در DMI استفاده خواهد شد.

افزوده‌شده در نسخه ۲۵۸.

HARDWARE_VERSION=

نسخه سخت‌افزار را مشخص می‌کند. در صورت نامشخص بودن، نسخه سخت‌افزار تنظیم‌شده در DMI استفاده خواهد شد.

افزوده‌شده در نسخه ۲۵۸.

توزیع‌کنندگان سیستم‌عامل و مدیران systemd می‌توانند ساختار این فایل را گسترش داده و فیلدهای جدیدی معرفی کنند. اکیداً توصیه می‌شود برای جلوگیری از تداخل نام‌ها، فیلدهای جدید را با یک پیشوند ویژه سیستم‌عامل نام‌گذاری کنید. برنامه‌هایی که این فایل را می‌خوانند باید فیلدهای ناشناخته را نادیده بگیرند.

مثال: "_LOCAL_EMERGENCY_CONTACT="user@example.org"".

PRETTY_HOSTNAME="Lennart's Tablet"
ICON_NAME=computer-tablet
CHASSIS=tablet
DEPLOYMENT=production
TAGS=demo:berlin

systemd(1), os-release(5), hostname(5), machine-id(5), hostnamectl(1), systemd-hostnamed.service(8)

1.
مشخصات نام‌گذاری آیکون XDG (XDG Icon Naming Specification)
https://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html
systemd 261.2