عمومی (GENERAL)

GRUB_BTRFS_DISABLE

در صورت تنظیم روی true، ابزار grub-btrfs غیرفعال می‌شود.

—

پیش‌فرض: “false”

—

مثال: GRUB_BTRFS_DISABLE="true"

GRUB_BTRFS_TITLE_FORMAT

ورودی‌های زیرمنوی اسنپ‌شات در Grub بر اساس این خط اضافه می‌شوند. تغییر ترتیب فیلدها امکان‌پذیر است.

—

پیش‌فرض: (“date” “snapshot” “type” “description”)

—

مثال: GRUB_BTRFS_TITLE_FORMAT=("date" "snapshot" "type" "description")

GRUB_BTRFS_LIMIT

حداکثر تعداد اسنپ‌شات‌ها در زیرمنوی اسنپ‌شات‌های GRUB.

—

پیش‌فرض: “50”

—

مثال: GRUB_BTRFS_LIMIT="50"

GRUB_BTRFS_SUBVOLUME_SORT

مرتب‌سازی زیرحجم‌های پیداشده بر اساس «ogeneration» یا «generation» یا «path» یا «rootid».

—

بخش مرتب‌سازی را در btrfs-subvolume(8) ببینید.

مقدار «-rootid» به معنی فهرست کردن اسنپ‌شات‌ها از موارد جدیدتر است.

—

پیش‌فرض: “-rootid”

—

مثال: GRUB_BTRFS_SUBVOLUME_SORT="+ogen,-gen,path,rootid"

GRUB_BTRFS_SHOW_SNAPSHOTS_FOUND

نمایش اسنپ‌شات‌های یافت‌شده در حین اجرای «grub-mkconfig».

—

پیش‌فرض: “true”

—

مثال: GRUB_BTRFS_SHOW_SNAPSHOTS_FOUND="false"

GRUB_BTRFS_ROOTFLAGS

گزینه‌های اتصال (mount options) جداشده با کاما برای استفاده هنگام راه‌اندازی (بوت) یک اسنپ‌شات. می‌توان آن‌ها را در اینجا و همچنین در خط «/» درون فایل‌های «/etc/fstab» مربوط به هر اسنپ‌شات تعریف کرد. گزینه‌های اتصال یافت‌شده در هر دو مکان ترکیب می‌شوند و این متغیر نسبت به مدخل‌های fstab اولویت دارد. توجه: هرگز «...=subvol» یا «...=subvolid» را در اینجا قرار ندهید.

—

پیش‌فرض: “”

—

مثال: GRUB_BTRFS_ROOTFLAGS="space_cache,commit=10,norecovery"

GRUB_BTRFS_OVERRIDE_BOOT_PARTITION_DETECTION

به‌طور پیش‌فرض «grub-btrfs» پارتیشن بوت شما را چه در ریشه سیستم قرار داشته باشد، چه روی یک پارتیشن مجزا و چه در یک زیرحجم، به‌طور خودکار تشخیص می‌دهد. اگر پارتیشن بوت شما به عنوان پارتیشن مجزا تشخیص داده نشد، مقدار آن را به «true» تغییر دهید.

—

پیش‌فرض: “false”

—

مثال: GRUB_BTRFS_OVERRIDE_BOOT_PARTITION_DETECTION="true"

GRUB_BTRFS_ENABLE_CRYPTODISK

فعال‌سازی راه‌اندازی (بوت) از روی اسنپ‌شات‌های ذخیره‌شده روی دستگاه‌های رمزنگاری‌شده با LUKS.

—

پیش‌فرض: “false”

—

مثال: GRUB_BTRFS_ENABLE_CRYPTODISK="true"

هسته‌های سفارشی (CUSTOM KERNELS)

GRUB_BTRFS_NKERNEL / GRUB_BTRFS_NINIT / GRUB_BTRFS_CUSTOM_MICROCODE

به‌طور پیش‌فرض، «grub-btrfs» اکثر هسته‌ها، initramfs و ریزکدهای موجود را به‌طور خودکار تشخیص می‌دهد. هسته‌ها، initramfs و ریزکدهای سفارشی که شناسایی نمی‌شوند را می‌توان در این متغیرها اضافه کرد.

—

پیش‌فرض: (“”)

—

