.TH "grub-btrfsd" "8"

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

.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBgrub\-btrfsd\fR [\fB\-h\fR, \fB\-\-help\fR] [\fB\-c\fR, \fB\-\-no\-color\fR] [\fB\-l\fR, \fB\-\-log\-file\fR \fILOG_FILE\fR] [\fB\-r\fR, \fB\-\-recursive\fR] [\fB\-s\fR, \fB\-\-syslog\fR] [\fB\-t\fR, \fB\-\-timeshift\-auto\fR] [\fB\-o\fR, \fB\-\-timeshift\-old\fR] [\fB\-v\fR, \fB\-\-verbose\fR] \fISNAPSHOTS_DIRS\fR

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

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

.SS "\fB\-c\fR / \fB\-\-no\-color\fR"
.PP
غیرفعال کردن رنگ‌ها در خروجی.

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

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

.SS "\fB\-s\fR / \fB\-\-syslog\fR"
.PP
نوشتن پیام‌ها در syslog.

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

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

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

.SS "\fB\-h\fR / \fB\-\-help\fR"
.PP
نمایش پیام کوتاه راهنما.

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

.SS "نکات (NOTES)"
.PP
یک پیکربندی معمول برای Snapper این است که
\fISNAPSHOTS_DIR\fR
روی
\fI/.snapshots\fR
تنظیم شود و
\fB\-\-timeshift\-auto\fR
تنظیم نگردد.
برای Timeshift، گزینه
\fB\-\-timeshift\-auto\fR
روی true تنظیم شده و
\fISNAPSHOTS_DIR\fR
می‌تواند به حال خود رها شود.

.SH "فایل‌ها (FILES)"
.PP
\fI/etc/conf.d/grub\-btrfsd\fR
.br
\fI/usr/lib/systemd/system/grub\-btrfsd.service\fR

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

.SH "حق نشر (COPYRIGHT)"
.PP
Copyright (c) 2022 Pascal Jäger