'\" t
.TH "UPDATECTL" "1" "" "systemd 261.2" "updatectl"
.\" -----------------------------------------------------------------
.\" * 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)"
updatectl \- مدیریت سرویس به‌روزرسانی سیستم
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBupdatectl\fR\ 'u
\fBupdatectl\fR [OPTIONS...] {COMMAND} [TARGET...]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBupdatectl\fR
می‌تواند برای بررسی و نصب به‌روزرسانی‌های سیستم که توسط
\fBsystemd-sysupdated.service\fR(8)
مدیریت می‌شوند، استفاده شود\&.
.SH "فرمان‌ها (COMMANDS)"
.PP
فرمان‌های زیر پشتیبانی می‌شوند:
.PP
\fBlist\fR [\fITARGET\fR[@\fIVERSION\fR]]
.RS 4
نمایش اطلاعات درباره اهداف و نسخه‌های آن‌ها\&.
.sp
هنگامی که هیچ
\fITARGET\fR
مشخص نشده باشد، این فرمان تمام اهداف در دسترس را فهرست می‌کند\&. هنگامی که یک
\fITARGET\fR
بدون
\fIVERSION\fR
مشخص شود، این فرمان تمام نسخه‌های شناخته‌شده از هدف مشخص‌شده را فهرست می‌نماید\&. اگر یک
\fIVERSION\fR
مشخص شده باشد، این فرمان تمام اطلاعات شناخته‌شده درباره آن نسخه خاص را فهرست می‌کند\&.
.sp
برای جزئیات خروجی، مثال زیر را ببینید\&.
.sp
در نسخه 257 اضافه شد\&.
.RE
.PP
\fBcheck\fR [\fITARGET\fR\&...]
.RS 4
بررسی می‌کند که آیا به‌روزرسانی‌ای برای اهداف مشخص‌شده در دسترس است یا خیر\&. اگر هیچ هدفی مشخص نشود، وجود به‌روزرسانی برای تمام اهداف موجود بررسی خواهد شد\&.
.sp
برای جزئیات خروجی، مثال زیر را ببینید\&.
.sp
در نسخه 257 اضافه شد\&.
.RE
.PP
\fBupdate\fR [\fITARGET\fR[@\fIVERSION\fR]\&...]
.RS 4
اهداف مشخص‌شده را به نسخه‌های تعیین‌شده به‌روزرسانی می‌کند\&. اگر یک هدف بدون نسخه مشخص شود، به آخرین نسخه به‌روزرسانی خواهد شد\&. اگر هیچ هدفی مشخص نشود، تمام اهداف موجود به آخرین نسخه به‌روزرسانی می‌شوند\&.
.sp
در نسخه 257 اضافه شد\&.
.RE
.PP
\fBvacuum\fR [\fITARGET\fR\&...]
.RS 4
پاک‌سازی نسخه‌های قدیمی اهداف مشخص‌شده\&. اگر هیچ هدفی مشخص نشود، تمام اهداف موجود پاک‌سازی (vacuum) خواهند شد\&.
.sp
در نسخه 257 اضافه شد\&.
.RE
.PP
\fBfeatures\fR [\fIFEATURE\fR]
.RS 4
هنگامی که هیچ
\fIFEATURE\fR
مشخص نشده باشد، این فرمان تمام ویژگی‌های اختیاری را فهرست می‌کند\&. هنگامی که یک
\fIFEATURE\fR
مشخص شده باشد، این فرمان تمام اطلاعات شناخته‌شده درباره آن ویژگی را فهرست می‌نماید\&.
.sp
در نسخه 257 اضافه شد\&.
.RE
.PP
\fBenable\fR \fIFEATURE\fR\&..., \fBdisable\fR \fIFEATURE\fR\&...
.RS 4
این فرمان‌ها ویژگی‌های اختیاری را فعال یا غیرفعال می‌کنند\&. به
\fBsysupdate.features\fR(5)
مراجعه کنید\&. این فرمان‌ها همیشه روی سیستم میزبان عمل می‌کنند\&.
.sp
به‌طور پیش‌فرض، این فرمان‌ها تنها با ایجاد یا حذف فایل‌های drop\-in پیکربندی سیستم را تغییر می‌دهند؛ آن‌ها ویژگی‌های فعال‌شده را بلافاصله بارگیری نمی‌کنند، و بازمانده‌های ویژگی‌های غیرفعال‌شده را فوراً پاک‌سازی نمی‌نمایند\&. ویژگی‌های فعال‌شده در به‌روزرسانی بعدی هدف بارگیری و نصب خواهند شد، و انتقال‌های غیرفعال‌شده در به‌روزرسانی بعدی یا هنگام پاک‌سازی (vacuum) هدف پاک خواهند شد\&. برای اعمال فوری این تغییرات،
\fB\-\-now\fR
را ارسال کنید\&.
.sp
در نسخه 257 اضافه شد\&.
.RE
.PP
\fB\-\-no\-ask\-password\fR
.RS 4
عدم درخواست احراز هویت از کاربر برای عملیات دارای اختیارات ویژه\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش یک متن راهنمای کوتاه و خروج\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
نمایش یک رشته کوتاه از نسخه و خروج\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-\-reboot\fR
.RS 4
هنگام استفاده با فرمان
\fBupdate\fR،
پس از اتمام اعمال به‌روزرسانی‌ها، سیستم را بازراه‌اندازی (ری‌بوت) می‌کند\&. اگر هر یک از به‌روزرسانی‌ها با شکست مواجه شود، سیستم ری‌بوت نخواهد شد\&.
.sp
هنگام استفاده با فرمان‌های
\fBenable\fR
یا
\fBdisable\fR
و پرچم
\fB\-\-now\fR،
پس از اتمام بارگیری یا پاک‌سازی، سیستم را بازراه‌اندازی می‌کند\&.
.sp
در نسخه 257 اضافه شد\&.
.RE
.PP
\fB\-\-offline\fR
.RS 4
هنگام استفاده با فرمان
\fBlist\fR،
دریافت فراداده از شبکه را غیرفعال می‌کند\&. این امر باعث می‌شود فرمان
\fBlist\fR
تنها اطلاعاتی را که به صورت محلی در دسترس است برگرداند (یعنی اطلاعات درباره نسخه‌هایی که از قبل روی سیستم نصب شده‌اند)\&.
.sp
در نسخه 257 اضافه شد\&.
.RE
.PP
\fB\-\-now\fR
.RS 4
هنگام استفاده با فرمان
\fBenable\fR،
ویژگی‌های فعال‌شده را بارگیری و نصب می‌کند\&. هنگام استفاده با فرمان
\fBdisable\fR،
تمام منابع بارگیری‌شده توسط ویژگی‌های غیرفعال‌شده را حذف می‌نماید\&.
.sp
در نسخه 257 اضافه شد\&.
.RE
.PP
\fB\-H\fR, \fB\-\-host=\fR
.RS 4
عملیات را از راه دور اجرا می‌کند\&. یک نام میزبان، یا یک نام کاربری و نام میزبان جداشده با
"@"
را برای اتصال مشخص کنید\&. نام میزبان ممکن است به صورت اختیاری با یک درگاه که ssh روی آن گوش می‌دهد و با
":"
جدا شده است، و سپس یک نام کانتینر که با
"/"
جدا شده است پسوندگذاری شود، که مستقیماً به یک کانتینر خاص روی میزبان مشخص‌شده متصل می‌شود\&. این کار از SSH برای گفتگو با نمونه مدیر ماشین راه دور استفاده می‌کند\&. نام‌های کانتینر را می‌توان با
\fBmachinectl \-H \fR\fB\fIHOST\fR\fR
برشمرد\&. نشانی‌های IPv6 را داخل براکت قرار دهید\&.
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
خروجی را به یک صفحه‌بند لوله‌کشی (pipe) نمی‌کند\&.
.RE
.PP
\fB\-\-no\-legend\fR
.RS 4
راهنما را چاپ نمی‌کند، یعنی سربرگ ستون‌ها و پاورقی حاوی نکات را نمایش نمی‌دهد\&.
.RE
.SH "کدهای خروج (EXIT STATUS)"
.PP
در صورت موفقیت 0 و در غیر این صورت یک کد خطای غیرصفر بازگردانده می‌شود\&.
.SH "محیط (ENVIRONMENT)"
.PP
\fI$SYSTEMD_LOG_LEVEL\fR
.RS 4
حداکثر سطح لاگ پیام‌های صادرشده (پیام‌هایی با سطح لاگ بالاتر، یعنی کم‌اهمیت‌تر، متوقف خواهند شد)\&. فهرستی از مقادیر جداشده با کاما را می‌پذیرد\&. یک مقدار می‌تواند یکی از موارد زیر (به ترتیب کاهش اهمیت) باشد:
\fBemerg\fR،
\fBalert\fR،
\fBcrit\fR،
\fBerr\fR،
\fBwarning\fR،
\fBnotice\fR،
\fBinfo\fR،
\fBdebug\fR،
یا یک عدد صحیح در محدوده 0\&...7\&. برای اطلاعات بیشتر به
\fBsyslog\fR(3)
مراجعه کنید\&. هر مقدار می‌تواند به صورت اختیاری با یکی از پیشوندهای
\fBconsole\fR،
\fBsyslog\fR،
\fBkmsg\fR
یا
\fBjournal\fR
به همراه یک دونقطه برای تنظیم حداکثر سطح لاگ برای آن مقصد لاگ خاص همراه شود (به‌عنوان مثال
\fBSYSTEMD_LOG_LEVEL=debug,console:info\fR
مشخص می‌کند که ثبت لاگ در سطح debug انجام شود به جز هنگام ثبت در کنسول که باید در سطح info باشد)\&. توجه داشته باشید که حداکثر سطح لاگ سراسری نسبت به سطوح لاگ برای هر مقصد اولویت دارد\&.
.RE
.PP
\fI$SYSTEMD_LOG_COLOR\fR
.RS 4
یک مقدار بولی\&. اگر درست (true) باشد، پیام‌های نوشته‌شده در tty متناسب با اولویت رنگ‌آمیزی می‌شوند\&.
.sp
این تنظیم تنها زمانی مفید است که پیام‌ها مستقیماً در ترمینال نوشته شوند، زیرا
\fBjournalctl\fR(1)
و سایر ابزارهایی که لاگ‌ها را نمایش می‌دهند پیام‌ها را خودشان بر اساس سطح لاگ رنگ‌آمیزی می‌کنند\&.
.RE
.PP
\fI$SYSTEMD_LOG_TIME\fR
.RS 4
یک مقدار بولی\&. در صورت فعال بودن، پیام‌های لاگ کنسول با یک برچسب زمانی پیشوندگذاری می‌شوند\&.
.sp
این تنظیم تنها زمانی مفید است که پیام‌ها مستقیماً در ترمینال یا یک فایل نوشته شوند، زیرا
\fBjournalctl\fR(1)
و سایر ابزارهایی که لاگ‌ها را نمایش می‌دهند برچسب‌های زمانی را خودشان بر اساس فراداده‌های ورودی پیوست می‌کنند\&.
.RE
.PP
\fI$SYSTEMD_LOG_LOCATION\fR
.RS 4
یک مقدار بولی\&. در صورت فعال بودن، پیام‌ها با یک نام فایل و شماره خط در کد منبع که پیام از آنجا سرچشمه می‌گیرد پیشوندگذاری می‌شوند\&.
.sp
توجه داشته باشید که مکان لاگ اغلب به هر حال به عنوان فراداده به ورودی‌های ژورنال پیوست می‌شود\&. با این وجود، گنجاندن مستقیم آن در متن پیام می‌تواند هنگام اشکال‌زدایی برنامه‌ها سودمند باشد\&.
.RE
.PP
\fI$SYSTEMD_LOG_TID\fR
.RS 4
یک مقدار بولی\&. در صورت فعال بودن، پیام‌ها با شناسه عددی ریسه (TID) فعلی پیشوندگذاری می‌شوند\&.
.sp
توجه داشته باشید که این اطلاعات اغلب به هر حال به عنوان فراداده به ورودی‌های ژورنال پیوست می‌شود\&. با این حال، گنجاندن مستقیم آن در متن پیام می‌تواند هنگام اشکال‌زدایی برنامه‌ها سودمند باشد\&.
.RE
.PP
\fI$SYSTEMD_LOG_TARGET\fR
.RS 4
مقصد پیام‌های لاگ\&. یکی از موارد:
\fBconsole\fR
(ثبت لاگ در tty متصل)،
\fBconsole\-prefixed\fR
(ثبت لاگ در tty متصل اما با پیشوندهای کدگذاری‌کننده سطح لاگ و «facility»، به
\fBsyslog\fR(3)
مراجعه کنید)،
\fBkmsg\fR
(ثبت لاگ در بافر حلقوی لاگ هسته)،
\fBjournal\fR
(ثبت لاگ در ژورنال)،
\fBjournal\-or\-kmsg\fR
(ثبت لاگ در ژورنال در صورت در دسترس بودن، و در غیر این صورت در kmsg)،
\fBauto\fR
(تعیین خودکار مقصد لاگ مناسب، حالت پیش‌فرض)،
\fBnull\fR
(غیرفعال کردن خروجی لاگ)\&.
.RE
.PP
\fI$SYSTEMD_LOG_RATELIMIT_KMSG\fR
.RS 4
تعیین اینکه آیا ارسال به kmsg محدودسازی نرخ شود یا خیر\&. یک مقدار بولی می‌گیرد\&. پیش‌فرض
"true"
است\&. در صورت غیرفعال بودن، systemd پیام‌های نوشته‌شده در kmsg را محدود نمی‌کند\&.
.RE
.PP
\fI$SYSTEMD_PAGER\fR, \fI$PAGER\fR
.RS 4
صفحه‌بندی که هنگام عدم ارسال
\fB\-\-no\-pager\fR
استفاده می‌شود\&. در صورت تنظیم بودن،
\fI$SYSTEMD_PAGER\fR
استفاده می‌شود؛ در غیر این صورت
\fI$PAGER\fR
به کار می‌رود\&. اگر هیچ‌یک از
\fI$SYSTEMD_PAGER\fR
یا
\fI$PAGER\fR
تنظیم نشده باشند، مجموعه‌ای از پیاده‌سازی‌های شناخته‌شده صفحه‌بند به نوبت امتحان می‌شوند، از جمله
\fBless\fR(1)
و
\fBmore\fR(1)،
تا زمانی که یکی پیدا شود\&. اگر هیچ پیاده‌سازی صفحه‌بندی کشف نشود، صفحه‌بندی فراخوانی نخواهد شد\&. تنظیم این متغیرهای محیطی به یک رشته خالی یا مقدار
"cat"
معادل ارسال
\fB\-\-no\-pager\fR
است\&.
.sp
نکته: اگر
\fI$SYSTEMD_PAGERSECURE\fR
تنظیم نشده باشد،
\fI$SYSTEMD_PAGER\fR
و
\fI$PAGER\fR
تنها می‌توانند برای غیرفعال کردن صفحه‌بند (با
"cat"
یا
"")
استفاده شوند و در غیر این صورت نادیده گرفته می‌شوند\&.
.RE
.PP
\fI$SYSTEMD_LESS\fR
.RS 4
بازنویسی گزینه‌های ارسالی به
\fBless\fR
(به‌طور پیش‌فرض
"FRSXMK")\&.
.sp
کاربران ممکن است بخواهند به‌طور خاص دو گزینه را تغییر دهند:
.PP
\fBK\fR
.RS 4
این گزینه به صفحه‌بند دستور می‌دهد با فشرده شدن
Ctrl+C
بلافاصله خارج شود\&. برای اینکه به
\fBless\fR
اجازه دهید خودش
Ctrl+C
را برای بازگشت به خط فرمان صفحه‌بند مدیریت کند، این گزینه را لغو کنید\&.
.sp
اگر مقدار
\fI$SYSTEMD_LESS\fR
شامل
"K"
نباشد و صفحه‌بند فراخوانی‌شده
\fBless\fR
باشد،
Ctrl+C
توسط برنامه اجرایی نادیده گرفته شده و باید توسط صفحه‌بند مدیریت شود\&.
.RE
.PP
\fBX\fR
.RS 4
این گزینه به صفحه‌بند دستور می‌دهد تا رشته‌های مقداردهی اولیه و بازنشانی termcap را به ترمینال ارسال نکند\&. این گزینه به‌طور پیش‌فرض تنظیم شده است تا خروجی دستور حتی پس از خروج از صفحه‌بند در ترمینال قابل مشاهده باقی بماند\&. با این حال، این امر مانع از کارکرد برخی قابلیت‌های صفحه‌بند می‌شود، به‌ویژه خروجی صفحه‌بندی‌شده را نمی‌توان با ماوس پیمایش کرد\&.
.RE
.sp
توجه داشته باشید که تنظیم متغیر محیطی معمولی
\fI$LESS\fR
هیچ تأثیری بر فراخوانی‌های
\fBless\fR
توسط ابزارهای systemd ندارد\&.
.sp
برای توضیحات بیشتر به
\fBless\fR(1)
مراجعه کنید\&.
.RE
.PP
\fI$SYSTEMD_LESSCHARSET\fR
.RS 4
بازنویسی مجموعه نویسه‌های ارسالی به
\fBless\fR
(به‌طور پیش‌فرض
"utf\-8"،
در صورتی که ترمینال فراخوان سازگار با UTF\-8 تشخیص داده شود)\&.
.sp
توجه داشته باشید که تنظیم متغیر محیطی معمولی
\fI$LESSCHARSET\fR
هیچ تأثیری بر فراخوانی‌های
\fBless\fR
توسط ابزارهای systemd ندارد\&.
.RE
.PP
\fI$SYSTEMD_PAGERSECURE\fR
.RS 4
دستورات رایج صفحه‌بند مانند
\fBless\fR(1)،
علاوه بر «صفحه‌بندی» یعنی پیمایش در خروجی، از باز کردن یا نوشتن در فایل‌های دیگر و اجرای دستورات دلخواه شل پشتیبانی می‌کنند\&. هنگامی که دستورات با اختیارات بالا اجرا می‌شوند، برای مثال تحت
\fBsudo\fR(8)
یا
\fBpkexec\fR(1)،
صفحه‌بند به یک مرز امنیتی تبدیل می‌شود\&. باید دقت شود که تنها برنامه‌هایی با عملکرد کاملاً محدود به عنوان صفحه‌بند استفاده شوند، و ویژگی‌های تعاملی ناخواسته مانند باز کردن یا ایجاد فایل‌های جدید یا آغاز زیرپردازش‌ها مجاز نباشند\&. «حالت امن» برای صفحه‌بند را می‌توان همان‌طور که در زیر توضیح داده شده فعال کرد،
\fIاگر صفحه‌بند از آن پشتیبانی کند\fR
(بیشتر صفحه‌بندها به گونه‌ای نوشته نشده‌اند که این موضوع را در نظر بگیرند)\&. توصیه می‌شود هنگام اجازه دادن به کاربران غیرقابل اعتماد برای اجرای دستورات با اختیارات بالا، یا «حالت امن» را صراحتاً فعال کنید یا با استفاده از
\fB\-\-no\-pager\fR
یا
\fIPAGER=cat\fR
صفحه‌بند را کاملاً غیرفعال نمایید\&.
.sp
این گزینه یک آرگومان بولی می‌پذیرد\&. در صورت تنظیم روی true، «حالت امن» صفحه‌بند فعال می‌شود\&. در «حالت امن»، هنگام فراخوانی صفحه‌بند متغیر
\fBLESSSECURE=1\fR
تنظیم خواهد شد که به صفحه‌بند دستور می‌دهد دستوراتی را که فایل‌های جدید باز می‌کنند یا می‌سازند، یا زیرپردازش‌های جدید را آغاز می‌نمایند غیرفعال کند\&. در حال حاضر تنها
\fBless\fR(1)
شناخته شده است که این متغیر را درک کرده و «حالت امن» را پیاده‌سازی می‌نماید\&.
.sp
در صورت تنظیم روی false، هیچ محدودیتی روی صفحه‌بند اعمال نمی‌شود\&. تنظیم
\fISYSTEMD_PAGERSECURE=0\fR
یا حذف نکردن آن از محیط به ارث رسیده ممکن است به کاربر اجازه دهد دستورات دلخواه را فراخوانی کند\&.
.sp
هنگامی که
\fI$SYSTEMD_PAGERSECURE\fR
تنظیم نشده باشد، ابزارهای systemd تلاش می‌کنند به‌طور خودکار تشخیص دهند که آیا «حالت امن» باید فعال شود و آیا صفحه‌بند از آن پشتیبانی می‌کند یا خیر\&. «حالت امن» فعال می‌شود اگر شناسه کاربری مؤثر (UID) با مالک نشست ورود یکسان نباشد، به
\fBgeteuid\fR(2)
و
\fBsd_pid_get_owner_uid\fR(3)
مراجعه کنید، یا هنگام اجرا تحت
\fBsudo\fR(8)
یا ابزارهای مشابه (که
\fI$SUDO_UID\fR
تنظیم شده باشد
\&\s-2\u[1]\d\s+2)\&. در این موارد،
\fISYSTEMD_PAGERSECURE=1\fR
تنظیم خواهد شد و صفحه‌بندهایی که اجرای «حالت امن» توسط آن‌ها شناخته نشده است اصلاً استفاده نخواهند شد\&. توجه داشته باشید که این تشخیص خودکار تنها متداول‌ترین سازوکارهای ارتقای اختیارات را پوشش می‌دهد و برای راحتی کار در نظر گرفته شده است\&. توصیه می‌شود صراحتاً
\fI$SYSTEMD_PAGERSECURE\fR
را تنظیم کنید یا صفحه‌بند را غیرفعال نمایید\&.
.sp
توجه داشته باشید که اگر قرار باشد متغیرهای
\fI$SYSTEMD_PAGER\fR
یا
\fI$PAGER\fR
رعایت شوند، به جز برای غیرفعال کردن صفحه‌بند،
\fI$SYSTEMD_PAGERSECURE\fR
نیز باید تنظیم شده باشد\&.
.RE
.PP
\fI$SYSTEMD_COLORS\fR
.RS 4
یک آرگومان بولی یا یک مقدار ویژه می‌پذیرد\&. به‌طور پیش‌فرض (تنظیم‌نشده)،
\fBsystemd\fR
و ابزارهای مرتبط در صورت امکان از رنگ‌ها در خروجی خود استفاده خواهند کرد\&. اگر
\fI$COLORTERM\fR
روی
"truecolor"
یا
"24bit"
تنظیم شده باشد، رنگ‌های ۲۴ بیتی فعال خواهند شد، در غیر این صورت ۲۵۶ رنگ، مگر اینکه
\fI$NO_COLOR\fR
یا
\fI$TERM\fR
نشان دهد که رنگ‌ها غیرفعال هستند\&.
.PP
\fBtrue\fR
.RS 4
مانند حالت تنظیم‌نشده، به جز اینکه
\fI$NO_COLOR\fR
نادیده گرفته می‌شود\&.
.RE
.PP
\fBfalse\fR
.RS 4
خروجی تک‌رنگ خواهد بود\&.
.RE
.PP
"16", "256", "24bit"
.RS 4
به ترتیب همیشه از ۱۶ رنگ پایه ANSI، ۲۵۶ رنگ، یا رنگ ۲۴ بیتی استفاده می‌کند\&.
.RE
.PP
"auto\-16", "auto\-256", "auto\-24bit"
.RS 4
از تعداد رنگ‌های داده‌شده، متناسب با
\fI$TERM\fR،
و آنچه کنسول به آن متصل است، استفاده می‌کند\&.
.RE
.RE
.PP
\fI$SYSTEMD_URLIFY\fR
.RS 4
مقدار باید یک بولی باشد\&. کنترل می‌کند که آیا پیوندهای قابل‌کلیک در خروجی برای شبیه‌سازهای ترمینالی که از این قابلیت پشتیبانی می‌کنند تولید شود یا خیر\&. این گزینه می‌تواند برای بازنویسی تصمیمی که
\fBsystemd\fR
بر اساس
\fI$TERM\fR
و سایر شرایط می‌گیرد مشخص شود\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
توجه داشته باشید که این مثال‌ها صرفاً برای نمایش هستند و خروجی این فرمان‌ها می‌تواند تغییر کند\&. این فرمان‌ها برای نمایش به کاربر در نظر گرفته شده‌اند\&. اگر خروجی قابل‌خواندن توسط ماشین می‌خواهید، مستقیماً از API دی‌باس
\fBorg.freedesktop.sysupdate1\fR(5)
استفاده کنید\&.
.PP
\fBمثال\ \&۱.\ \&خروجی list\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBupdatectl list\fR
TARGET         VERSION PATH
host           48      sysupdate\&.d
machine:fedora 38      /var/lib/machines/fedora\&.raw
component:shim 15\&.7    sysupdate\&.shim\&.d
$ \fBupdatectl list host\fR
  VERSION STATUS