مثال: GRUB_BTRFS_NKERNEL=("kernel-5.19.4-custom" "vmlinux-5.19.4-custom") GRUB_BTRFS_NINIT=("initramfs-5.19.4-custom.img" "initrd-5.19.4-custom.img" "otherinit-5.19.4-custom.gz") GRUB_BTRFS_CUSTOM_MICROCODE=("custom-ucode.img" "custom-uc.img "custom_ucode.cpio")

GRUB_BTRFS_SNAPSHOT_KERNEL_PARAMETERS

پارامترهای خط فرمان اضافی هسته که باید هنگام راه‌اندازی (بوت) یک اسنپ‌شات به هسته ارسال شوند. برای توزیع‌های مبتنی بر dracut، این متغیر می‌تواند جهت ارسال «rd.live.overlay.overlayfs=1» یا «rd.live.overlay.readonly=1» به هسته برای راه‌اندازی اسنپ‌شات‌های فقط‌خواندنی مفید باشد.

—

پیش‌فرض: “”

—

مثال: GRUB_BTRFS_SNAPSHOT_KERNEL_PARAMETERS="rd.live.overlay.overlayfs=1"

فیلتر کردن اسنپ‌شات‌ها (SNAPSHOT FILTERING)

GRUB_BTRFS_IGNORE_SPECIFIC_PATH

نادیده گرفتن مسیری مشخص در حین اجرای «grub-mkconfig». فقط مسیرهای کاملاً یکسان نادیده گرفته می‌شوند. برای مثال: اگر «مسیر مشخص» برابر با @ باشد، فقط اسنپ‌شات «@» نادیده گرفته خواهد شد.

—

پیش‌فرض: (“@”)

—

مثال: GRUB_BTRFS_IGNORE_SPECIFIC_PATH=("@home")

GRUB_BTRFS_IGNORE_PREFIX_PATH

نادیده گرفتن پیشوند مسیر در حین اجرای «grub-mkconfig». هر مسیری که با رشته مشخص‌شده آغاز شود نادیده گرفته خواهد شد. برای مثال: اگر «پیشوند مسیر» برابر با @ باشد، تمامی اسنپ‌شات‌هایی که با «.../@» آغاز می‌شوند نادیده گرفته خواهند شد.

—

پیش‌فرض: (“var/lib/docker” “@var/lib/docker” “@/var/lib/docker”)

—

مثال: GRUB_BTRFS_IGNORE_PREFIX_PATH=("var/lib/docker" "@var/lib/docker" "@/var/lib/docker")

GRUB_BTRFS_IGNORE_SNAPSHOT_TYPE

نادیده گرفتن نوع/برچسب خاصی از اسنپ‌شات در حین اجرای «grub-mkconfig». برای snapper: نوع = single, pre, post. برای Timeshift: برچسب = boot, ondemand, hourly, daily, weekly, monthly.

—

پیش‌فرض: (“”)

—

مثال: GRUB_BTRFS_IGNORE_SNAPSHOT_TYPE=("ondemand")

GRUB_BTRFS_IGNORE_SNAPSHOT_DESCRIPTION

نادیده گرفتن توضیحی مشخص از اسنپ‌شات در حین اجرای «grub-mkconfig».

—

پیش‌فرض: (“”)

—

مثال: GRUB_BTRFS_IGNORE_SNAPSHOT_DESCRIPTION=("timeline")

تنظیمات وابسته به توزیع (DISTRIBUTION DEPENDENT SETTINGS)

GRUB_BTRFS_BOOT_DIRNAME

محل قرارگیری هسته‌ها/initramfs/ریزکدها. توسط «grub-btrfs» برای تشخیص پارتیشن بوت و محل هسته‌ها، initramfs و ریزکدها استفاده می‌شود.

—

پیش‌فرض: “/boot”

—

مثال: GRUB_BTRFS_BOOT_DIRNAME="/"

GRUB_BTRFS_GRUB_DIRNAME

محل پوشه حاوی فایل «grub.cfg». در برخی سیستم‌ها ممکن است grub2 باشد. برای مثال، در فدورا با EFI: «/boot/efi/EFI/fedora»

—

پیش‌فرض: “/boot/grub”

—

مثال: GRUB_BTRFS_GRUB_DIRNAME="/boot/grub2"

GRUB_BTRFS_GBTRFS_DIRNAME

محلی که grub-btrfs.cfg باید در آن ذخیره شود. برخی توزیع‌ها (مانند OpenSuSE) این فایل‌ها را به جای boot در دایرکتوری اسنپ‌شات ذخیره می‌کنند. توجه داشته باشید که این دایرکتوری باید در زمان راه‌اندازی سیستم برای grub در دسترس باشد.

—

پیش‌فرض: $GRUB_BTRFS_GRUB_DIRNAME

—

مثال: GRUB_BTRFS_GBTRFS_DIRNAME="/.snapshots"

GRUB_BTRFS_GBTRFS_SEARCH_DIRNAME

محل دایرکتوری‌ای که Grub در آن به دنبال فایل grub-btrfs.cfg می‌گردد. برخی توزیع‌ها (مانند OpenSuSE) این فایل‌ها را به جای boot در دایرکتوری اسنپ‌شات ذخیره می‌کنند. توجه داشته باشید که این دایرکتوری باید در زمان راه‌اندازی سیستم برای grub در دسترس باشد.

—

پیش‌فرض: “\${prefix}” (این یک متغیر grub است که به محل نصب grub مانند /boot/grub یا /boot/efi/grub اشاره دارد)

—

نکته: در صورت استفاده از متغیرهای grub در اینجا مانند ${prefix}، آن‌ها باید با درج یک علامت \ پیش از $ اسکیپ شوند.

—

مثال: GRUB_BTRFS_GBTRFS_SEARCH_DIRNAME="\${prefix}"

GRUB_BTRFS_MKCONFIG

نام/مسیر دستور جهت تولید منوی grub، استفاده‌شده توسط «grub-btrfs.service». ممکن است در برخی سیستم‌ها (مانند فدورا) ’grub2-mkconfig’ باشد. مسیرهای پیش‌فرض عبارتند از: /sbin:/bin:/usr/sbin:/usr/bin ؛ اگر مسیر شما وجود ندارد، آن را در پروژه بالادستی گزارش دهید. می‌توانید تنها از نام دستور یا مسیر کامل استفاده کنید.

—

پیش‌فرض: grub-mkconfig

—

مثال: GRUB_BTRFS_MKCONFIG=/sbin/grub2-mkconfig

GRUB_BTRFS_SCRIPT_CHECK

نام دستور grub-script-check که توسط «grub-btrfs» استفاده می‌شود. ممکن است در برخی سیستم‌ها (مانند فدورا) ’grub2-script-check’ باشد.

—

پیش‌فرض: grub-script-check

—

مثال: GRUB_BTRFS_SCRIPT_CHECK=grub2-script-check

GRUB_BTRFS_MKCONFIG_LIB

مسیر فایل grub-mkconfiglib که توسط «grub-btrfs» استفاده می‌شود. ممکن است در برخی سیستم‌ها (مانند OpenSUSE) ’/usr/share/grub2/grub-mkconfiglib’ باشد.

—

پیش‌فرض: /usr/share/grub/grub-mkconfiglib

—

مثال: GRUB_BTRFS_MKCONFIG_LIB=/usr/share/grub2/grub-mkconfig_lib

امنیت (SECURITY)

GRUB_BTRFS_PROTECTION_AUTHORIZED_USERS

مدیریت محافظت با گذرواژه برای زیرمنو و اسنپ‌شات‌ها. به مستندات Grub در https://www.gnu.org/software/grub/manual/grub/grub.html#Authentication-and-authorisation و این دیدگاه در https://github.com/Antynea/grub-btrfs/issues/95#issuecomment-682295660 مراجعه کنید. نام‌های کاربری مجاز را با کاما جدا کنید (userfoo,userbar). هنگامی که محافظت با گذرواژه در Grub فعال باشد، کاربر ارشد (superuser) به‌طور پیش‌فرض مجاز است و نیازی به افزودن آن نیست.

—

پیش‌فرض: “”

—

مثال: GRUB_BTRFS_PROTECTION_AUTHORIZED_USERS="userfoo,userbar"

GRUB_BTRFS_DISABLE_PROTECTION_SUBMENU

غیرفعال‌سازی پشتیبانی از احراز هویت فقط برای زیرمنوی Grub-btrfs (--unrestricted). در صورتی که GRUB_BTRFS_PROTECTION_AUTHORIZED_USERS خالی نباشد، کار نخواهد کرد.

—

پیش‌فرض: “false”

—

مثال: GRUB_BTRFS_DISABLE_PROTECTION_SUBMENU="true"