'\" t
.TH "SYSTEMD\-ID128" "1" "" "systemd 261.2" "systemd-id128"
.\" -----------------------------------------------------------------
.\" * 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-id128 \- تولید و بررسی شناسه‌های یکتای ۱۲۸ بیتی (ID128 / UUID)
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsystemd\-id128\fR\ 'u
\fBsystemd\-id128\fR [OPTIONS...] new
.HP \w'\fBsystemd\-id128\fR\ 'u
\fBsystemd\-id128\fR [OPTIONS...] machine\-id
.HP \w'\fBsystemd\-id128\fR\ 'u
\fBsystemd\-id128\fR [OPTIONS...] boot\-id
.HP \w'\fBsystemd\-id128\fR\ 'u
\fBsystemd\-id128\fR [OPTIONS...] invocation\-id
.HP \w'\fBsystemd\-id128\fR\ 'u
\fBsystemd\-id128\fR [OPTIONS...] var\-partition\-uuid
.HP \w'\fBsystemd\-id128\fR\ 'u
\fBsystemd\-id128\fR [OPTIONS...] show [NAME|UUID...]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBid128\fR
ممکن است برای چاپ آسان شناسه‌های UUID در قالب
\fBsd-id128\fR(3)
استفاده شود\&. این‌که چه شناسه‌ای چاپ شود، به دستور (verb) مشخص‌شده بستگی دارد\&.
.PP
با
\fBnew\fR،
یک شناسه تصادفی جدید تولید خواهد شد\&.
.PP
با
\fBmachine\-id\fR،
شناسه ماشین فعلی چاپ خواهد شد\&. به
\fBmachine-id\fR(5)
مراجعه کنید\&.
.PP
با
\fBboot\-id\fR،
شناسه بوت فعلی چاپ خواهد شد\&.
.PP
با
\fBinvocation\-id\fR،
شناسه فراخوانی سرویس فعلی چاپ خواهد شد\&. این شناسه در سرویس‌های systemd در دسترس است\&. به
\fBsystemd.exec\fR(5)
مراجعه کنید\&.
.PP
با
\fBshow\fR،
شناسه‌های شناخته‌شده (در حال حاضر، فقط UUIDهای نوع پارتیشن GPT) همراه با رشته‌های شناسه کوتاه چاپ می‌شوند\&. وقتی هیچ آرگومانی مشخص نشده باشد، همه شناسه‌های شناخته‌شده نمایش داده می‌شوند\&. وقتی آرگومان‌هایی مشخص شوند، می‌توانند شناسه‌ها یا مقادیر یک یا چند شناسه شناخته‌شده باشند که در این صورت با نامشان چاپ می‌شوند، یا شناسه‌های دلخواه که با یک نام نگه‌دارنده مکان چاپ می‌شوند\&. برای فهرست کردن شناسه‌ها به سبک UUID (یعنی همان شیوه‌ای که UUIDهای نوع پارتیشن GPT معمولاً نشان داده می‌شوند) آن را با
\fB\-\-uuid\fR
ترکیب کنید\&.
.PP
دستورات
\fBmachine\-id\fR،
\fBboot\-id\fR
و
\fBshow\fR
را می‌توان با سوییچ
\fB\-\-app\-specific=\fR\fB\fIapp\-id\fR\fR
ترکیب کرد تا شناسه‌های ویژه برنامه (application-specific) تولید شوند\&. برای بررسی کاربرد این ویژگی به
\fBsd_id128_get_machine\fR(3)
مراجعه کنید\&. پشتیبانی از
\fBshow \-\-app\-specific=\fR
در نسخه ۲۵۵ اضافه شد\&.
.PP
دستور
\fBvar\-partition\-uuid\fR
یک UUID را چاپ می‌کند که طبق
\m[blue]\fBمشخصات پارتیشن‌های قابل‌کشف UAPI\&.2\fR\m[]\&\s-2\u[1]\d\s+2
باید به‌عنوان UUID پارتیشن GPT برای
/var/
استفاده شود، که از نوع پارتیشن GPT مشتق شده و توسط
/etc/machine\-id
محلی کلیدگذاری می‌شود\&. در نسخه ۲۵۷ اضافه شد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-p\fR, \fB\-\-pretty\fR
.RS 4
تولید خروجی به‌صورت قطعه‌کدهای زبان برنامه‌نویسی\&.
.sp
در نسخه ۲۴۰ اضافه شد\&.
.RE
.PP
\fB\-P\fR, \fB\-\-value\fR
.RS 4
تنها چاپ مقدار\&. می‌تواند با
\fB\-u\fR/\fB\-\-uuid\fR
ترکیب شود\&.
.sp
در نسخه ۲۵۵ اضافه شد\&.
.RE
.PP
\fB\-a \fR\fB\fIapp\-id\fR\fR, \fB\-\-app\-specific=\fR\fB\fIapp\-id\fR\fR
.RS 4
با این گزینه، شناسه‌هایی چاپ می‌شوند که حاصل هش کردن شناسه برنامه
\fIapp\-id\fR
و یک شناسه دیگر هستند\&. آرگومان
\fIapp\-id\fR
باید یک رشته معتبر sd-id128 باشد که برنامه را مشخص می‌کند\&. هنگام استفاده همراه با
\fBmachine\-id\fR،
شناسه دیگر همان شناسه ماشین خواهد بود که در
\fBmachine-id\fR(5)
توصیف شده است؛ هنگام استفاده با
\fBboot\-id\fR،
شناسه دیگر همان شناسه بوت خواهد بود؛ و هنگام استفاده با
\fBshow\fR،
شناسه یا شناسه‌های دیگر باید از طریق آرگومان‌های مکانی (positional) مشخص شوند\&.
.sp
در نسخه ۲۴۰ اضافه شد\&.
.RE
.PP
\fB\-u\fR, \fB\-\-uuid\fR
.RS 4
تولید خروجی به‌صورت یک UUID با قالب‌بندی «نمایش استاندارد» (canonical representation)، با پنج گروه از ارقام که با خط تیره جدا شده‌اند\&. برای توضیحات بیشتر به مدخل ویکی‌پدیا درباره
\m[blue]\fBشناسه‌های یکتای سراسری (Universally Unique Identifiers)\fR\m[]\&\s-2\u[2]\d\s+2
مراجعه کنید\&.
.sp
در نسخه ۲۴۴ اضافه شد\&.
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
خروجی را به یک صفحه‌بند (pager) هدایت نکن\&.
.RE
.PP
\fB\-\-no\-legend\fR
.RS 4
راهنمای علائم (legend)، یعنی سرستون‌ها و پانویس حاوی نکات را چاپ نکن\&.
.RE
.PP
\fB\-\-json=\fR\fB\fIMODE\fR\fR
.RS 4
نمایش خروجی با قالب‌بندی JSON\&. یکی از مقادیر
"short"
(برای کوتاه‌ترین خروجی ممکن بدون هیچ فاصله یا شکست خط اضافی)،
"pretty"
(برای نسخه زیبای همان، همراه با تورفتگی و شکست خط) یا
"off"
(برای غیرفعال کردن خروجی JSON، که حالت پیش‌فرض است) را می‌پذیرد\&.
.RE
.PP
\fB\-j\fR
.RS 4
معادل
\fB\-\-json=pretty\fR
هنگام اجرا در ترمینال، و
\fB\-\-json=short\fR
در غیر این صورت\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش یک متن راهنمای کوتاه و خروج\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
نمایش نسخه کوتاه برنامه و خروج\&.
.RE
.SH "کدهای خروج (EXIT STATUS)"
.PP
در صورت موفقیت 0 بازگردانده می‌شود، و در غیر این صورت یک کد شکست غیر صفر برگردانده خواهد شد\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBمثال\ \&۱.\ \&نمایش یک UUID شناخته‌شده\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-id128 show \-\-value user\-home
773f91ef66d449b5bd83d683bf40ad16

