.\" Copyright 2016-2024 Roderick W. Smith (rodsmith@rodsbooks.com)
.\" May be distributed under the GNU Free Documentation License version 1.3 or
.\" any later version
.TH "REFIND-MKDEFAULT" "8" "0.14.2" "Roderick W. Smith" "rEFInd Manual"
.SH "نام (NAME)"
refind-mkdefault \- تنظیم rEFInd به عنوان گزینه پیش‌فرض راه‌اندازی (بوت) EFI
.SH "خلاصه دستور (SYNOPSIS)"
.BI "refind-mkdefault "
[ \-L|\-\-label <name> ]

.SH "توضیحات (DESCRIPTION)"

راه‌اندازی به شیوه EFI معمولاً به ورودی‌های مدیر بوت ذخیره‌شده در NVRAM متکی است، که محل برنامه‌های بوت EFI و ترتیبی را که سفت‌افزار (فریم‌ور) برای اجرای آن‌ها تلاش می‌کند توصیف می‌نمایند. در لینوکس، این ورودی‌ها را می‌توان با ابزار \fIefibootmgr\fR ایجاد کرد، حذف نمود و تغییر داد.

بسیاری از سیستم‌عامل‌ها و بسته‌های لینوکس فرض می‌کنند که خودشان باید فرآیند بوت را کنترل کنند، بنابراین هم ورودی‌های بوت NVRAM برای خود ایجاد می‌کنند و هم این ورودی‌ها را در ابتدای ترتیب بوت قرار می‌دهند. با این حال، اگر قصد دارید rEFInd فرآیند بوت را مدیریت کند، چنین تغییراتی نامطلوب بوده و نیازمند تنظیم مجدد از طریق \fIefibootmgr\fR است. اعمال این تنظیمات دشوار است و می‌تواند برای کاربران غیرمتخصص چالش‌برانگیز باشد.

اسکریپت \fIrefind-mkdefault\fR امور را ساده می‌کند: اجرای این اسکریپت بدون هیچ گزینه‌ای، rEFInd را به عنوان برنامه بوت پیش‌فرض تنظیم می‌کند. جزئیات عملکرد اسکریپت به وضعیت فعلی فهرست ترتیب بوت و ورودی‌های موجود بستگی دارد:

.TP
.B *
اگر ورودی rEFInd از قبل در ترتیب بوت وجود داشته باشد و در ابتدای فهرست باشد، هیچ تغییری اعمال نمی‌شود.

.TP
.B *
اگر ورودی rEFInd در ترتیب بوت وجود داشته باشد اما در ابتدای فهرست نباشد، آن ورودی به جایگاه اول در ترتیب بوت منتقل می‌شود.

.TP
.B *
اگر بیش از یک ورودی rEFInd در ترتیب بوت وجود داشته باشد، \fIrefind-mkdefault\fR ورودی‌ای را که زودتر آمده است به ابتدای فهرست ترتیب بوت منتقل می‌کند.

.TP
.B *
اگر هیچ ورودی rEFInd در ترتیب بوت نباشد اما بتوان یک ورودی بوت rEFInd را در فهرست ورودی‌های \fBBoot####\fR یافت، به ترتیب بوت اضافه شده و در ابتدای فهرست قرار می‌گیرد.

.TP
.B *
اگر چندین ورودی بوت rEFInd وجود داشته باشد اما هیچ‌کدام در ترتیب بوت نباشد، همه ورودی‌ها به ترتیب بوت افزوده می‌شوند، اما اولویت ورودی نخست کنترل‌نشده خواهد بود.

.PP

ورودی rEFInd به عنوان ورودی‌ای تعریف می‌شود که شامل رشته \fBrefind\fR (بدون حساسیت به حروف کوچک و بزرگ) باشد. این رشته می‌تواند در توضیحات یا در نام فایل وجود داشته باشد. رشته مورد استفاده برای شناسایی ورودی rEFInd را می‌توان با گزینه \fI\-\-label\fR (\fI\-L\fR) تغییر داد.

