'\" t
.TH "SYSTEMD\-BLESS\-BOOT\&.SERVICE" "8" "" "systemd 261.2" "systemd-bless-boot.service"
.\" -----------------------------------------------------------------
.\" * 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-bless-boot.service, systemd-bless-boot \- علامت‌گذاری بوت جاری به عنوان بوت موفق
.SH "خلاصه دستور (SYNOPSIS)"
.PP
systemd\-bless\-boot\&.service
.PP
/usr/lib/systemd/systemd\-bless\-boot
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsystemd\-bless\-boot\&.service\fR
یک سرویس سیستمی است که فرآیند بوت جاری را به عنوان موفق علامت‌گذاری می‌کند\&. این سرویس به صورت خودکار به تراکنش اولیه کشانده می‌شود هنگامی که
\fBsystemd-bless-boot-generator\fR(8)
تشخیص دهد که شمارش بوت به سبک
\fBsystemd-boot\fR(7)
استفاده شده است\&.
.PP
درونی، این سرویس بر اساس متغیر EFI با نام
\fILoaderBootCountPath\fR
(با شناسه UUID سازنده
\fB4a67b082\-0a4c\-41cf\-b6c7\-440b29bb8c4f\fR)
عمل می‌کند که از بوت‌لودر به سیستم‌عامل منتقل می‌شود\&. این متغیر شامل یک مسیر فایل‌سیستمی (نسبت به پارتیشن سیستمی EFI) از فایل مدخل بوت‌لودر یا فایل تصویر هسته یکپارچه (unified kernel image) سازگار با
\m[blue]\fBUAPI\&.1 Boot Loader Specification\fR\m[]\&\s-2\u[1]\d\s+2
است که برای راه‌اندازی سیستم استفاده شده بود\&.
\fBsystemd\-bless\-boot\&.service\fR
دو شمارنده عددی بوت «تلاش‌های انجام‌شده» (tries done) و «تلاش‌های باقی‌مانده» (tries left) را از نام فایل حذف می‌کند، که این امر به اجراهای بعدی بوت‌لودر نشان می‌دهد که این مدخل حداقل یک بار با موفقیت راه‌اندازی شده است\&. (بنابراین این سرویس در اولین بوت موفقیت‌آمیز، نام فایل مدخل بوت‌لودر یا فایل تصویر هسته یکپارچه را تغییر می‌دهد\&.)
.SH "گزینه‌ها (OPTIONS)"
.PP
فایل اجرایی
/usr/lib/systemd/systemd\-bless\-boot
همچنین می‌تواند از خط فرمان با یکی از آرگومان‌های دستوری زیر فراخوانی شود:
.PP
\fBstatus\fR
.RS 4
وضعیت فعلی فایل مدخل بوت‌لودر یا فایل تصویر هسته یکپارچه نمایش داده می‌شود\&. این دستور بسته به وضعیت و فراخوانی‌های قبلی، یکی از مقادیر
"good",
"bad",
"indeterminate",
"clean",
"dirty"
را خروجی می‌دهد\&. رشته
"indeterminate"
در ابتدا پس از بوت و پیش از آنکه به عنوان "good" یا "bad" علامت‌گذاری شود نمایش داده می‌شود\&. رشته
"good"
پس از آنکه بوت با دستور
\fBgood\fR
در زیر به عنوان "good" علامت‌گذاری شد نمایش می‌یابد، و برعکس رشته "bad" پس از فراخوانی دستور
\fBbad\fR
نشان داده می‌شود\&. رشته
"clean"
زمانی برگردانده می‌شود که شمارش بوت در حال حاضر فعال نباشد (که شامل حالتی نیز می‌شود که مدخل جاری قبلاً به عنوان همواره خوب علامت‌گذاری شده باشد)\&. رشته
"dirty"
زمانی برگردانده می‌شود که سیستم با یک هسته مشخصاً معیوب (یعنی هسته‌ای که شمارنده تلاش‌های باقی‌مانده آن قبلاً به صفر رسیده است) بوت شده باشد\&.
.sp
در صورتی که هیچ آرگومان دستوری مشخص نشود، این دستور به صورت ضمنی در نظر گرفته می‌شود\&.
.sp
افزوده شده در نگارش 240\&.
.RE
.PP
\fBgood\fR
.RS 4
هنگام فراخوانی، فایل مدخل بوت‌لودر یا فایل تصویر هسته یکپارچه جاری به عنوان "good" علامت‌گذاری می‌شود و عملیات تغییر نام فایل که در بالا شرح داده شد را اجرا می‌کند\&. این دستور برای فراخوانی در پایان یک بوت موفق در نظر گرفته شده است\&. واحد
systemd\-bless\-boot\&.service
این دستور را فراخوانی می‌کند\&.
.sp
افزوده شده در نگارش 240\&.
.RE
.PP
\fBbad\fR
.RS 4
هنگام فراخوانی، شمارنده «تلاش‌های باقی‌مانده» (tries left) در نام فایل مدخل بوت‌لودر یا نام فایل تصویر هسته یکپارچه روی صفر تنظیم می‌شود و مدخل بوت‌لودر یا تصویر هسته را به عنوان "bad" علامت‌گذاری می‌کند، تا بوت‌لودر در بوت‌های بعدی دیگر آن را مد نظر قرار ندهد (حداقل تا زمانی که مدخل‌های دیگری در دسترس باشند که هنوز به عنوان "bad" علامت‌گذاری نشده‌اند)\&. این دستور معمولاً اجرا نمی‌شود، اما می‌تواند در صورت تشخیص یک مشکل، برای پایان دادن فوری به منطق شمارش بوت و علامت‌گذاری دائمی مدخل بوت به عنوان خراب استفاده شود\&.
.sp
افزوده شده در نگارش 240\&.
.RE
.PP
\fBindeterminate\fR
.RS 4
این دستور هرگونه علامت‌گذاری فایل مدخل بوت‌لودر یا فایل تصویر هسته یکپارچه جاری به عنوان خوب یا بد را لغو می‌کند\&. این کار با تغییر نام فایل مدخل بوت‌لودر یا فایل تصویر هسته یکپارچه به همان مسیری که در متغیر EFI با نام
\fILoaderBootCountPath\fR
کدگذاری شده است انجام می‌شود\&. توجه داشته باشید که اگر هسته جاری با فعال بودن شمارش بوت راه‌اندازی نشده باشد (یعنی اگر متغیر EFI تنظیم نشده باشد)، این عملیات با شکست مواجه خواهد شد\&. اگر شمارنده بوت قبلاً در یک بوت قبلی به صفر تلاش باقی‌مانده رسیده باشد نیز این عملیات ناموفق خواهد بود: هنگامی که یک مدخل به عنوان
\fBbad\fR
علامت‌گذاری شود، فقط می‌توان مجدداً آن را به
\fBgood\fR
بازنشانی کرد، نه به
\fBindeterminate\fR\&.
.sp
افزوده شده در نگارش 240\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن راهنمای کوتاه چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
اطلاعات نگارش برنامه را چاپ کرده و خارج می‌شود\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsystemd-boot\fR(7), \fBsystemd.special\fR(7)
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
UAPI.1 Boot Loader Specification
.RS 4
\%https://uapi-group.org/specifications/specs/boot_loader_specification
.RE