$ systemd\-id128 show \-\-value \-\-uuid user\-home
773f91ef\-66d4\-49b5\-bd83\-d683bf40ad16

$ systemd\-id128 show 773f91ef\-66d4\-49b5\-bd83\-d683bf40ad16
NAME      ID
user\-home 773f91ef66d449b5bd83d683bf40ad16
.fi
.if n \{\
.RE
.\}
.PP
\fBمثال\ \&۲.\ \&تولید یک UUID ویژه برنامه\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-id128 machine\-id \-u
3a9d668b\-4db7\-4939\-8a4a\-5e78a03bffb7

$ systemd\-id128 new \-u
1fb8f24b\-02df\-458d\-9659\-cc8ace68e28a

$ systemd\-id128 machine\-id \-u \-a 1fb8f24b\-02df\-458d\-9659\-cc8ace68e28a
47b82cb1\-5339\-43da\-b2a6\-1c350aef1bd1

$ systemd\-id128 \-Pu show 3a9d668b\-4db7\-4939\-8a4a\-5e78a03bffb7 \e
    \-a 1fb8f24b\-02df\-458d\-9659\-cc8ace68e28a
47b82cb1\-5339\-43da\-b2a6\-1c350aef1bd1
.fi
.if n \{\
.RE
.\}
.PP
روی یک ماشین معین با شناسه 3a9d668b\-4db7\-4939\-8a4a\-5e78a03bffb7، برای برنامه 1fb8f24b\-02df\-458d\-9659\-cc8ace68e28a، یک شناسه ماشین ویژه برنامه (47b82cb1\-5339\-43da\-b2a6\-1c350aef1bd1) تولید می‌کنیم\&. اگر بعداً بخواهیم همین محاسبه را روی ماشین دیگری بازآفرینی کنیم، باید هر دو شناسه را به‌طور صریح به‌عنوان پارامتر به
\fBshow\fR
ارائه دهیم\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsd-id128\fR(3), \fBsd_id128_get_machine\fR(3)
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
مشخصات پارتیشن‌های قابل‌کشف UAPI.2 (UAPI.2 Discoverable Partitions Specification)
.RS 4
\%https://uapi-group.org/specifications/specs/discoverable_partitions_specification
.RE
.IP " 2." 4
شناسه‌های یکتای سراسری (Universally Unique Identifiers)
.RS 4
\%https://en.wikipedia.org/wiki/Universally_unique_identifier#Format
.RE