.\" Man page generated from reStructuredText .\" by the Docutils 0.22.4 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "borg-mount" "1" "2026-07-18" "" "ابزار پشتیبان‌گیری بورگ" .SH "نام (NAME)" borg-mount \- سوار کردن آرشیو یا کل مخزن به عنوان سیستم‌فایل FUSE .SH "خلاصه دستور (SYNOPSIS)" .sp \fBborg\fP [\fIگزینه‌های عمومی\fR] \fBmount\fP [\fIگزینه‌ها\fR] \fIREPOSITORY_OR_ARCHIVE\fP \fIMOUNTPOINT\fP [\fIPATH\fR...] .SH "توضیحات (DESCRIPTION)" .sp این دستور یک مخزن یا یک آرشیو را به عنوان سیستم‌فایل FUSE سوار (mount) می‌کند. این قابلیت برای مرور یا بازیابی فایل‌های تکی مفید است. .sp هنگام بازیابی، توجه داشته باشید که پیاده‌سازی فعلی FUSE از فلگ‌های ویژه سیستم‌فایل و لیست‌های کنترل دسترسی (ACL) پشتیبانی نمی‌کند. .sp هنگام سوار کردن یک مخزن، نام دایرکتوری‌های سطح بالا مانند آرشیوها خواهد بود و ساختار دایرکتوری زیر آن‌ها هنگام ورود به این دایرکتوری‌ها بر حسب تقاضا از مخزن بارگذاری می‌شود؛ بنابراین مقداری تاخیر مورد انتظار است. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 بورگ پیوندهای نمادین را همان‌گونه که هستند ذخیره می‌کند. در نتیجه، هنگامی که یک آرشیو یا مخزن سوار می‌شود، پیوندهای نمادین ممکن است به مکان‌هایی خارج از نقطه اتصال (mountpoint) اشاره کنند، خواه به دلیل مطلق بودن آن‌ها باشد یا به دلیل اینکه پیوندهای نسبی به خارج از درخت سوارشده هدایت می‌شوند. .sp قوانین معمول تفکیک مسیر یونیکس اعمال می‌شود: بیشتر ابزارها به طور پیش‌فرض پیوندهای نمادین را دنبال می‌کنند و ممکن است به فایل‌ها یا دایرکتوری‌هایی دسترسی یابند که بخشی از آرشیو سوارشده نیستند. در نتیجه، عملیاتی که هدف آن‌ها بررسی داده‌های آرشیو شده است ممکن است در عوض به داده‌های «زنده» سیستم‌فایل میزبان دسترسی پیدا کنند. .sp در لینوکس، می‌توان با سوار کردن مجدد نقطه اتصال با استفاده از گزینه سوار کردن VFS به نام \fBnosymfollow\fP از این امر جلوگیری کرد؛ به عنوان مثال: .INDENT 0.0 .INDENT 3.5 borg mount mount \-o remount,nosymfollow .UNINDENT .UNINDENT .sp روش دیگر این است که از یک محیط ایزوله‌شده مناسب (مانند یک کانتینر یا \fBchroot\fP) به آرشیو سوارشده دسترسی پیدا کنید. .UNINDENT .UNINDENT .sp مگر اینکه گزینه \fB\-\-foreground\fP مشخص شده باشد، این دستور در پس‌زمینه اجرا خواهد شد تا زمانی که سیستم‌فایل پیاده (unmount) شود. .sp نکاتی برای بهبود کارایی: .INDENT 0.0 .IP \(bu 2 هنگام سوار کردن «کل مخزن»: اگر نیازی نیست وارد دایرکتوری‌های آرشیو نشوید؛ این کار مانع از بارگذاری بر حسب تقاضا می‌شود. .IP \(bu 2 به جای کل مخزن، فقط یک آرشیو خاص را سوار کنید. .IP \(bu 2 به جای کل آرشیو، فقط مسیرهای خاصی را در یک آرشیو معین سوار کنید. .UNINDENT .sp دستور \fBborgfs\fP یک پوشش (wrapper) برای \fBborg mount\fP فراهم می‌کند. این دستور همچنین می‌تواند در ورودی‌های fstab استفاده شود: .sp \fB/path/to/repo /mnt/point fuse.borgfs defaults,noauto 0 0\fP .sp برای اجازه دادن به کاربر عادی جهت استفاده از ورودی‌های fstab، گزینه \fBuser\fP را اضافه کنید: .sp \fB/path/to/repo /mnt/point fuse.borgfs defaults,noauto,user 0 0\fP .sp برای پیکربندی FUSE و گزینه‌های سوار کردن، صفحه راهنمای \fBmount.fuse\fP(8) را ببینید. .sp رفتار پیش‌فرض بورگ این است که از نام‌های کاربری و گروه آرشیوشده برای هر فایل استفاده کرده و آن‌ها را به شناسه‌های کاربری و گروه متناظر در سیستم نگاشت کند. در غیر این صورت، استفاده از \fBnumeric\-ids\fP باعث می‌شود شناسه‌های کاربری و گروه آرشیوشده بدون هیچ‌گونه نگاشتی استفاده شوند. .sp گزینه‌های سوار کردن \fBuid\fP و \fBgid\fP (پیاده‌سازی‌شده توسط بورگ) می‌توانند برای بازنویسی شناسه‌های کاربری و گروه تمام فایل‌ها استفاده شوند (مثلاً \fBborg mount \-o uid=1000,gid=1000\fP). .sp صفحه راهنما به گزینه‌های سوار کردن \fBuser_id\fP و \fBgroup_id\fP (پیاده‌سازی‌شده توسط FUSE) اشاره دارد که شناسه کاربری و گروه مالک نقطه اتصال (یعنی کاربری که عمل سوار کردن را انجام می‌دهد) را تعیین می‌کنند. این مقدار به صورت خودکار توسط libfuse (یا در صورت عدم استفاده از libfuse، توسط سیستم‌فایل) تنظیم می‌شود. با این حال، نباید این گزینه‌ها را دستی مشخص کنید. برخلاف گزینه‌های \fBuid\fP و \fBgid\fP که بر تمامی فایل‌ها تأثیر می‌گذارند، \fBuser_id\fP و \fBgroup_id\fP بر شناسه کاربر و گروه دایرکتوری پایه سوارشده اثر می‌گذارند. .sp گزینه‌های سوار کردن اضافی پشتیبانی‌شده توسط بورگ: .INDENT 0.0 .IP \(bu 2 \fBversions\fP: هنگامی که همراه با سوار کردن مخزن استفاده شود، یک نمای ادغام‌شده و نسخه‌بندی‌شده از فایل‌ها در آرشیوها ارائه می‌دهد. آزمایشی (EXPERIMENTAL)؛ طرح‌بندی ممکن است در آینده تغییر کند. .IP \(bu 2 \fBallow_damaged_files\fP: به طور پیش‌فرض فایل‌های آسیب‌دیده (که در آن‌ها تکه‌های مفقود توسط \fBborg check \-\-repair\fP با صفرهای متوالی جایگزین شده‌اند) قابل خواندن نیستند و خطای EIO (خطای ورودی/خروجی) برمی‌گردانند. این گزینه را برای خواندن چنین فایل‌هایی تنظیم کنید. .IP \(bu 2 \fBignore_permissions\fP: به دلایل امنیتی، گزینه سوار کردن \fBdefault_permissions\fP به صورت داخلی توسط بورگ اعمال می‌شود. گزینه \fBignore_permissions\fP می‌تواند تعیین شود تا \fBdefault_permissions\fP اجبار نشود. .UNINDENT .sp متغیر محیطی \fBBORG_MOUNT_DATA_CACHE_ENTRIES\fP برای کاربران پیشرفته جهت بهینه‌سازی کارایی طراحی شده است. این متغیر تعداد تکه‌های داده کش‌شده را تعیین می‌کند؛ مصرف حافظه اضافی می‌تواند تا حدود ۸ مبی‌بایت ضرب در این عدد باشد. مقدار پیش‌فرض برابر با تعداد هسته‌های پردازنده است. .sp هنگامی که فرآیند دیمون‌شده سیگنالی دریافت می‌کند یا متوقف می‌شود (crash)، سیستم‌فایل پیاده (unmount) نمی‌شود. پیاده‌سازی در این شرایط ممکن است باعث شود یک فرآیند فعال rsync یا مشابه آن به طور ناخواسته داده‌ها را حذف کند. .sp هنگام اجرا در پیش‌زمینه، ترکیب ^C/SIGINT سیستم‌فایل را به صورت تمیز پیاده می‌کند، اما سایر سیگنال‌ها یا خرابی‌ها چنین نمی‌کنند. .sp اشکال‌زدایی: .sp دستور \fBborg mount\fP معمولاً به صورت دیمون اجرا می‌شود و فرآیند دیمون خروجی‌های stdout/stderr را به /dev/null ارسال می‌کند. بنابراین، یا باید از گزینه \fB\-f / \-\-foreground\fP استفاده کنید تا در پیش‌زمینه بماند و دیمون نشود، یا از \fBBORG_LOGGING_CONF\fP برای پیکربندی مجدد ثبت‌کننده لاگ جهت خروجی به یک فایل استفاده نمایید. .SH "گزینه‌ها (OPTIONS)" .sp برای مشاهده گزینه‌های عمومی دستورات بورگ، به \fIborg\-common\fP(1) مراجعه کنید. .SS آرگومان‌ها .INDENT 0.0 .TP .B REPOSITORY_OR_ARCHIVE مخزن یا آرشیو برای سوار کردن .TP .B MOUNTPOINT محل سوار کردن سیستم‌فایل .TP .B PATH مسیرها برای استخراج؛ الگوها پشتیبانی می‌شوند .UNINDENT .SS گزینه‌ها .INDENT 0.0 .TP .B \-\-consider\-checkpoints نمایش آرشیوهای چک‌پوینت در فهرست محتویات مخزن (پیش‌فرض: مخفی). .TP .B \-f\fP,\fB \-\-foreground ماندن در پیش‌زمینه، دیمون نشود .TP .B \-o گزینه‌های سوار کردن اضافی .TP .B \-\-numeric\-owner منسوخ شده است، به جای آن از \fB\-\-numeric\-ids\fP استفاده کنید .TP .B \-\-numeric\-ids استفاده از شناسه‌های عددی کاربر و گروه از آرشیو(ها) .UNINDENT .SS فیلترهای آرشیو .INDENT 0.0 .TP .BI \-P \ PREFIX\fR,\fB \ \-\-prefix \ PREFIX تنها در نظر گرفتن نام‌های آرشیوی که با این پیشوند آغاز می‌شوند. (منسوخ شده) .TP .BI \-a \ GLOB\fR,\fB \ \-\-glob\-archives \ GLOB تنها در نظر گرفتن نام‌های آرشیوی که با الگوی glob مطابقت دارند. قواعد sh: اعمال می‌شوند (بدون نیاز به استفاده واقعی از پیشوند sh:)، به «borg help patterns» مراجعه کنید. .TP .BI \-\-sort\-by \ KEYS فهرست جداشده با کاما از کلیدهای مرتب‌سازی؛ کلیدهای معتبر عبارتند از: timestamp، archive، name، id؛ پیش‌فرض: timestamp .TP .BI \-\-first \ N در نظر گرفتن N آرشیو اول پس از اعمال سایر فیلترها .TP .BI \-\-last \ N در نظر گرفتن N آرشیو آخر پس از اعمال سایر فیلترها .UNINDENT .SS گزینه‌های گنجاندن/مستثنی کردن .INDENT 0.0 .TP .BI \-e \ PATTERN\fR,\fB \ \-\-exclude \ PATTERN مستثنی کردن مسیرهای منطبق بر PATTERN .TP .BI \-\-exclude\-from \ EXCLUDEFILE خواندن الگوهای استثنا از EXCLUDEFILE، یک الگو در هر خط .TP .BI \-\-pattern \ PATTERN گنجاندن/مستثنی کردن مسیرهای منطبق بر PATTERN .TP .BI \-\-patterns\-from \ PATTERNFILE خواندن الگوهای گنجاندن/استثنا از PATTERNFILE، یک الگو در هر خط .TP .BI \-\-strip\-components \ NUMBER حذف تعداد مشخص‌شده از بخش‌های ابتدایی مسیر. مسیرهایی با بخش‌های کمتر بدون اعلان نادیده گرفته می‌شوند. .UNINDENT .SH "همچنین ببینید (SEE ALSO)" .sp \fIborg\-common\fP(1), \fIborg\-umount\fP(1), \fIborg\-extract\fP(1) .SH "نویسنده (Author)" گروه بورگ (The Borg Collective) .\" End of generated man page.