DBUS-UUIDGEN(1) دستورهای کاربری DBUS-UUIDGEN(1)

dbus-uuidgen - تولید یا خواندن شناسه یکتای عمومی (UUID) برای D-Bus

dbus-uuidgen [--ensure[=فایل]] [--get[=فایل]] [--version]

دستور dbus-uuidgen یک شناسه یکتای عمومی (UUID) برای شناسایی میزبان در شبکه یا ارتباطات D-Bus تولید میکند یا از فایل میخواند.

توجه داشته باشید که شناسه UUID در D-Bus ارتباطی با RFC 4122 ندارد و شناسه‌های UUID سازگار با آن مشخصه تولید نمی‌کند. بسیاری از سیستم‌ها دستور جداگانه‌ای برای این منظور دارند (که اغلب "uuidgen" نامیده می‌شود).

برای اطلاعات بیشتر درباره D-Bus به نشانی زیر مراجعه کنید:
https://www.freedesktop.org/wiki/Software/dbus

کاربرد اصلی dbus-uuidgen اجرا در اسکریپت پس از نصب (post-install) بسته D-Bus به صورت زیر است:

dbus-uuidgen --ensure

این کار تضمین می‌کند که /var/lib/dbus/machine-id وجود دارد و حاوی uuid است. این دستور یک uuid موجود را بازنویسی نمی‌کند، زیرا این شناسه برای یک ماشین باید حداقل تا راه‌اندازی مجدد بعدی ثابت باقی بماند.

ویژگی‌های مهم UUID ماشین عبارتند از اینکه ۱) تا راه‌اندازی مجدد بعدی بدون تغییر باقی می‌ماند و ۲) برای هر دو نمونه در حال اجرای هسته سیستم‌عامل متفاوت است. به این معنا که اگر دو فرایند UUID یکسانی را مشاهده کنند، باید حافظه اشتراکی، سوکت‌های دامنه یونیکس (UNIX domain sockets)، نمایشگرهای محلی X، تفکیک نام localhost.localdomain، شناسه‌های فرایند (PID) و موارد مشابه یکسانی را نیز ببینند.

اگر dbus-uuidgen را بدون هیچ گزینه‌ای اجرا کنید، صرفاً یک uuid تصادفی جدید تولید کرده و چاپ می‌کند.

اگر آن را با گزینه --get اجرا کنید، به طور پیش‌فرض UUID ماشین، یا در صورت تعیین فایل، UUID موجود در فایل مشخص‌شده را چاپ می‌کند.

اگر سعی کنید machine-id موجود را روی یک سیستم در حال اجرا تغییر دهید، احتمالاً به رخ دادن اتفاقات ناگواری منجر خواهد شد. سعی نکنید این فایل را تغییر دهید. همچنین، آن را روی دو سیستم متفاوت یکسان قرار ندهید؛ هر زمان که دو هسته متفاوت در حال اجرا هستند، این مقدار باید متفاوت باشد.

مقدار UUID باید در دو ماشین مجازی مختلف نیز متفاوت باشد، زیرا دو هسته مختلف در حال اجرا هستند.

گزینه‌های زیر پشتیبانی می‌شوند:

اگر نام فایلی داده نشود، مقدار پیش‌فرض آن localstatedir/lib/dbus/machine-id خواهد بود (localstatedir معمولاً /var است). اگر این فایل موجود و معتبر باشد، uuid درون فایل در خروجی استاندارد چاپ می‌شود. در غیر این صورت، دستور با وضعیتی غیرصفر خارج می‌شود.
اگر نام فایلی داده نشود، مقدار پیش‌فرض آن localstatedir/lib/dbus/machine-id خواهد بود (localstatedir معمولاً /var است). اگر این فایل وجود داشته باشد، اعتبارسنجی خواهد شد و اگر حاوی داده‌های نادرست باشد، کد خطا بازگردانده می‌شود. اگر فایل وجود نداشته باشد، همراه با یک uuid جدید ایجاد خواهد شد. در صورت موفقیت، هیچ خروجی چاپ نمی‌شود.
نمایش اطلاعات نسخه dbus-uuidgen و خروج.

نگاه کنید به:
https://dbus.freedesktop.org/doc/AUTHORS

لطفاً گزارش‌های اشکال را به فهرست پستی D-Bus یا سامانه پیگیری اشکالات ارسال کنید؛ نگاه کنید به:
https://www.freedesktop.org/wiki/Software/dbus

سپتامبر ۲۰۲۲ D-Bus