.TH "DBUS\-UUIDGEN" "1" "سپتامبر ۲۰۲۲" "D-Bus" "دستورهای کاربری"
.SH "نام (NAME)"
dbus-uuidgen \- تولید یا خواندن شناسه یکتای عمومی (UUID) برای D-Bus
.SH "خلاصه دستور (SYNOPSIS)"
.B dbus-uuidgen
[\fB\-\-ensure\fR[=\fIفایل\fR]]
[\fB\-\-get\fR[=\fIفایل\fR]]
[\fB\-\-version\fR]
.SH "توضیحات (DESCRIPTION)"
دستور \fBdbus-uuidgen\fR یک شناسه یکتای عمومی (UUID) برای شناسایی میزبان در شبکه یا ارتباطات D-Bus تولید میکند یا از فایل میخواند.
.PP
توجه داشته باشید که شناسه UUID در D-Bus ارتباطی با RFC 4122 ندارد و شناسه‌های UUID سازگار با آن مشخصه تولید نمی‌کند. بسیاری از سیستم‌ها دستور جداگانه‌ای برای این منظور دارند (که اغلب "uuidgen" نامیده می‌شود).
.PP
برای اطلاعات بیشتر درباره D-Bus به نشانی زیر مراجعه کنید:
.br
<https://www.freedesktop.org/wiki/Software/dbus>
.PP
کاربرد اصلی
.B dbus\-uuidgen
اجرا در اسکریپت پس از نصب (post-install) بسته D-Bus به صورت زیر است:
.PP
.nf
  dbus\-uuidgen \-\-ensure
.fi
.PP
این کار تضمین می‌کند که
.I /var/lib/dbus/machine\-id
وجود دارد و حاوی uuid است. این دستور یک uuid موجود را بازنویسی نمی‌کند، زیرا این شناسه برای یک ماشین باید حداقل تا راه‌اندازی مجدد بعدی ثابت باقی بماند.
.PP
ویژگی‌های مهم UUID ماشین عبارتند از اینکه ۱) تا راه‌اندازی مجدد بعدی بدون تغییر باقی می‌ماند و ۲) برای هر دو نمونه در حال اجرای هسته سیستم‌عامل متفاوت است. به این معنا که اگر دو فرایند UUID یکسانی را مشاهده کنند، باید حافظه اشتراکی، سوکت‌های دامنه یونیکس (UNIX domain sockets)، نمایشگرهای محلی X، تفکیک نام localhost.localdomain، شناسه‌های فرایند (PID) و موارد مشابه یکسانی را نیز ببینند.
.PP
اگر
.B dbus\-uuidgen
را بدون هیچ گزینه‌ای اجرا کنید، صرفاً یک uuid تصادفی جدید تولید کرده و چاپ می‌کند.
.PP
اگر آن را با گزینه
.B \-\-get
اجرا کنید، به طور پیش‌فرض UUID ماشین، یا در صورت تعیین فایل، UUID موجود در فایل مشخص‌شده را چاپ می‌کند.
.PP
اگر سعی کنید machine-id موجود را روی یک سیستم در حال اجرا تغییر دهید، احتمالاً به رخ دادن اتفاقات ناگواری منجر خواهد شد. سعی نکنید این فایل را تغییر دهید. همچنین، آن را روی دو سیستم متفاوت یکسان قرار ندهید؛ هر زمان که دو هسته متفاوت در حال اجرا هستند، این مقدار باید متفاوت باشد.
.PP
مقدار UUID باید در دو ماشین مجازی مختلف نیز متفاوت باشد، زیرا دو هسته مختلف در حال اجرا هستند.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.TP
\fB\-\-get\fR[=\fIفایل\fR]
اگر نام فایلی داده نشود، مقدار پیش‌فرض آن localstatedir/lib/dbus/machine\-id خواهد بود (localstatedir معمولاً /var است). اگر این فایل موجود و معتبر باشد، uuid درون فایل در خروجی استاندارد چاپ می‌شود. در غیر این صورت، دستور با وضعیتی غیرصفر خارج می‌شود.
.TP
\fB\-\-ensure\fR[=\fIفایل\fR]
اگر نام فایلی داده نشود، مقدار پیش‌فرض آن localstatedir/lib/dbus/machine\-id خواهد بود (localstatedir معمولاً /var است). اگر این فایل وجود داشته باشد، اعتبارسنجی خواهد شد و اگر حاوی داده‌های نادرست باشد، کد خطا بازگردانده می‌شود. اگر فایل وجود نداشته باشد، همراه با یک uuid جدید ایجاد خواهد شد. در صورت موفقیت، هیچ خروجی چاپ نمی‌شود.
.TP
\fB\-\-version\fR
نمایش اطلاعات نسخه dbus\-uuidgen و خروج.
.SH "نویسندگان (AUTHORS)"
نگاه کنید به:
.br
<https://dbus.freedesktop.org/doc/AUTHORS>
.SH "گزارش اشکالات (BUGS)"
لطفاً گزارش‌های اشکال را به فهرست پستی D-Bus یا سامانه پیگیری اشکالات ارسال کنید؛ نگاه کنید به:
.br
<https://www.freedesktop.org/wiki/Software/dbus>