.\" Copyright (c) 2025 Chengyu Zhu <hudsonzhu@tencent.com>
.\"
.TH MOUNT.EROFS 8
.SH "نام (NAME)"
mount.erofs \- مدیریت سامانه پرونده EROFS
.SH "شرح مختصات (SYNOPSIS)"
\fBmount.erofs\fR [\fIOPTIONS\fR] \fISOURCE\fR \fIMOUNTPOINT\fR
.br
\fBmount.erofs\fR \fB\-u\fR \fITARGET\fR
.br
\fBmount.erofs\fR \fB\-\-reattach\fR \fITARGET\fR
.SH "توضیحات (DESCRIPTION)"
سامانه EROFS یک سامانه پرونده فقط‌خواندنی سبک و بهبود‌یافته با طراحی‌های مدرن برای سناریوهایی است که نیازمند کارایی بالا در شرایط فقط‌خواندنی هستند.
.PP
ابزار \fBmount.erofs\fR برای متصل کردن یک سامانه پرونده EROFS از \fISOURCE\fR (که می‌تواند یک پرونده تصویر یا دستگاه بلوکی باشد) به یک نقطه اتصال \fIMOUNTPOINT\fR استفاده می‌شود. این ابزار از چندین بک‌اند شامل اتصال مستقیم از طریق هسته، اتصال مبتنی بر FUSE و NBD (دستگاه بلوکی تحت شبکه) برای منابع راه دور مانند تصاویر OCI پشتیبانی می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-h, \-\-help
نمایش پیام راهنما و خروج.
.TP
.B \-V, \-\-version
نمایش اطلاعات نگارش و خروج.
.TP
.BI "\-o " options
فهرستی از گزینه‌های اتصال جدا شده با کاما. بخش \fBگزینه‌های اتصال (MOUNT OPTIONS)\fR در ادامه را ببینید.
.TP
.BI "\-t " type[.subtype]
تعیین نوع سامانه پرونده و زیرنوع اختیاری آن. نوع باید \fBerofs\fR باشد. زیرنوع‌های موجود عبارتند از:
.RS
.TP
.B fuse
استفاده از اتصال مبتنی بر FUSE از طریق \fBerofsfuse\fR.
.TP
.B local
اجبار به اتصال مستقیم از طریق هسته (پیش‌فرض در صورت موجود بودن).
.TP
.B nbd
استفاده از بک‌اند NBD برای منابع راه دور (مانند تصاویر OCI).
.RE
.TP
.B \-u
پیاده‌سازی (unmount) سامانه پرونده در هدف مشخص‌شده.
.TP
.B \-\-reattach
اتصال مجدد به یک دستگاه NBD موجود و راه‌اندازی دوباره سرویس NBD.
.SH "گزینه‌های اتصال (MOUNT OPTIONS)"
گزینه‌های استاندارد اتصال:
.TP
.B ro
اتصال سامانه پرونده به صورت فقط‌خواندنی (پیش‌فرض).
.TP
.B rw
اتصال سامانه پرونده به صورت خواندن-نوشتن (برای EROFS پشتیبانی نمی‌شود).
.TP
.B nosuid
نادیده گرفتن بیت‌های set-user-ID و set-group-ID.
.TP
.B suid
رعایت بیت‌های set-user-ID و set-group-ID (پیش‌فرض).
.TP
.B nodev
تفسیر نکردن دستگاه‌های ویژه نویسه‌ای یا بلوکی.
.TP
.B dev
تفسیر دستگاه‌های ویژه نویسه‌ای یا بلوکی (پیش‌فرض).
.TP
.B noexec
عدم اجازه اجرای مستقیم برنامه‌های دودویی.
.TP
.B exec
اجازه اجرای برنامه‌های دودویی (پیش‌فرض).
.TP
.B noatime
به‌روزرسانی نکردن زمان‌های دسترسی گره‌های اینود (inode).
.TP
.B atime
به‌روزرسانی زمان‌های دسترسی اینودها (پیش‌فرض).
.TP
.B nodiratime
به‌روزرسانی نکردن زمان‌های دسترسی اینودهای شاخه‌ها.
.TP
.B diratime
به‌روزرسانی زمان‌های دسترسی اینودهای شاخه‌ها (پیش‌فرض).
.TP
.B relatime
به‌روزرسانی زمان‌های دسترسی اینود وابسته به زمان تغییر داده‌ها.
.TP
.B norelatime
عدم استفاده از به‌روزرسانی‌های وابسته به زمان دسترسی relatime.
.SH "گزینه‌های ویژه OCI"
گزینه‌های ویژه OCI زیر در دسترس هستند:
.TP
.BI "oci.blob=" digest
تعیین خلاصه‌ساز (digest) حباب OCI جهت اتصال. خلاصه باید در قالب \fBsha256:...\fR باشد. نمی‌توان آن را همراه با \fBoci.layer\fR استفاده کرد.
.TP
.BI "oci.layer=" index
تعیین نمایه لایه OCI برای اتصال (مبتنی بر صفر). نمی‌توان همراه با \fBoci.blob\fR استفاده کرد.
.TP
.BI "oci.platform=" platform
تعیین سکوی هدف (پیش‌فرض: \fBlinux/amd64\fR).
.TP
.BI "oci.username=" username
نام کاربری برای احراز هویت در رجیستری OCI.
.TP
.BI "oci.password=" password
گذرواژه برای احراز هویت در رجیستری OCI.
.TP
.BI "oci.tarindex=" path
مسیر پرونده نمایه tarball برای حالت ترکیبی tar+OCI.
.TP
.BI "oci.zinfo=" path
مسیر پرونده gzip zinfo برای دسترسی تصادفی به لایه‌های tar فشرده‌شده با gzip.
.TP
.BI "oci.insecure"
استفاده از پروتکل HTTP به جای HTTPS برای دسترسی به رجیستری تصویر.
.SH "نکات (NOTES)"
.IP \(bu 2
سامانه‌های پرونده EROFS ذاتا فقط‌خواندنی هستند. گزینه \fBrw\fR نادیده گرفته خواهد شد.
.IP \(bu 2
هنگام اتصال تصاویر OCI از طریق NBD، فرآیند اتصال یک دیمن پس‌زمینه برای سرویس‌دهی به دستگاه NBD ایجاد می‌کند. این دیمن هنگام پیاده‌سازی سامانه پرونده به طور خودکار پاکسازی خواهد شد.
.IP \(bu 2
گزینه \fB\-\-reattach\fR برای بازیابی اتصالات NBD پس از فروپاشی سیستم یا زمانی که دیمن NBD به طور غیرمنتظره متوقف شده است مفید است.
.IP \(bu 2
هنگام متصل کردن یک پرونده معمولی بدون تعیین نوع بک‌اند، از اتصال مستقیم هسته استفاده می‌شود. اگر اتصال مبتنی بر پرونده پشتیبانی نشود، دستگاه‌های حلقه (loop devices) به طور خودکار تنظیم خواهند شد.
.SH "همچنین ببینید (SEE ALSO)"
.BR mkfs.erofs (1),
.BR erofsfuse (1),
.BR dump.erofs (1),
.BR fsck.erofs (1),
.BR mount (8),
.BR umount (8)
.SH "در دسترس بودن (AVAILABILITY)"
ابزار \fBmount.erofs\fR بخشی از erofs-utils است.