grub-btrfsd(8)              System Manager's Manual             grub-btrfsd(8)



نام (NAME)
       grub-btrfsd - دیمنی برای به‌روزرسانی خودکار منوی گراب با grub-btrfs
       هنگام ایجاد اسنپ‌شات‌های جدید btrfs


خلاصه دستور (SYNOPSIS)
       grub-btrfsd [-h, --help] [-c, --no-color] [-l, --log-file LOG_FILE]
       [-r, --recursive] [-s, --syslog] [-t, --timeshift-auto] [-o,
       --timeshift-old] [-v, --verbose] SNAPSHOTS_DIRS


توضیحات (DESCRIPTION)
       دستور grub-btrfsd یک اسکریپت شل است که برای اجرا به عنوان یک دیمن طراحی
       شده است.  grub-btrfsd از طریق inotifywait دایرکتوری‌ای را که اسنپ‌شات‌های
       btrfs در آن ایجاد یا حذف می‌شوند زیر نظر می‌گیرد و هنگامی که تغییری در آن
       دایرکتوری رخ دهد، دستور grub-mkconfig (اگر از زمان نصب grub-btrfs
       تاکنون این دستور هرگز اجرا نشده باشد) یا اسکریپت
       /etc/grub.d/41_snapshots-btrfs (چنانچه قبلاً پس از نصب grub-btrfs اجرا
       شده باشد) را اجرا می‌کند.


گزینه‌ها (OPTIONS)
   SNAPSHOTS_DIRS
       این آرگومان مسیرهایی (جدا شده با فاصله) را مشخص می‌کند که grub-btrfsd در
       آن‌ها به دنبال اسنپ‌شات‌های تازه ایجاد شده و اسنپ‌شات‌های حذف شده می‌گردد.
       این مسیر معمولاً توسط برنامه‌ای که برای ایجاد اسنپ‌شات استفاده می‌شود تعیین
       می‌گردد؛ به عنوان مثال، برای Snapper این مسیر /.snapshots خواهد بود.
       امکان تعریف بیش از یک دایرکتوری در اینجا وجود دارد؛ همه دایرکتوری‌ها
       تنظیمات یکسانی را به ارث خواهند برد (مانند حالت بازگشتی و غیره).  در
       صورت تنظیم گزینه --timeshift-auto ، نیازی به ارائه این آرگومان نیست.


   -c / --no-color
       غیرفعال کردن رنگ‌ها در خروجی.


   -l / --log-file
       این آرگومان فایلی را مشخص می‌کند که grub-btrfsd باید پیام‌های لاگ را در
       آن بنویسد.


   -r / --recursive
       نظارت بر دایرکتوری اسنپ‌شات به صورت بازگشتی (تودرتو).


   -s / --syslog
       نوشتن پیام‌ها در syslog.


   -t / --timeshift-auto
       این فلگ برای فعال‌سازی تشخیص خودکار مسیری است که Timeshift اسنپ‌شات‌ها را
       در آن ذخیره می‌کند. نسخه‌های جدیدتر (>=22.06) برنامه Timeshift،
       اسنپ‌شات‌های خود را در مسیر /run/timeshift/$PID/backup/timeshift-btrfs
       سوار (mount) می‌کنند؛ که در آن $PID شناسه فرایندِ نشست جاری Timeshift
       است. مقدار PID با هر بار باز شدن Timeshift تغییر می‌کند. در صورت فعال
       بودن این گزینه، grub-btrfsd می‌تواند به‌صورت خودکار PID و دایرکتوری صحیح
       را شناسایی کند. در این حالت، آرگومان SNAPSHOTS_DIRS هیچ اثری نخواهد
       داشت.


   -o / --timeshift-old
       جستجوی اسنپ‌شات‌ها در /run/timeshift/backup/timeshift-btrfs به جای
       /run/timeshift/$PID/backup/timeshift-btrfs .  این گزینه برای نسخه‌های
       Timeshift قدیمی‌تر از 22.06 کاربرد دارد.


   -v / --verbose
       افزایش جزئیات پیام‌های لاگ دیمن (حالت پرگویی).


   -h / --help
       نمایش پیام کوتاه راهنما.


پیکربندی (CONFIGURATION)
       این دیمن معمولاً در سیستم‌های دارای سیستم راه‌انداز openrc از طریق فایل
       /etc/conf.d/grub-btrfsd و در سیستم‌های مبتنی بر systemd با دستور sudo
       systemctl edit --full grub-btrfsd پیکربندی می‌شود. در این فایل می‌توان
       آرگومان‌هایی را که OpenRC هنگام راه‌اندازی به دیمن ارسال می‌کند (به بخش
       OPTIONS مراجعه کنید) پیکربندی نمود.


   نکات (NOTES)
       یک پیکربندی معمول برای Snapper این است که SNAPSHOTS_DIR روی /.snapshots
       تنظیم شود و --timeshift-auto تنظیم نگردد.  برای Timeshift، گزینه
       --timeshift-auto روی true تنظیم شده و SNAPSHOTS_DIR می‌تواند به حال خود
       رها شود.


فایل‌ها (FILES)
       /etc/conf.d/grub-btrfsd
       /usr/lib/systemd/system/grub-btrfsd.service


همچنین ببینید (SEE ALSO)
       btrfs(8), btrfs-subvolume(8), grub-btrfs(8), grub-mkconfig(8),
       inotifywait(1), openrc(8), rc-service(8), timeshift(1)


حق نشر (COPYRIGHT)
       Copyright (c) 2022 Pascal Jäger

                                                                grub-btrfsd(8)