SYSTEMD-ID128(1) systemd-id128 SYSTEMD-ID128(1)

systemd-id128 - تولید و بررسی شناسه‌های یکتای ۱۲۸ بیتی (ID128 / UUID)

systemd-id128 [OPTIONS...] new

systemd-id128 [OPTIONS...] machine-id

systemd-id128 [OPTIONS...] boot-id

systemd-id128 [OPTIONS...] invocation-id

systemd-id128 [OPTIONS...] var-partition-uuid

systemd-id128 [OPTIONS...] show [NAME|UUID...]

id128 ممکن است برای چاپ آسان شناسه‌های UUID در قالب sd-id128(3) استفاده شود. این‌که چه شناسه‌ای چاپ شود، به دستور (verb) مشخص‌شده بستگی دارد.

با new، یک شناسه تصادفی جدید تولید خواهد شد.

با machine-id، شناسه ماشین فعلی چاپ خواهد شد. به machine-id(5) مراجعه کنید.

با boot-id، شناسه بوت فعلی چاپ خواهد شد.

با invocation-id، شناسه فراخوانی سرویس فعلی چاپ خواهد شد. این شناسه در سرویس‌های systemd در دسترس است. به systemd.exec(5) مراجعه کنید.

با show، شناسه‌های شناخته‌شده (در حال حاضر، فقط UUIDهای نوع پارتیشن GPT) همراه با رشته‌های شناسه کوتاه چاپ می‌شوند. وقتی هیچ آرگومانی مشخص نشده باشد، همه شناسه‌های شناخته‌شده نمایش داده می‌شوند. وقتی آرگومان‌هایی مشخص شوند، می‌توانند شناسه‌ها یا مقادیر یک یا چند شناسه شناخته‌شده باشند که در این صورت با نامشان چاپ می‌شوند، یا شناسه‌های دلخواه که با یک نام نگه‌دارنده مکان چاپ می‌شوند. برای فهرست کردن شناسه‌ها به سبک UUID (یعنی همان شیوه‌ای که UUIDهای نوع پارتیشن GPT معمولاً نشان داده می‌شوند) آن را با --uuid ترکیب کنید.

دستورات machine-id، boot-id و show را می‌توان با سوییچ --app-specific=app-id ترکیب کرد تا شناسه‌های ویژه برنامه (application-specific) تولید شوند. برای بررسی کاربرد این ویژگی به sd_id128_get_machine(3) مراجعه کنید. پشتیبانی از show --app-specific= در نسخه ۲۵۵ اضافه شد.

دستور var-partition-uuid یک UUID را چاپ می‌کند که طبق مشخصات پارتیشن‌های قابل‌کشف UAPI.2[1] باید به‌عنوان UUID پارتیشن GPT برای /var/ استفاده شود، که از نوع پارتیشن GPT مشتق شده و توسط /etc/machine-id محلی کلیدگذاری می‌شود. در نسخه ۲۵۷ اضافه شد.

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

-p, --pretty

تولید خروجی به‌صورت قطعه‌کدهای زبان برنامه‌نویسی.

در نسخه ۲۴۰ اضافه شد.

-P, --value

تنها چاپ مقدار. می‌تواند با -u/--uuid ترکیب شود.

در نسخه ۲۵۵ اضافه شد.

-a app-id, --app-specific=app-id

با این گزینه، شناسه‌هایی چاپ می‌شوند که حاصل هش کردن شناسه برنامه app-id و یک شناسه دیگر هستند. آرگومان app-id باید یک رشته معتبر sd-id128 باشد که برنامه را مشخص می‌کند. هنگام استفاده همراه با machine-id، شناسه دیگر همان شناسه ماشین خواهد بود که در machine-id(5) توصیف شده است؛ هنگام استفاده با boot-id، شناسه دیگر همان شناسه بوت خواهد بود؛ و هنگام استفاده با show، شناسه یا شناسه‌های دیگر باید از طریق آرگومان‌های مکانی (positional) مشخص شوند.

در نسخه ۲۴۰ اضافه شد.

-u, --uuid

تولید خروجی به‌صورت یک UUID با قالب‌بندی «نمایش استاندارد» (canonical representation)، با پنج گروه از ارقام که با خط تیره جدا شده‌اند. برای توضیحات بیشتر به مدخل ویکی‌پدیا درباره شناسه‌های یکتای سراسری (Universally Unique Identifiers)[2] مراجعه کنید.

در نسخه ۲۴۴ اضافه شد.

--no-pager

خروجی را به یک صفحه‌بند (pager) هدایت نکن.

--no-legend

راهنمای علائم (legend)، یعنی سرستون‌ها و پانویس حاوی نکات را چاپ نکن.

--json=MODE

نمایش خروجی با قالب‌بندی JSON. یکی از مقادیر "short" (برای کوتاه‌ترین خروجی ممکن بدون هیچ فاصله یا شکست خط اضافی)، "pretty" (برای نسخه زیبای همان، همراه با تورفتگی و شکست خط) یا "off" (برای غیرفعال کردن خروجی JSON، که حالت پیش‌فرض است) را می‌پذیرد.

-j

معادل --json=pretty هنگام اجرا در ترمینال، و --json=short در غیر این صورت.

-h, --help

نمایش یک متن راهنمای کوتاه و خروج.

--version

نمایش نسخه کوتاه برنامه و خروج.

در صورت موفقیت 0 بازگردانده می‌شود، و در غیر این صورت یک کد شکست غیر صفر برگردانده خواهد شد.

مثال ۱. نمایش یک UUID شناخته‌شده

$ 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

مثال ۲. تولید یک UUID ویژه برنامه

$ 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 \
    -a 1fb8f24b-02df-458d-9659-cc8ace68e28a
47b82cb1-5339-43da-b2a6-1c350aef1bd1

روی یک ماشین معین با شناسه 3a9d668b-4db7-4939-8a4a-5e78a03bffb7، برای برنامه 1fb8f24b-02df-458d-9659-cc8ace68e28a، یک شناسه ماشین ویژه برنامه (47b82cb1-5339-43da-b2a6-1c350aef1bd1) تولید می‌کنیم. اگر بعداً بخواهیم همین محاسبه را روی ماشین دیگری بازآفرینی کنیم، باید هر دو شناسه را به‌طور صریح به‌عنوان پارامتر به show ارائه دهیم.

systemd(1), sd-id128(3), sd_id128_get_machine(3)

1.
مشخصات پارتیشن‌های قابل‌کشف UAPI.2 (UAPI.2 Discoverable Partitions Specification)
https://uapi-group.org/specifications/specs/discoverable_partitions_specification
2.
شناسه‌های یکتای سراسری (Universally Unique Identifiers)
https://en.wikipedia.org/wiki/Universally_unique_identifier#Format
systemd 261.2