هدف این است که بتوان \fIrefind-mkdefault\fR را پس از بوت از طریق GRUB یا روش‌های دیگر فراخوانی کرد تا rEFInd مجدداً به عنوان برنامه پیش‌فرض بوت بازگردانده شود. همچنین می‌توان آن را در اسکریپت‌های راه‌اندازی یا خاموش‌سازی سیستم قرار داد تا جایگاه پیش‌فرض rEFInd به صورت خودکار بازیابی گردد. از آنجا که اگر rEFInd نخستین ورودی بوت باشد، ترتیب بوت دوباره‌نویسی نمی‌شود، این روش ریسک پایینی دارد.

.SH "گزینه‌ها (OPTIONS)"

.TP
.B \-L | \-\-label \fI<name>\fR
به جای جستجوی رشته \fBrefind\fR در خروجی \fIefibootmgr\fR برای شناسایی rEFInd، رشته \fBname\fR را جستجو می‌کند.

.SH "مقادیر بازگشتی (RETURN VALUES)"

دستور \fIrefind-mkdefault\fR مقادیر زیر را بازمی‌گرداند:

.TP
.B 0
اسکریپت با موفقیت به پایان رسید، که می‌تواند به این معنی باشد که هیچ تغییری لازم نبوده یا فراخوانی \fIefibootmgr\fR کد موفقیت بازگردانده است.

.TP
.B 1
متغیرهای ترتیب بوت EFI در دسترس هستند و ورودی rEFInd پیدا شد، اما فراخوانی \fIefibootmgr\fR کد خطا بازگرداند.

.TP
.B 2
ورودی‌های بوت EFI در دسترس نیستند. این وضعیت معمولاً نشان‌دهنده یک اشکال در EFI یا محتوای به شدت آسیب‌دیده NVRAM است.

.TP
.B 3
هیچ ورودی rEFInd در فهرست گزینه‌های بوت یافت نشد، بنابراین تغییری در فهرست ترتیب بوت ایجاد نشد.

.TP
.B 4
اسکریپت به دلیل مشکلات سیستم‌عامل نتوانست اجرا شود؛ سیستم‌عامل لینوکس نبود، ابزار \fIefibootmgr\fR در دسترس نبود، یا اسکریپت با دسترسی ریشه (\fIroot\fR) اجرا نشد.

.SH "محدودیت‌ها (LIMITATIONS)"

.TP
.B *
دستور \fIrefind-mkdefault\fR هنگام راه‌اندازی در حالت BIOS (از جمله از طریق ماژول پشتیبانی سازگاری یا CSM در رایانه‌های مبتنی بر EFI) کار نمی‌کند. به همین ترتیب، اگر \fIefibootmgr\fR نصب نباشد یا به هر دلیلی اجرا نشود، کار نخواهد کرد.

.TP
.B *
اسکریپت از الگوریتم بسیار ساده‌ای برای تعیین آنچه باید به ابتدای فهرست ترتیب بوت منتقل شود استفاده می‌کند. اگر سیستم دارای ورودی‌های بوت rEFInd تکراری یا غیرکاربردی باشد، یا اگر نام‌گذاری آن‌ها مطابق انتظار نباشد، ممکن است این الگوریتم ناموفق عمل کند. در چنین مواردی پاک‌سازی دستی ورودی‌های بوت با استفاده از \fIefibootmgr\fR ممکن است ضروری باشد.

.SH "نویسندگان (AUTHORS)"
نویسنده اصلی: Roderick W. Smith (rodsmith@rodsbooks.com)

.SH "همچنین ببینید (SEE ALSO)"
.BR mvrefind (8),
.BR mkrlconf (8),
.BR refind-install (8),
.BR refind-sb-healthcheck (8),
.BR efibootmgr (8).

\fIhttps://www.rodsbooks.com/refind\fR

.SH "در دسترس بودن (AVAILABILITY)"
دستور \fBrefind-mkdefault\fR بخشی از بسته \fIrEFInd\fR است و توسط Roderick W. Smith عرضه شده است.