.\" Copyright (c) 2019 Gao Xiang .\" .TH MKFS.EROFS 1 .SH "نام (NAME)" mkfs.erofs \- ابزاری برای ساخت سیستم‌فایل EROFS .SH "خلاصه دستور (SYNOPSIS)" \fBmkfs.erofs\fR [\fIگزینه‌ها\fR] \fIمقصد\fR \fIمبدأ\fR .SH "توضیحات (DESCRIPTION)" سیستم‌فایل EROFS یک سیستم‌فایل فقط‌خواندنی سبک، بهبودیافته و مدرن لینوکس است که با طراحی‌های نوین (مانند عدم استفاده از buffer head، متادیتای بهینه‌سازی‌شده، داده‌ها و ویژگی‌های توسعه‌یافته درون‌خطی و غیره) برای سناریوهایی با کارایی بالا در حالت فقط‌خواندنی، نظیر سیستم‌عامل اندروید در گوشی‌های هوشمند و دیسک‌های زنده (LiveCD) توسعه یافته است. .PP این سیستم‌فایل همچنین از فشرده‌سازی با خروجی اندازه ثابت پشتیبانی می‌کند که تراکم ذخیره‌سازی را بهبود بخشیده و نرخ فشرده‌سازی نسبتاً بالاتری ارائه می‌دهد؛ این ویژگی به‌ویژه برای دستگاه‌های تعبیه‌شده (Embedded) با حافظه محدود که نیازمند کارایی بالا و حداقل بار اضافی حافظه و جلوگیری از نوسان حافظه کش صفحه (Page cache thrashing) هستند، بسیار کاربردی است. .PP دستور \fBmkfs.erofs\fR برای ساخت فایل تصویر \fIمقصد\fR سیستم‌فایل EROFS از روی انواع مختلف \fIمبدأ\fR استفاده می‌شود، که در آن \fIمبدأ\fR می‌تواند شامل موارد زیر باشد: .RS .IP \(bu 2 یک دایرکتوری محلی .IP \(bu 2 یک آرشیو تار (فشرده‌شده یا ساده) .IP \(bu 2 یک باکت S3 یا پیشوندی درون آن .IP \(bu 2 یک مرجع تصویر OCI .IP \(bu 2 یک یا چند تصویر EROFS دیگر (به بخش \fIREBUILD MODE\fR در ادامه مراجعه کنید) .RE .SH "گزینه‌ها (OPTIONS)" .TP .BI "\-b " block-size اندازه بلوک پایه‌ای سیستم‌فایل را بر حسب بایت تعیین می‌کند. به عبارت دیگر، کمترین مقدار داده‌ای که در هر بار قابل دسترسی است مشخص می‌شود. مقدار پیش‌فرض اندازه صفحه سیستم است و نمی‌تواند کمتر از ۵۱۲ بایت باشد. .TP .BI "\-C " max-pcluster-size حداکثر اندازه کلاستر فیزیکی فشرده‌سازی را بر حسب بایت مشخص می‌کند. این گزینه ممکن است باعث فعال‌سازی ویژگی pcluster بزرگ شود (لینوکس 5.13+). .TP .BI "\-m " "#\fR[:\fIcompression-algorithm\fR]" فشرده‌سازی متادیتا را با کلاسترهای #-بایتی در یک اینود metabox فعال می‌کند (لینوکس 6.17+)؛ به‌صورت اختیاری می‌توان الگوریتم فشرده‌سازی را مشخص کرد (در صورت عدم تعیین، از الگوریتم فشرده‌سازی داده استفاده می‌شود). .TP .BI "\-\-MZ\fR[\fP=<0|[id]>\fR]\fP" متادیتای اینود ('i') و/یا داده‌های دایرکتوری ('d') را در یک ناحیه متادیتای جداگانه قرار می‌دهد. این کار محلی‌سازی مکانی چیدمان متادیتا را درون تصویر بهبود می‌بخشد که برای دسترسی به متادیتا روی حافظه‌های ذخیره‌سازی با تاخیر بالای I/O بسیار سودمند است. .TP .BI "\-x " # محدودیت تعداد ویژگی‌های توسعه‌یافته (xattrs) که به‌صورت درون‌خطی ذخیره می‌شوند. پیش‌فرض 2 است. .TP .BI "\-z " compression-algorithm \fR[\fP, # \fR][\fP: ... \fR]\fP الگوریتم اصلی فشرده‌سازی داده‌ها را به همراه سطح فشرده‌سازی اختیاری تعیین می‌کند. می‌توان الگوریتم‌های جایگزین را با دونقطه (:) از هم جدا و مشخص کرد. برای مشاهده فهرست الگوریتم‌هایی که \fBmkfs.erofs\fR با آن‌ها کامپایل شده و دامنه سطوح فشرده‌سازی مربوطه، خروجی دستور زیر را ببینید: .br .B mkfs.erofs \-\-help .TP .BI "\-\-zD\fR[\fP=<0|1>\fR]\fP" برای فعال یا غیرفعال کردن فشرده‌سازی دایرکتوری استفاده می‌شود: 0=غیرفعال، 1=فعال. اگر آرگومان اختیاری حذف شود، فشرده‌سازی دایرکتوری به‌طور پیش‌فرض فعال است. .TP .BI "\-d " # سطح پیام‌های اشکال‌زدایی (دیباگ) را تعیین می‌کند. مقدار پیش‌فرض 2 است که پیام‌های هشدار پایه را نمایش می‌دهد. مقادیر کمتر از صفر ذخیره‌سازی xattr را غیرفعال می‌کنند. .TP .BI "\-E " [^]extended-option \fR[\fP, ... \fR]\fP گزینه‌های توسعه‌یافته سیستم‌فایل را تعیین می‌کند. گزینه‌های توسعه‌یافته با کاما از یکدیگر جدا می‌شوند و ممکن است با علامت مساوی ('=') آرگومان اضافی دریافت کنند. برای غیرفعال کردن یک ویژگی، معمولاً نام گزینه را با کاراکتر هشتک/توان ('^') شروع می‌کنند. گزینه‌های توسعه‌یافته زیر پشتیبانی می‌شوند: .RS 1.2i .TP .BI 48bit آدرس‌دهی ۴۸ بیتی بلوک‌ها و گستره‌های کدگذاری‌شده را برای پشتیبانی از تصاویر سیستم‌فایل بزرگ‌تر و فشرده‌سازی داده‌های بایت‌محور (عمدتاً برای Zstandard) فعال می‌کند (لینوکس 6.15+). .TP .BI all-fragments به‌طور اجباری کل فایل‌ها را برای فشرده‌سازی بهتر درون یک اینود ویژه ذخیره می‌کند و می‌تواند اندازه‌ای به عنوان اندازه pcluster اینود بسته‌بندی‌شده بر حسب بایت دریافت کند (لینوکس 6.1+). .TP .BI dedupe حذف داده‌های تکراری سراسری فشرده‌شده (Deduplication) را برای به حداقل رساندن داده‌های تکراری در سیستم‌فایل فعال می‌کند. استفاده هم‌زمان با .BR -E\ fragments می‌تواند حجم تصویر را بیشتر کاهش دهد (لینوکس 6.1+). .TP .BI dot-omitted ورودی دایرکتوری "." (نقطه) را در تمام دایرکتوری‌ها برای کاهش بار اضافی متادیتا حذف می‌کند (لینوکس 6.15+). این گزینه همچنین چیدمان روی دیسک \fB48bit\fR را فعال می‌کند. .TP .BI force-inode-compact تولید اینودهای فشرده (۳۲ بایتی) را اجباری می‌کند. .TP .BI force-inode-extended تولید اینودهای توسعه‌یافته (۶۴ بایتی) را اجباری می‌کند. .TP .BI force-inode-blockmap تولید قالب چانک اینود را به‌صورت آرایه‌ای از آدرس‌های بلوک ۴ بایتی اجباری می‌کند. .TP .BI force-chunk-indexes تولید قالب چانک اینود را به‌صورت نمایه چانک ۸ بایتی (همراه با شناسه دستگاه) اجباری می‌کند. .TP .BI [^]fragdedupe\fR[\fP= \fR]\fP حالت حذف داده‌های تکراری قطعات (Fragments) را تعیین می‌کند. این گزینه فقط زمانی مؤثر است که همراه با .I -E(all)-fragments استفاده شود. اگر کاراکتر ('^') قرار داده شود، حذف تکرار قطعات غیرفعال می‌شود. .RS 1.2i .TP .I inode حذف تکرار داده‌های قطعه تنها در صورتی که داده‌های اینود یکسان باشند انجام می‌شود. این گزینه در کدبیس فعلی منجر به تولید سریع‌تر تصویر می‌شود. .TP .I full حذف تکرار داده‌های قطعه همیشه در صورت امکان انجام می‌شود. .RE .TP .BI fragments\fR[\fP= size \fR]\fP بخش انتهایی (pcluster) فایل‌های فشرده‌شده یا کل فایل‌ها را برای کاهش اندازه تصویر در یک اینود ویژه بسته‌بندی می‌کند، و می‌تواند اندازه‌ای به عنوان اندازه pcluster اینود بسته‌بندی‌شده بر حسب بایت دریافت کند (لینوکس 6.1+). .TP .BI ^inline_data از درون‌خطی کردن فایل‌های معمولی جلوگیری می‌کند. این گزینه معمولاً برای فعال‌سازی FSDAX (لینوکس 5.15+) در آن تصاویر کاربرد دارد، هرچند موارد استفاده دیگری نیز دارد. .TP .B legacy-compress " (منسوخ؛ در استفاده روزمره استفاده نشود)" چیدمان روی دیسک «نمایه‌های فشرده‌شده» را غیرفعال می‌کند. .TP .BI nosbcrc چک‌سام سوپربلوک سیستم‌فایل را صریحاً غیرفعال می‌کند. .TP .BI plain-xattr-prefixes پیشوندهای طولانی نام ویژگی‌های توسعه‌یافته را به‌جای اینودهای ویژه، مستقیماً روی دیسک ذخیره می‌کند. به‌طور پیش‌فرض، پیشوندهای طولانی نام xattr در metabox_inode (در صورت فعال بودن metabox) یا packed_inode (در صورت فعال بودن fragments) قرار می‌گیرند. این گزینه ذخیره آن‌ها را به‌صورت ساختارهای ساده روی دیسک اجباری می‌کند. .TP .B xattr-name-filter فیلتر نام را برای ویژگی‌های توسعه‌یافته جهت بهینه‌سازی جستجوهای منفی فعال می‌کند (لینوکس 6.6+). .TP .BI ztailpacking بخش انتهایی (pcluster) فایل‌های فشرده‌شده را درون متادیتای آن بسته‌بندی می‌کند تا فضای بیشتری صرفه‌جویی شده و عملیات I/O بخش انتهایی کاهش یابد (لینوکس 5.17+). .RE .TP .BI "\-L " volume-label برچسب حجم (Volume Label) سیستم‌فایل را روی .I volume-label تنظیم می‌کند. حداکثر طول برچسب حجم ۱۵ بایت است. .TP .BI "\-T " # یک برچسب زمانی یونیکس (Timestamp) برای زمان ایجاد تصویر به منظور ساخت‌های بازتولیدپذیر (Reproducible Builds) تعیین می‌کند. اگر .I --mkfs-time مشخص نشده باشد، مانند .I --all-time عمل خواهد کرد: تمام فایل‌ها به‌جای زمان اصلاح فایل‌های مبدأ، با این برچسب زمانی یونیکس تنظیم می‌شوند. .TP .BI "\-U " UUID شناسه یکتای سراسری (UUID) سیستم‌فایل را روی .I UUID تنظیم می‌کند. قالب UUID رشته‌ای از ارقام هگزادسیمال جداشده با خط تیره است، مانند: "c1b9d5a2-f162-11cf-9ece-0020afc76f16". پارامتر .I UUID همچنین می‌تواند یکی از مقادیر زیر باشد: .RS 1.2i .TP .I clear پاک کردن UUID سیستم‌فایل .TP .I random ایجاد یک UUID تصادفی جدید .RE .TP .B \-\-all-root مالکیت تمامی فایل‌ها را به کاربر root اختصاص می‌دهد. .TP .B \-\-all-time (همراه با \fB-T\fR استفاده می‌شود) زمان تمامی فایل‌ها را روی برچسب زمانی ثابت تنظیم می‌کند. این حالت پیش‌فرض است. .TP .BI "\-\-async-queue-limit=" # حداکثر تعداد ورودی‌ها در صف وظایف چندنخی را مشخص می‌کند. .TP .BI "\-\-aufs" فایل‌های ویژه aufs را با متادیتای overlayfs جایگزین می‌کند. .TP .BI "\-\-blobdev " file یک دستگاه حبابی (Blob Device) اضافی برای ذخیره‌سازی داده‌های مبتنی بر چانک مشخص می‌کند. .TP .BI "\-\-chunksize " # فایل‌های مبتنی بر چانک را با چانک‌های #-بایتی تولید می‌کند. .TP .BI "\-\-clean=" MODE یک ساخت کاملاً تمیز با حالت \fIMODE\fR داده‌شده اجرا می‌کند که می‌تواند یکی از مقادیر \fBdata\fR، \fBrvsp\fR، یا \fB0\fR باشد. .PP اگر گزینه \fB\-\-clean\fR بدون مقدار صریح مشخص شود، به‌صورت \fB\-\-clean=data\fR رفتار می‌کند. .PP \fBdata\fR: داده‌های کامل فایل را از مبدأ به تصویر مقصد وارد کرده و یک تصویر EROFS کاملاً خودکفا می‌سازد. این حالت زمانی کاربرد دارد که به تصویری مستقل و بی‌نیاز از دستگاه‌های حباب خارجی احتیاج دارید. .PP \fBrvsp\fR: فضا را برای داده‌های فایل در تصویر مقصد رزرو می‌کند بدون اینکه محتوای واقعی کپی شود. داده‌های فایل بعداً باید از روش‌های دیگر پر شوند. این حالت برای ایجاد تصاویر خلوت (Sparse) یا زمانی که داده‌های واقعی جداگانه منتقل می‌شوند مناسب است. .PP \fB0\fR: تمام داده‌های اینود را با صفر پر می‌کند. .PP پشتیبانی حالت‌های \fIMODE\fR به تفکیک نوع مبدأ در حال حاضر: .RS 1.2i .TP .I مبدأ دایرکتوری محلی تنها حالت \fBdata\fR پشتیبانی می‌شود. حالت‌های \fBrvsp\fR و \fB0\fR نادیده گرفته می‌شوند. .TP .I مبدأ تار (\fB\-\-tar\fR) حالت‌های \fBdata\fR و \fBrvsp\fR پشتیبانی می‌شوند. حالت \fB0\fR نادیده گرفته می‌شود. توجه داشته باشید که \fBrvsp\fR اولویت بالاتری نسبت به \fB--tar=i\fR یا \fB--tar=headerball\fR دارد. .TP .I حالت بازسازی (Rebuild mode) حالت‌های \fBdata\fR و \fBrvsp\fR پشتیبانی می‌شوند. .TP .I مبدأ S3 (\fB\-\-s3\fR) حالت‌های \fBdata\fR و \fB0\fR پشتیبانی می‌شوند. .TP .I مبدأ OCI (\fB\-\-oci\fR) تنها حالت \fBdata\fR پشتیبانی می‌شود. .RE .TP .BI "\-\-compress-hints=" file یک استراتژی فشرده‌سازی بر اساس هر فایل اعمال می‌کند. هر خط در .I file توسط نشانه‌هایی که با فاصله از هم جدا شده‌اند به شکل زیر تعریف می‌شود. به‌صورت اختیاری، به‌جای الگوریتم اصلی می‌توان الگوریتم‌های جایگزین را با .I algorithm-index به‌طور صریح مشخص کرد: .RS 1.2i [algorithm-index] .RE .IP مقدارهای .I match-pattern عبارت‌های منظم توسعه‌یافته‌ای هستند که با مسیرهای مطلق درون سیستم‌فایل خروجی بدون اسلش اولیه تطبیق داده می‌شوند. .TP .BI "\-\-dsunit=" # تمام آدرس‌های بلوک داده را با مضارب # تراز می‌کند. .PP اگر هر دو گزینه \fI--dsunit\fR و \fI--chunksize\fR تنظیم شده باشند، در صورتی که \fI--dsunit\fR بزرگ‌تر از \fI--chunksize\fR باشد، \fI--dsunit\fR نادیده گرفته می‌شود. .PP اگر \fI--dsunit\fR بزرگ‌تر باشد، چندین چانک را در بر می‌گیرد، برای مثال: \fI-b 4096\fR، \fI--dsunit 512\fR (2MiB)، \fI--chunksize 4096\fR .PP به محض اینکه یک چانک تکرارزدایی (Deduplicate) شود، تمام چانک‌های بعدی دیگر تراز نخواهند بود. برای عملکرد بهینه، توصیه می‌شود \fI--dsunit\fR را برابر با مقدار \fI--chunksize\fR تنظیم کنید: .PP مثال: \fI-b\fR 4096, \fI--dsunit 512\fR (2MiB), \fI--chunksize $((4096*512))\fR .TP .BI "\-\-exclude-path=" path فایلی را که دقیقاً با مسیر متنی داده‌شده تطابق دارد نادیده می‌گیرد. می‌توانید چندین گزینه .B --exclude-path تعریف کنید. .TP .BI "\-\-exclude-regex=" regex فایل‌هایی را که با عبارت منظم توسعه‌یافته داده‌شده مطابقت دارند نادیده می‌گیرد. می‌توانید چندین گزینه .B --exclude-regex تعریف کنید. .TP .BI "\-\-file-contexts=" file پیکربندی‌ها و بازنویسی‌های برچسب SELinux را از فایل \fIfile\fR در قالب .BR selinux_file (5) می‌خواند. .TP .BI "\-\-force-uid=" UID شناسه کاربری (UID) تمام فایل‌ها را روی \fIUID\fR تنظیم می‌کند. .TP .BI "\-\-force-gid=" GID شناسه گروهی (GID) تمام فایل‌ها را روی \fIGID\fR تنظیم می‌کند. .TP .BI "\-\-fsalignblks=" # تراز اندازه دستگاه اصلی (معمولاً اندازه سیستم‌فایل) را بر حسب بلوک مشخص می‌کند. .TP .BI "\-\-gid-offset=" GIDOFFSET مقدار \fIGIDOFFSET\fR را به GID تمام فایل‌ها اضافه می‌کند. وقتی این گزینه همراه با .B --force-gid استفاده شود، مقدار نهایی gid فایل‌ها برابر با \fIGID\fR + \fIGIDOFFSET\fR خواهد بود. .TP .BI "\-\-gzinfo\fR[\fP=" file \fR]\fP (همراه با \fI--tar\fR استفاده می‌شود) اطلاعات zinfo سازگار با AWS SOCI را برای پشتیبانی از دسترسی تصادفی gzip تولید می‌کند. فایل مبدأ باید یک آرشیو تار فشرده‌شده با gzip باشد. .TP .BI "\-\-hard-dereference" پیوندهای سخت (Hardlinks) را دنبال کرده و آن‌ها را به عنوان اینودهای جداگانه اضافه می‌کند. .TP .B "\-\-ignore-mtime" زمان اصلاح فایل را در مواقعی که باعث می‌شود \fBmkfs.erofs\fR به‌جای اینودهای فشرده از اینودهای توسعه‌یافته استفاده کند، نادیده می‌گیرد. در صورت عدم استفاده از برچسب زمانی ثابت، این گزینه می‌تواند کل حجم متادیتا را کاهش دهد. این گزینه توسط .BR "-E force-inode-compact" به‌طور ضمنی فعال می‌شود. .TP .BI "\-\-incremental=" MODE یک ساخت افزایشی اجرا می‌کند که در آن DESTINATION یک تصویر EROFS موجود است، و داده‌های مشخص‌شده توسط SOURCE به‌صورت افزایشی به تصویر اضافه می‌شوند. \fIMODE\fR معنای یکسانی با بخش \fB\-\-clean\fR در بالا دارد. ساخت افزایشی برای مبداهای \fB\-\-s3\fR و \fB\-\-oci\fR پشتیبانی نمی‌شود. .PP اگر \fB\-\-incremental\fR بدون مقدار صریح مشخص شود، به‌صورت \fB\-\-incremental=data\fR رفتار می‌کند. .PP پشتیبانی حالت‌های \fIMODE\fR به تفکیک نوع مبدأ در حال حاضر: .RS 1.2i .TP .I مبدأ دایرکتوری محلی تنها حالت \fBdata\fR پشتیبانی می‌شود. حالت‌های \fBrvsp\fR و \fB0\fR نادیده گرفته می‌شوند. .TP .I مبدأ تار (\fB\-\-tar\fR) حالت‌های \fBdata\fR و \fBrvsp\fR پشتیبانی می‌شوند. حالت \fB0\fR نادیده گرفته می‌شود. توجه داشته باشید که \fBrvsp\fR اولویت بالاتری نسبت به \fB--tar=i\fR یا \fB--tar=headerball\fR دارد. .TP .I حالت بازسازی (Rebuild mode) تنها حالت \fBrvsp\fR پشتیبانی می‌شود. .RE .TP .BI "\-\-max-extent-bytes=" # حداکثر اندازه اکستنت غیرفشرده را بر حسب بایت مشخص می‌کند. مقدار پیش‌فرض نامحدود است. .TP .B \-\-mkfs-time (همراه با \fB-T\fR استفاده می‌شود) برچسب زمانی ارائه‌شده فقط روی زمان ساخت سیستم‌فایل اعمال می‌شود. .TP .BI "\-\-mount-point=" path پیشوند مسیر سیستم‌فایل هدف را مشخص می‌کند (پیش‌فرض: /). .TP .BI "\-\-oci\fR[\fP=\fR]\fP" یک تصویر کامل (f) یا فقط نمایه (i) از مبدأ راه دور OCI تولید می‌کند. گزینه‌های اضافی زیر قابل تعیین هستند: .RS 1.2i .TP .BI platform= platform پلتفرم را مشخص می‌کند (پیش‌فرض: linux/amd64). .TP .BI layer= # شاخص لایه را برای استخراج مشخص می‌کند (بر پایه صفر؛ در صورت حذف، تمام لایه‌ها استخراج می‌شوند). .TP .BI blob= digest دایجست حباب (Blob digest) را برای استخراج مشخص می‌کند (در صورت حذف، تمام لایه‌ها استخراج می‌شوند). .TP .BI username= username نام کاربری برای احراز هویت (اختیاری). .TP .BI password= password رمز عبور برای احراز هویت (اختیاری). .TP .B insecure استفاده از HTTP به‌جای HTTPS (اختیاری). .RE .TP .BI "\-\-offset=" # تعداد # بایت را در ابتدای تصویر نادیده می‌گیرد و رد می‌کند. .TP .BI "\-\-ovlfs-strip\fR[\fP=<0|1>\fR]\fP" متادیتای overlayfs (مانند whiteouts) را در تصویر هدف حذف می‌کند. .TP .B "\-\-preserve-mtime" در صورتی که زمان اصلاح فایل از محدوده اینودهای فشرده سرریز کند، از اینودهای توسعه‌یافته استفاده می‌کند. این حالت پیش‌فرض است و گزینه .B --ignore-mtime را لغو می‌کند. .TP .B "\-\-quiet" اجرای خاموش (هیچ پیامی در خروجی استاندارد چاپ نمی‌شود). .TP .BI "\-\-root-xattr-isize=" # اطمینان حاصل می‌کند که اندازه xattr درون‌خطی دایرکتوری ریشه حداقل # بایت باشد. .TP .BI "\-\-s3=" endpoint یک تصویر از مخزن اشیای سازگار با S3 تولید می‌کند. گزینه‌های اضافی زیر قابل تعیین هستند: .RS 1.2i .TP .BI passwd_file= file فایل رمز عبور سازگار با S3FS، با فرمت "accessKey:secretKey" در خط اول. .TP .BI urlstyle= style سبک فراخوانی API سرویس S3 (به‌صورت vhost یا path) (پیش‌فرض: vhost). .TP .BI sig= version نسخه امضای API سرویس S3 (مقدار 2 یا 4) (پیش‌فرض: 2). .TP .BI region= code کد منطقه‌ای (Region) که نقطه پایانی متعلق به آن است (برای sig=4 الزامی است). .RE .TP .BI "\-\-sort=" MODE ترتیب مرتب‌سازی داده‌های اینود را برای آرشیوهای تار به عنوان ورودی مشخص می‌کند. .PP \fIMODE\fR می‌تواند یکی از مقادیر \fBnone\fR یا \fBpath\fR باشد. .PP \fBnone\fR: هیچ ترتیب داده خاصی برای تصویر هدف مشخص نمی‌شود تا از بار اضافی جلوگیری گردد؛ در حال حاضر زمانی مؤثر است که `-E^inline_data` تعیین شده باشد و هیچ فشرده‌سازی اعمال نشود. .PP \fBpath\fR: ترتیب داده‌ها دقیقاً از ترتیب تولید درخت پیروی می‌کند (پیش‌فرض). .TP .BI "\-\-tar, \-\-tar=" MODE با \fIمبدأ\fR به‌جای یک دایرکتوری، به عنوان یک آرشیو تار یا یک «headerball» شبه‌تار رفتار می‌کند. .PP \fIMODE\fR می‌تواند یکی از مقادیر \fBf\fR، \fBi\fR، یا \fBheaderball\fR باشد. .PP \fBf\fR: یک تصویر EROFS کامل از یک آرشیو تار معمولی تولید می‌کند (پیش‌فرض). .PP \fBi\fR: یک تصویر EROFS حاوی فقط متادیتا از یک آرشیو تار معمولی تولید می‌کند. تنها متادیتایی مانند dentries، اینودها و xattrs به تصویر اضافه می‌شوند و داده‌های فایل حذف می‌شوند. کاربرد چنین تصاویری شامل استفاده به عنوان لایه در سیستم‌فایل overlay همراه با لایه‌های فقط داده است. .PP \fBheaderball\fR: یک تصویر EROFS حاوی فقط متادیتا از جریانی مشابه آرشیو تار تولید می‌کند، با این تفاوت که داده‌های فایل بعد از هر هدر فایل وجود ندارند. .TP .BI "\-\-uid-offset=" UIDOFFSET مقدار \fIUIDOFFSET\fR را به UID تمام فایل‌ها اضافه می‌کند. وقتی این گزینه همراه با .B --force-uid استفاده شود، مقدار نهایی uid فایل‌ها برابر با \fIUID\fR + \fIUIDOFFSET\fR خواهد بود. .TP .BI \-\-ungzip\fR[\fP= file \fR]\fP جریان‌های آرشیو تار را از فیلتر gzip عبور می‌دهد. به‌صورت اختیاری، جریان‌های خام نیز می‌توانند به‌طور هم‌زمان تخلیه شوند. .TP .BI \-\-unxz\fR[\fP= file \fR]\fP جریان‌های آرشیو تار را از فیلتر xz، lzma یا lzip عبور می‌دهد. به‌صورت اختیاری، جریان‌های خام نیز می‌توانند به‌طور هم‌زمان تخلیه شوند. .TP .BI "\-\-vmdk-desc=" FILE یک فایل توصیف‌گر VMDK برای ادغام زیرسیستم‌های فایل تولید می‌کند که می‌تواند برای نمایه تار یا حالت بازسازی استفاده شود. .TP .BI "\-\-workers=" # تعداد نخ‌های پردازشی (Worker threads) را روی # تنظیم می‌کند (پیش‌فرض: تعداد پردازنده‌ها). .TP .BI "\-\-xattr-inode-digest=" name نام ویژگی توسعه‌یافته (xattr) را برای ثبت دایجست‌های اینود مشخص می‌کند. .TP .BI "\-\-xattr-prefix=" PREFIX یک پیشوند سفارشی برای فضای نام ویژگی توسعه‌یافته جهت صرفه‌جویی در فضا مشخص می‌کند، مانند "trusted.overlay.". می‌توانید چندین گزینه .B --xattr-prefix ارائه دهید (لینوکس 6.4+). .TP .BI "\-\-zfeature-bits=" # ویژگی‌های فشرده‌سازی سیستم‌فایل را بر اساس بیت‌های داده‌شده # فعال یا غیرفعال می‌کند. هر بیت در این مقدار متناظر با یک ویژگی فشرده‌سازی خاص است: .RS 1.2i .nf .ft CW 7 6 5 4 3 2 1 0 (bit position) | | | | | | | | | | | | | | | +-- Bit 0 (1) : legacy-compress | | | | | | +---- Bit 1 (2) : ztailpacking | | | | | +------ Bit 2 (4) : fragments | | | | +-------- Bit 3 (8) : all-fragments | | | +---------- Bit 4 (16) : dedupe | | +------------ Bit 5 (32) : fragdedupe | +-------------- Bit 6 (64) : 48bit +---------------- Bit 7 (128) : dot-omitted .ft .fi .RE .IP برای مثال، گزینه .B --zfeature-bits=6 (در مبنای دو: 0000 0110) ویژگی‌های ztailpacking (بیت ۱) و fragments (بیت ۲) را فعال می‌کند. .RE .TP \fB\-h\fR, \fB\-\-help\fR نمایش پیام راهنما و خروج. .TP \fB\-V\fR, \fB\-\-version\fR چاپ شماره نسخه و خروج. .SH "نکات (NOTES)" .TP .B حالت بازسازی (REBUILD MODE) \fBحالت بازسازی\fR به \fBmkfs.erofs\fR امکان می‌دهد تا یک تصویر EROFS جدید از یک یا چند تصویر EROFS موجود که به عنوان \fIمبدأ\fR ارسال شده‌اند تولید کند. این حالت به‌ویژه برای ادغام چندین تصویر EROFS یا ایجاد تصاویر متادیتای فقط نمایه که به داده‌های درون تصاویر مبدأ ارجاع می‌دهند، بسیار سودمند است. .PP وقتی مبدأ شامل یک یا چند فایل تصویر EROFS باشد، .B mkfs.erofs به‌طور خودکار وارد حالت بازسازی می‌شود. این رفتار توسط گزینه‌های .B \-\-clean یا .B \-\-incremental کنترل می‌شود که نحوه مدیریت داده‌های فایل را مشخص می‌کنند: .RS 1.2i .TP .I حالت پیش‌فرض (نمایه حبابی / blob index) تصویر تولیدشده تنها حاوی متادیتا (اینودها، dentries و xattrs) است. داده‌های فایل از طریق نمایه‌های مبتنی بر چانک که به تصاویر مبدأ اصلی اشاره دارند، ارجاع داده می‌شوند که مانند دستگاه‌های حباب خارجی عمل می‌کنند. این کار یک لایه متادیتای فشرده مناسب برای سناریوهای سیستم‌فایل لایه‌ای، مشابه لایه‌های تصویر کانتینر، ایجاد می‌کند. .TP .I حالت داده (data mode) \fB\-\-clean=data\fR: داده‌های کامل فایل را از تمام تصاویر مبدأ به تصویر مقصد وارد کرده و یک تصویر EROFS کاملاً خودکفا تولید می‌کند که به دستگاه‌های حباب خارجی وابسته نیست. .TP .I حالت رزرو (rvsp mode) \fB\-\-clean=rvsp\fR یا \fB\-\-incremental=rvsp\fR: فضا را برای داده‌های فایل بدون کپی کردن محتوای واقعی رزرو می‌کند که برای ایجاد تصاویر خلوت (Sparse) بسیار کاربردی است. .RE .SH "نویسندگان (AUTHORS)" این نسخه از \fBmkfs.erofs\fR توسط Li Guifu ، Miao Xie و Gao Xiang با بهبودهای مداوم سایر مشارکت‌کنندگان نوشته شده است. .PP این صفحه راهنما توسط Gao Xiang نوشته شده است. .SH "در دسترس بودن (AVAILABILITY)" ابزار \fBmkfs.erofs\fR بخشی از بسته erofs-utils است و از نشانی git://git.kernel.org/pub/scm/linux/kernel/git/xiang/erofs-utils.git در دسترس است. .SH "همچنین ببینید (SEE ALSO)" .BR mkfs (8).