'\" t
.TH "SYSTEMD\-MACHINE\-ID\-SETUP" "1" "" "systemd 261.2" "systemd-machine-id-setup"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
systemd-machine-id-setup \- مقداردهی اولیه و تولید شناسه یکتای ماشین (/etc/machine-id)
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsystemd\-machine\-id\-setup\fR\ 'u
\fBsystemd\-machine\-id\-setup\fR
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsystemd\-machine\-id\-setup\fR
می‌تواند توسط ابزارهای نصب‌کننده سیستم برای مقداردهی اولیه شناسه ماشین ذخیره‌شده در
/etc/machine\-id
در زمان نصب، با یک شناسه از پیش تدارک‌دیده‌شده یا تصادفی تولیدشده استفاده شود\&. برای اطلاعات بیشتر در مورد این پرونده،
\fBmachine-id\fR(5)
را ببینید\&.
.PP
اگر این ابزار بدون سوییچ
\fB\-\-commit\fR
فراخوانی شود، در صورت مفقود بودن یا خالی بودن پرونده،
/etc/machine\-id
با یک شناسه ماشین جدید و معتبر مقداردهی اولیه می‌شود\&. شناسه جدید ماشین به روش‌های زیر به دست می‌آید:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
اگر یک شناسه ماشین معتبر در
/run/machine\-id
ذخیره شده باشد، شناسه ماشین کپی شده و برای مقداردهی اولیه شناسه ماشین در
/etc/machine\-id
استفاده می‌شود\&. در صورتی که
\fB\-\-root=\fR
مشخص شده باشد یا برنامه در یک محیط chroot اجرا شود، از این مرحله صرف‌نظر می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
اگر یک شناسه ماشین معتبر D\-Bus قبلاً برای سیستم پیکربندی شده باشد، شناسه ماشین D\-Bus کپی شده و برای مقداردهی اولیه شناسه ماشین در
/etc/machine\-id
استفاده می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
اگر یک شناسه ماشین معتبر از طریق اعتبارنامه
\fBsystem\&.machine_id\fR
ارائه شده باشد، شناسه ماشین کپی شده و برای مقداردهی اولیه شناسه ماشین در
/etc/machine\-id
استفاده می‌شود\&. در صورتی که
\fB\-\-root=\fR
مشخص شده باشد یا برنامه در یک محیط chroot اجرا شود، از این مرحله صرف‌نظر می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
اگر درون یک ماشین مجازی KVM اجرا شود و یک UUID پیکربندی شده باشد (از طریق گزینه
\fB\-uuid\fR)،
این UUID برای مقداردهی اولیه شناسه ماشین استفاده می‌شود\&. فراخواننده باید اطمینان حاصل کند که UUID ارائه‌شده به اندازه کافی یکتا بوده و برای هر نمونه بوت‌شده از ماشین مجازی متفاوت است\&. در صورتی که
\fB\-\-root=\fR
مشخص شده باشد یا برنامه در یک محیط chroot اجرا شود، از این مرحله صرف‌نظر می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  5." 4.2
.\}
به همین ترتیب، اگر درون محیط کانتینر لینوکس اجرا شود و یک UUID برای کانتینر پیکربندی شده باشد، از آن برای مقداردهی اولیه شناسه ماشین استفاده می‌شود\&. برای جزئیات، مستندات
\m[blue]\fBContainer Interface\fR\m[]\&\s-2\u[1]\d\s+2
را ببینید\&. در صورتی که
\fB\-\-root=\fR
مشخص شده باشد یا برنامه در یک محیط chroot اجرا شود، از این مرحله صرف‌نظر می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  6." 4.2
.\}
در غیر این صورت، یک شناسه جدید به صورت تصادفی تولید می‌شود\&.
.RE
.PP
سوییچ
\fB\-\-commit\fR
می‌تواند برای ثبت و ماندگار کردن شناسه ماشین موقت بر روی دیسک استفاده شود\&. برای جزئیات بیشتر به ادامه مطلب مراجعه کنید\&.
.PP
از
\fBsystemd-firstboot\fR(1)
برای مقداردهی اولیه شناسه ماشین روی ایمیج‌های سیستمی مانت‌شده (اما بوت‌نشده) استفاده کنید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-\-root=\fR\fB\fIpath\fR\fR
.RS 4
یک مسیر دایرکتوری را به عنوان آرگومان می‌گیرد\&. تمام مسیرهایی که روی آن‌ها عملیات انجام می‌شود با مسیر جایگزین
\fIroot\fR
داده‌شده پیشوندگذاری می‌شوند، از جمله مسیر خود
/etc/machine\-id\&.
.sp
افزوده‌شده در نگارش 212\&.
.RE
.PP
\fB\-\-image=\fR\fB\fIpath\fR\fR
.RS 4
مسیر یک گره دستگاه یا پرونده معمولی را به عنوان آرگومان می‌گیرد\&. این گزینه مشابه
\fB\-\-root=\fR
توضیح‌داده‌شده در بالا است، اما به جای یک درخت دایرکتوری روی یک ایمیج دیسک عمل می‌کند\&.
.sp
افزوده‌شده در نگارش 249\&.
.RE
.PP
\fB\-\-image\-policy=\fR\fB\fIpolicy\fR\fR
.RS 4
یک رشته سیاست ایمیج را مطابق
\fBsystemd.image-policy\fR(7)
به عنوان آرگومان می‌گیرد\&. این سیاست هنگام کار روی ایمیج دیسک مشخص‌شده از طریق
\fB\-\-image=\fR
(در بالا ببینید) اعمال می‌شود\&. در صورت عدم تعیین، پیش‌فرض روی سیاست
"*"
است، یعنی تمام سیستم‌های پرونده شناسایی‌شده در ایمیج استفاده می‌شوند\&.
.RE
.PP
\fB\-\-commit\fR
.RS 4
ثبت شناسه ماشین موقت روی دیسک\&. این دستور می‌تواند برای تبدیل یک شناسه ماشین موقت به یک شناسه دائمی استفاده شود\&. پرونده شناسه ماشین موقت پرونده‌ای است که در مراحل اولیه فرآیند بوت از یک سیستم پرونده حافظه (معمولاً
"tmpfs")
به
/etc/machine\-id
به صورت bind مانت شده باشد\&. این حالت ممکن است به این دلیل رخ دهد که
/etc/
در ابتدا فقط‌خواندنی بوده و در آن زمان فاقد یک پرونده شناسه ماشین معتبر بوده است\&.
.sp
اگر
/etc/machine\-id
از یک سیستم پرونده حافظه مانت نشده باشد، یا اگر
/etc/
فقط‌خواندنی باشد، این دستور هیچ عملیاتی انجام نخواهد داد\&. این دستور شناسه ماشین موقت فعلی را روی دیسک می‌نویسد و نقطه مانت
/etc/machine\-id
را بدون ایجاد شرایط رقابتی (race-free) آن‌مانت می‌کند تا اطمینان حاصل شود که این پرونده همواره برای سایر فرایندها معتبر و در دسترس است\&.
.sp
این دستور در درجه اول توسط سرویس اوایل بوت
\fBsystemd-machine-id-commit.service\fR(8)
استفاده می‌شود\&.
.sp
افزوده‌شده در نگارش 227\&.
.RE
.PP
\fB\-\-print\fR
.RS 4
چاپ شناسه ماشین تولیدشده یا ثبت‌شده پس از اتمام عملیات\&.
.sp
افزوده‌شده در نگارش 231\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش یک متن راهنمای کوتاه و خروج\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
نمایش نگارش برنامه و خروج\&.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.PP
در صورت موفقیت 0 بازگردانده می‌شود، و در غیر این صورت یک کد خطای غیرصفر بازگردانده خواهد شد\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBmachine-id\fR(5), \fBsystemd-machine-id-commit.service\fR(8), \fBdbus-uuidgen\fR(1), \fBsystemd-firstboot\fR(1)
.SH "نکات (NOTES)"
.IP " 1." 4
Container Interface
.RS 4
\%https://systemd.io/CONTAINER_INTERFACE
.RE