↻ 50      candidate
  49      available
● 48      current
  47      available
  46      available
  45      available
[\&.\&.\&.]
\(mu 25      available+obsolete
\(mu 24      available+obsolete
\(mu 23      available+obsolete
[\&.\&.\&.]
$ \fBupdatectl list host@49\fR
↻ Version: 50
  State: candidate
  ChangeLog: https://vendor\&.com/os/v50\&.html

TYPE     PATH                                                                   PTUUID                               PTFLAGS SHA256
url\-file http://dl\&.vendor\&.com/os/uki_50                                         \-                                          \- 90f6534282dd720f7a222fa781086990dc9c83e5c7499f085970a8e75e3ac349
url\-file http://dl\&.vendor\&.com/os/usr_50_981a5b84\-a301\-c819\-f681\-3e575fe16f16    981a5b84\-a301\-c819\-f681\-3e575fe16f16       \- c0596ab1095258ec6f16c7c281a50d71c419a9f587c1ef858cfbbb69fb0a16f3
url\-file http://dl\&.vendor\&.com/os/verity_50_2f8d0f3b\-f80a\-6ddc\-a556\-3722bfbb5b79 2f8d0f3b\-f80a\-6ddc\-a556\-3722bfbb5b79       \- e1e90a128e038b3a53455e55d1ca717c743aba31fe6b4b4624109df0243c6338
url\-file http://dl\&.vendor\&.com/os/verity_sig_50                                  \-                                          \- ca3d163bab055381827226140568f3bef7eaac187cebd76878e0b63e9e442356
.fi
.if n \{\
.RE
.\}
.PP
\fBمثال\ \&۲.\ \&بررسی و نصب به‌روزرسانی‌ها\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBupdatectl check\fR
TARGET         UPDATE
host           48 → 50
machine:fedora 38 → 40
$ \fBupdatectl update host machine:fedora@39\fR
[\&.\&.\&.]
✓ host@50
✓ machine:fedora@39
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1),
\fBsystemd-sysupdate\fR(8)
\fBsystemd-sysupdated.service\fR(8)
\fBsysupdate.d\fR(5),
.SH "نکات (NOTES)"
.IP " 1." 4
توصیه می‌شود سایر ابزارها
\fI$SUDO_UID\fR
را در صورت لزوم تنظیم و بررسی کنند، و با آن به عنوان یک رابط مشترک رفتار نمایند\&.