'\" t
.TH "SYSTEMD\-SYSUPDATE" "8" "" "systemd 261.2" "systemd-sysupdate"
.\" -----------------------------------------------------------------
.\" * 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-sysupdate \- ابزار به‌روزرسانی اتمیک سیستم، سیستم‌عامل و افزونه‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsystemd\-sysupdate\fR\ 'u
\fBsystemd\-sysupdate\fR [OPTIONS...]
.PP
systemd\-sysupdate\&.service
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsystemd\-sysupdate\fR
سیستم‌عامل میزبان، ایمیج‌های کانتینر، ایمیج‌های سرویس قابل‌حمل (portable service) یا سایر منابع را بر اساس فایل‌های پیکربندی انتقال شرح‌داده‌شده در
\fBsysupdate.d\fR(5)\&
به‌صورت اتمیک به‌روزرسانی می‌کند\&.
.PP
این ابزار طرح‌های به‌روزرسانی مبتنی بر فایل، دایرکتوری یا پارتیشن را پیاده‌سازی می‌کند و از چندین نسخه نصب‌شده موازی منابع خاص در قالب A/B (یا حتی: A/B/C، A/B/C/D و غیره) پشتیبانی می‌نماید\&. به‌روزرسانی A/B به این معنی است که هنگامی که یک نسخه از منبع در حال حاضر استفاده می‌شود، نسخه بعدی می‌تواند در مکانی کاملاً مجزا و مستقل از نسخه اول دانلود، بازگشایی و آماده شود و \(em پس از تکمیل \(em فعال گردد؛ با جابجایی نقش‌ها به‌طوری که نسخه جدید به نسخه مورد استفاده تبدیل شده و نسخه قبلاً استفاده‌شده به نسخه‌ای تبدیل می‌شود که در به‌روزرسانی بعدی جایگزین خواهد شد، و به همین ترتیب ادامه می‌یابد\&. منابعی که باید به‌روزرسانی شوند در فایل‌های انتقال تعریف می‌شوند، یک فایل برای هر منبعی که قرار است به‌روز شود\&. برای مثال، منابعی که ممکن است با این ابزار به‌روزرسانی شوند می‌توانند شامل: یک پارتیشن سیستم‌فایل ریشه (root)، یک پارتیشن متناظر Verity به همراه یک ایمیج هسته (kernel) باشند\&. ترکیب این سه مورد یک به‌روزرسانی کامل سیستم‌عامل در نظر گرفته می‌شود\&.
.PP
این ابزار پارتیشن‌ها، فایل‌ها یا درخت‌های دایرکتوری را همیشه به‌صورت کامل به‌روزرسانی می‌کند، و حداقل با دو نسخه از هر یک از این منابع کار می‌کند: نسخه
\fIcurrent\fR
(فعلی)، به علاوه نسخه
\fInext\fR
(بعدی): نسخه‌ای که در حال به‌روزرسانی به آن است و در ابتدا هم‌زمان با نوشته‌شدن داده‌های دانلودشده درون آن ناقص است؛ به علاوه در صورت تمایل نسخه‌های بیشتر\&. به محض اینکه دانلود یک نسخه جدیدتر کامل شود، آن نسخه به نسخه فعلی تبدیل شده و نسخه‌ای که پیش‌تر فعلی تلقی می‌شد را برای حذف/جایگزینی/به‌روزرسانی آزاد می‌سازد\&.
.PP
هنگام نصب نسخه‌های جدید، این ابزار نسخه جدید را مستقیماً دانلود، از حالت فشرده خارج، بازگشایی و در مقصد می‌نویسد\&. این کار به شیوه‌ای مقاوم انجام می‌شود تا بتوان یک دانلود ناقص را در فراخوانی بعدی تشخیص داد و پیش از آغاز تلاشی جدید، آن را پاکسازی کرد\&.
.PP
توجه داشته باشید که هنگام نوشتن به‌روزرسانی‌ها روی یک پارتیشن، پارتیشن باید از قبل وجود داشته باشد، زیرا
\fBsystemd\-sysupdate\fR
پارتیشن‌های جدید را به‌طور خودکار ایجاد نمی‌کند\&. از ابزاری مانند
\fBsystemd-repart\fR(8)
استفاده کنید تا در زمان بوت، پارتیشن‌های اضافی را برای استفاده با
\fBsystemd\-sysupdate\fR
به‌طور خودکار ایجاد کند\&.
.PP
این ابزار هم می‌تواند روی سیستم‌عامل در حال اجرا برای به‌روزرسانی سیستم‌عامل در وضعیت «آنلاین» از درون خود سیستم استفاده شود، و هم روی ایمیج‌های دیسک «آفلاین» برای به‌روزرسانی آن‌ها از خارج بر اساس فایل‌های انتقال تعبیه‌شده در ایمیج‌های دیسک به کار رود\&. برای مورد دوم، به
\fB\-\-image=\fR
در زیر مراجعه کنید\&. مورد دوم به‌ویژه برای به‌روزرسانی ایمیج‌های کانتینر یا ایمیج‌های سرویس قابل‌حمل کاربردی است\&.
.PP
سرویس سیستمی
systemd\-sysupdate\&.service
سیستم‌عامل میزبان را بر اساس فایل‌های انتقال نصب‌شده به‌طور خودکار به‌روزرسانی می‌کند\&. این سرویس در فواصل زمانی منظم از طریق
systemd\-sysupdate\&.timer
فعال می‌شود\&. سرویس
systemd\-sysupdate\-reboot\&.service
پس از نصب یک نسخه جدید، سیستم را به‌طور خودکار بازراه‌اندازی (reboot) می‌کند\&. این سرویس از طریق
systemd\-sysupdate\-reboot\&.timer
راه‌اندازی می‌گردد\&. این دو سرویس از یکدیگر مجزا هستند زیرا معمولاً توصیه می‌شود که به‌روزرسانی‌ها به‌طور منظم در زمان بالا بودن سیستم دانلود شوند، اما راه‌اندازی مجدد تا زمان مناسب (یعنی معمولاً در شب) به تعویق بیفتد\&. این دو مجموعه از واحدهای سرویس/تایمر را می‌توان به‌طور جداگانه فعال کرد\&.
.PP
برای جزئیات بیشتر درباره فایل‌های انتقال و مشاهده مثال‌ها به
\fBsysupdate.d\fR(5)\&
مراجعه کنید\&.
.SH "دستورات (COMMANDS)"
.PP
دستورات زیر پشتیبانی می‌شوند:
.PP
\fBlist\fR [\fIVERSION\fR]
.RS 4
اگر بدون آرگومان فراخوانی شود، نسخه‌های قابل دانلود و نسخه‌های نصب‌شده را برمی‌شمارد و یک جدول خلاصه با نسخه‌های کشف‌شده و ویژگی‌های آن‌ها، از جمله اینکه آیا نسخه کاندید جدیدتری برای به‌روزرسانی وجود دارد یا خیر، نمایش می‌دهد\&. اگر یک آرگومان نسخه مشخص شود، جزئیات مربوط به آن نسخه خاص، شامل فایل‌های جداگانه‌ای که باید برای دریافت نسخه انتقال یابند را نمایش می‌دهد\&.
.sp
اگر هیچ دستوری به‌صراحت مشخص نشود، این دستور به طور پیش‌فرض در نظر گرفته می‌شود\&.
.sp
افزوده‌شده در نسخه 251\&.
.RE
.PP
\fBfeatures\fR [\fIFEATURE\fR]
.RS 4
اگر بدون آرگومان فراخوانی شود، ویژگی‌های اختیاری را شمارش کرده و یک جدول خلاصه نمایش می‌دهد، شامل اینکه کدام ویژگی‌ها فعال یا غیرفعال هستند\&. اگر یک آرگومان ویژگی مشخص شود، جزئیات مربوط به ویژگی خاص، از جمله مواردی که توسط این ویژگی کنترل می‌شوند را نمایش می‌دهد\&.
.sp
افزوده‌شده در نسخه 257\&.
.RE
.PP
\fBcheck\-new\fR
.RS 4
بررسی می‌کند که آیا نسخه جدیدی در دسترس است یا خیر\&. این دستور در داخل، نسخه‌های قابل دانلود و نصب‌شده را برمی‌شمارد و اگر نسخه جدیدی برای به‌روزرسانی وجود داشته باشد وضعیت خروج 0 و در غیر این صورت مقداری غیرصفر برمی‌گرداند\&. اگر نسخه جدیدی برای به‌روزرسانی وجود داشته باشد، شناسه نسخه آن در خروجی استاندارد نوشته می‌شود\&.
.sp
افزوده‌شده در نسخه 251\&.
.RE
.PP
\fBupdate\fR [\-\-offline] [\fIVERSION\fR]
.RS 4
نسخه مشخص‌شده را نصب می‌کند (به آن به‌روزرسانی می‌کند)، یا اگر هیچ نسخه‌ای مشخص نشده باشد به جدیدترین نسخه موجود به‌روزرسانی می‌نماید\&. اگر نسخه از قبل نصب شده باشد یا نسخه جدیدتری در دسترس نباشد، هیچ عملیاتی انجام نمی‌شود\&.
.sp
اگر
\fB\-\-offline\fR
مشخص شده باشد، به‌روزرسانی باید از قبل با استفاده از
\fBacquire\fR
دریافت شده باشد و در این صورت، این نسخه از پیش دریافت‌شده نسخه‌ای خواهد بود که سیستم به آن به‌روزرسانی می‌شود\&.
.sp
افزوده‌شده در نسخه 251\&.
.RE
.PP
\fBacquire\fR [\fIVERSION\fR]
.RS 4
نسخه مشخص‌شده را برای نصب آماده و دریافت (دانلود) می‌کند\&. اگر هیچ نسخه‌ای مشخص نشود، جدیدترین نسخه موجود دریافت می‌شود\&. اگر نسخه از قبل نصب شده باشد یا نسخه جدیدتری موجود نباشد، هیچ عملیاتی انجام نمی‌شود\&.
.sp
اگر نسخه جدیدی برای نصب/به‌روزرسانی یافت شود، نسخه‌های قدیمی نصب‌شده حذف می‌شوند تا زمانی که حداقل یک نسخه جدید بتواند نصب شود، همان‌طور که از طریق
\fIInstanceMax=\fR
در
\fBsysupdate.d\fR(5)
یا از طریق اسلات‌های پارتیشن موجود از نوع مناسب پیکربندی شده است\&. این عملیات ضمنی را می‌توان به‌صورت صریح نیز از طریق دستور
\fBvacuum\fR
که در زیر توضیح داده شده است فراخوانی کرد\&.
.sp
افزوده‌شده در نسخه 260\&.
.RE
.PP
\fBvacuum\fR
.RS 4
نسخه‌های قدیمی نصب‌شده را حذف می‌کند تا زمانی که محدودیت‌های پیکربندی‌شده از طریق
\fIInstanceMax=\fR
در
\fBsysupdate.d\fR(5)
مجدداً برآورده شوند\&. به طور معمول، نیازی به فراخوانی صریح این دستور نیست، زیرا هر زمان که به‌روزرسانی جدیدی آغاز شود، به طور ضمنی فراخوانی می‌گردد\&.
.sp
افزوده‌شده در نسخه 251\&.
.RE
.PP
\fBpending\fR
.RS 4
بررسی می‌کند که آیا نسخه‌ای جدیدتر از سیستم‌عامل نسبت به نسخه در حال اجرا نصب شده است یا خیر\&. در صورت مثبت بودن مقدار صفر و در غیر این صورت مقداری غیرصفر برمی‌گرداند\&. این دستور شناسه جدیدترین نسخه نصب‌شده را با نسخه ایمیج سیستم‌عامل که توسط فیلد
\fIIMAGE_VERSION=\fR
در
/etc/os\-release
گزارش شده مقایسه می‌کند\&. اگر اولی جدیدتر از دومی باشد، یک به‌روزرسانی ظاهراً کامل شده اما هنوز فعال (یعنی سیستم با آن بوت) نشده است\&.
.sp
افزوده‌شده در نسخه 251\&.
.RE
.PP
\fBreboot\fR
.RS 4
مشابه دستور
\fBpending\fR
است اما در صورتی که نسخه‌ای جدیدتر از سیستم‌عامل نسبت به نسخه در حال اجرا نصب شده باشد، بلافاصله سیستم را ریبوت می‌کند\&. این عملیات می‌تواند به طور ضمنی همراه با دستور
\fBupdate\fR
پس از یک به‌روزرسانی تکمیل‌شده از طریق سوییچ
\fB\-\-reboot\fR
(به زیر مراجعه کنید) انجام شود\&. اگر هیچ به‌روزرسانی نصب نشده باشد (و بنابراین سیستم ریبوت نشده باشد)، این دستور هیچ عملیاتی انجام نمی‌دهد (و موفقیت برمی‌گرداند)\&.
.sp
افزوده‌شده در نسخه 251\&.
.RE
.PP
\fBcomponents\fR
.RS 4
مؤلفه‌هایی که می‌توانند به‌روزرسانی شوند را فهرست می‌کند\&. این دستور دایرکتوری‌های
/etc/sysupdate\&.*\&.d/،
/run/sysupdate\&.*\&.d/
و
/usr/lib/sysupdate\&.*\&.d/
که حاوی فایل‌های انتقال هستند را برمی‌شمارد\&. این دستور برای فهرست کردن پارامترهای ممکن برای
\fB\-\-component=\fR
(به زیر مراجعه کنید) مفید است\&.
.sp
افزوده‌شده در نسخه 251\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن راهنمای کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
یک رشته نسخه کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-\-component=\fR, \fB\-C\fR
.RS 4
مؤلفه مورد نظر برای به‌روزرسانی را انتخاب می‌کند\&. نام مؤلفه را به عنوان آرگومان می‌گیرد\&. این گزینه منطق جستجو برای فایل‌های انتقال را اندکی تغییر می‌دهد\&. اگر از این سوییچ استفاده نشود، فایل‌های انتقال از مسیرهای
/etc/sysupdate\&.d/*\&.conf،
/run/sysupdate\&.d/*\&.conf
و
/usr/lib/sysupdate\&.d/*\&.conf
بارگذاری می‌شوند\&. اگر از این سوییچ استفاده شود، نام مؤلفه مشخص‌شده برای تغییر دادن دایرکتوری‌های مورد جستجو به
/etc/sysupdate\&.\fIcomponent\fR\&.d/*\&.conf،
/run/sysupdate\&.\fIcomponent\fR\&.d/*\&.conf
و
/usr/lib/sysupdate\&.\fIcomponent\fR\&.d/*\&.conf
استفاده می‌شود، که هر بار رشته
\fIcomponent\fR
با نام مؤلفه مشخص‌شده جایگزین می‌گردد\&.
.sp
از دستور
\fBcomponents\fR
برای فهرست کردن مؤلفه‌های موجود جهت به‌روزرسانی استفاده کنید\&. این دستور دایرکتوری‌های منطبق با این قاعده نام‌گذاری را برمی‌شمارد\&.
.sp
مؤلفه‌ها ممکن است برای تعریف یک مجموعه جداگانه از فایل‌های انتقال برای بخش‌های مختلف سیستم‌عامل که باید به‌طور جداگانه به‌روزرسانی شوند به کار روند\&. از این مفهوم برای منابعی که باید همیشه به‌طور هم‌زمان و هماهنگ به‌روزرسانی شوند استفاده نکنید\&. برای این موارد، به‌سادگی چند فایل انتقال را در همان دایرکتوری
sysupdate\&.d/
تعریف کنید\&.
.sp
این گزینه نباید با
\fB\-\-definitions=\fR
ترکیب شود\&.
.sp
افزوده‌شده در نسخه 251\&.
.RE
.PP
\fB\-\-definitions=\fR
.RS 4
مسیری به یک دایرکتوری\&. در صورت مشخص شدن، فایل‌های انتقال
*\&.conf
به جای
/usr/lib/sysupdate\&.d/*\&.conf،
/etc/sysupdate\&.d/*\&.conf
و
/run/sysupdate\&.d/*\&.conf
از این دایرکتوری خوانده می‌شوند\&.
.sp
این گزینه نباید با
\fB\-\-component=\fR
ترکیب شود\&.
.sp
افزوده‌شده در نسخه 251\&.
.RE
.PP
\fB\-\-root=\fR
.RS 4
مسیری به یک دایرکتوری را می‌گیرد تا هنگام جستجو برای فایل‌های
sysupdate\&.d/*\&.conf
به عنوان سیستم‌فایل ریشه (root) استفاده شود\&.
.sp
افزوده‌شده در نسخه 251\&.
.RE
.PP
\fB\-\-image=\fR
.RS 4
مسیری به یک فایل ایمیج دیسک یا دستگاه را برای سوار کردن (mount) و استفاده به روشی مشابه با
\fB\-\-root=\fR
می‌گیرد (به بالا مراجعه کنید)\&. اگر از این گزینه استفاده شود و منابع پارتیشن به‌روزرسانی شوند، این کار درون ایمیج دیسک مشخص‌شده انجام می‌شود\&.
.sp
افزوده‌شده در نسخه 251\&.
.RE
.PP
\fB\-\-image\-policy=\fR\fB\fIpolicy\fR\fR
.RS 4
یک رشته خط‌مشی ایمیج را به عنوان آرگومان طبق
\fBsystemd.image-policy\fR(7)
می‌پذیرد\&. این خط‌مشی هنگام کار روی ایمیج دیسک مشخص‌شده از طریق
\fB\-\-image=\fR
اعمال می‌شود (به بالا مراجعه کنید)\&. در صورت عدم تعیین، به خط‌مشی
"*"
پیش‌فرض می‌شود، یعنی همه سیستم‌فایل‌های شناخته‌شده در ایمیج استفاده می‌شوند\&.
.RE
.PP
\fB\-\-instances\-max=\fR, \fB\-m\fR
.RS 4
یک عدد صحیح ده‌دهی بزرگتر یا مساوی ۲ هنگام به‌روزرسانی یا ۱ هنگام جاروب (vacuum) می‌گیرد\&. کنترل می‌کند که در هر زمان چند نسخه نگهداری شود\&. این گزینه ممکن است درون فایل‌های انتقال نیز از طریق تنظیم
\fIInstancesMax=\fR
پیکربندی شود؛ برای جزئیات به
\fBsysupdate.d\fR(5)
مراجعه کنید\&.
.sp
افزوده‌شده در نسخه 251\&.
.RE
.PP
\fB\-\-sync=\fR
.RS 4
یک آرگومان بولی می‌گیرد و پیش‌فرض آن yes است\&. این گزینه می‌تواند برای مشخص کردن اینکه آیا نسخه‌های منبع به‌روزرسانی‌شده جدید در زمان مناسب (یعنی پس از اتمام دانلود، قبل از نهایی شدن و مجدداً پس از نهایی شدن) روی دیسک همگام‌سازی (sync) شوند یا خیر، استفاده شود\&. این گزینه را نباید خاموش کرد، مگر برای بهبود کارایی زمان اجرا در محیط‌های آزمایشی\&.
.sp
افزوده‌شده در نسخه 251\&.
.RE
.PP
\fB\-\-verify=\fR
.RS 4
یک آرگومان بولی می‌گیرد و پیش‌فرض آن yes است\&. کنترل می‌کند که آیا دانلودها از نظر رمزنگاری اعتبارسنجی شوند یا خیر\&. این گزینه را خاموش نکنید، مگر در محیط‌های آزمایشی\&.
.sp
افزوده‌شده در نسخه 251\&.
.RE
.PP
\fB\-\-reboot\fR
.RS 4
هنگامی که در ترکیب با دستورهای
\fBupdate\fR
استفاده شود و نسخه جدیدی نصب گردد، بلافاصله پس از آن سیستم را به طور خودکار بازراه‌اندازی (reboot) می‌کند\&.
.sp
افزوده‌شده در نسخه 251\&.
.RE
.PP
\fB\-\-offline\fR
.RS 4
از دریافت متادیتا از شبکه (یعنی
SHA256SUMS)
جلوگیری می‌کند\&. این گزینه بیشترین کاربرد را در ترکیب با دستور
\fBlist\fR
برای پرس‌وجوی نسخه‌های نصب‌شده به صورت محلی دارد\&.
.sp
اگر در ترکیب با دستور
\fBupdate\fR
استفاده شود، به به‌روزرسانی‌ها اجازه می‌دهد از قبل دانلود شده (با استفاده از
\fBacquire\fR)
و بعداً نصب شوند\&.
.sp
افزوده‌شده در نسخه 257\&.
.RE
.PP
\fB\-\-transfer\-source=\fR
.RS 4
مسیری را به عنوان آرگومان خود می‌گیرد\&. در صورت مشخص شدن، تمام منابع انتقال پیکربندی‌شده با
\fIPathRelativeTo=explicit\fR
نسبت به مسیر مشخص‌شده تفسیر خواهند شد\&.
.sp
افزوده‌شده در نسخه 257\&.
.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
.SH "وضعیت خروج (EXIT STATUS)"
.PP
در صورت موفقیت 0 بازگردانده می‌شود، در غیر این صورت یک کد خطای غیرصفر برگردانده خواهد شد\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsysupdate.d\fR(5), \fBsystemd-sysupdated.service\fR(8), \fBsystemd-repart\fR(8)