.Dd November 17, 2023 .Dt BCACHEFS 8 SMM .Os .Sh "نام (NAME)" .Nm bcachefs .Nd ابزار مدیریت سیستم فایل bcachefs .Sh "خلاصه دستور (SYNOPSIS)" .Nm .Ar command .Op Ar options .Op Ar arguments .Sh "توضیحات (DESCRIPTION)" ابزار .Nm از زیردستورات زیر پشتیبانی می‌کند که در ادامه با جزئیات مستند شده‌اند: .Ss "دستورات سوپربلاک (Superblock commands)" .Bl -tag -width 18n -compact .It Ic format قالب‌بندی یک یا فهرستی از دستگاه‌ها با ساختارهای داده bcachefs. .It Ic show-super تخلیه اطلاعات سوپربلاک در خروجی استاندارد. .It Ic set-fs-option تنظیم یک گزینه سیستم فایل .El .Ss "دستورات اتصال (Mount commands)" .Bl -tag -width 18n -compact .It Ic mount اتصال یک سیستم فایل. .El .Ss "دستورات تعمیر (Repair commands)" .Bl -tag -width 18n -compact .It Ic fsck بررسی یک سیستم فایل موجود برای یافتن خطاها. .El .Ss "دستورات مدیریت سیستم فایل در حال اجرا (Commands for managing a running filesystem)" .Bl -tag -width 18n -compact .It Ic fs usage نمایش میزان مصرف دیسک .It Ic fs top نمایش اطلاعات عملکرد در زمان اجرا .El .Ss "دستورات مدیریت دستگاه‌ها در یک سیستم فایل در حال اجرا (Commands for managing devices within a running filesystem)" .Bl -tag -width 22n -compact .It Ic device add افزودن یک دستگاه جدید به یک سیستم فایل موجود .It Ic device remove حذف یک دستگاه از یک سیستم فایل موجود .It Ic device online افزودن مجدد یک عضو موجود به یک سیستم فایل .It Ic device offline آفلاین کردن یک دستگاه، بدون حذف آن .It Ic device evacuate مهاجرت داده‌ها به بیرون از یک دستگاه مشخص .It Ic device set-state تنظیم وضعیت یک دستگاه .It Ic device resize تغییر اندازه سیستم فایل روی یک دستگاه .It Ic device resize-journal تغییر اندازه ژورنال روی یک دستگاه .El .Ss "دستورات مدیریت زیرحجم‌ها و اسنپ‌شات‌ها (Commands for managing subvolumes and snapshots)" .Bl -tag -width 18n -compact .It Ic subvolume create ایجاد یک زیرحجم جدید .It Ic subvolume delete حذف یک زیرحجم موجود .It Ic subvolume snapshot ایجاد یک اسنپ‌شات .It Ic subvolume list فهرست کردن زیرحجم‌ها .It Ic subvolume list-snapshots فهرست کردن اسنپ‌شات‌ها و مصرف دیسک آن‌ها .El .Ss "دستورات مدیریت داده‌های سیستم فایل (Commands for managing filesystem data)" .Bl -tag -width 18n -compact .It Ic reconcile پرس‌وجو یا انتظار برای تطبیق پس‌زمینه داده‌ها .It Ic scrub اعتبارسنجی چکسام‌های داده‌ها .El .Ss "دستورات رمزنگاری (Commands for encryption)" .Bl -tag -width 18n -compact .It Ic unlock باز کردن قفل یک سیستم فایل رمزنگاری‌شده پیش از اجرا یا اتصال .It Ic set-passphrase تغییر عبارت عبور در یک سیستم فایل موجود (متصل‌نشده) .It Ic remove-passphrase حذف عبارت عبور در یک سیستم فایل موجود (متصل‌نشده) .El .Ss "دستورات مهاجرت (Commands for migration)" .Bl -tag -width 18n -compact .It Ic migrate مهاجرت درجا از یک سیستم فایل موجود به bcachefs .It Ic migrate-superblock افزودن سوپربلاک پیش‌فرض، پس از bcachefs migrate .El .Ss "دستورات کار روی فایل‌ها در سیستم فایل bcachefs (Commands for operating on files in a bcachefs filesystem)" .Bl -tag -width 18n -compact .It Ic set-file-option تنظیم ویژگی‌های گوناگون به ازای هر فایل .El .Ss "دستورات اشکال‌زدایی (Commands for debugging)" .Bl -tag -width 18n -compact .It Ic dump تخلیه فراداده سیستم فایل در یک تصویر qcow2 .It Ic list فهرست کردن فراداده سیستم فایل در قالب متنی .It Ic list_journal فهرست کردن محتویات ژورنال .El .Ss "دستورات FUSE (FUSE commands)" .Bl -tag -width 18n -compact .It Ic fusemount Mount a filesystem via FUSE .El .Ss "دستورات متفرقه (Miscellaneous commands)" .Bl -tag -width 18n -compact .It Ic version نمایش نسخه ابزار فراخوانی‌شده bcachefs .It Ic completions تولید تکمیل‌های خط فرمان .El .Sh "دستورات سوپربلاک (Superblock commands)" .Bl -tag -width Ds .It Nm Ic format Oo Ar options Oc Ar devices\ ... قالب‌بندی یک یا فهرستی از دستگاه‌ها با ساختارهای داده bcachefs. باید این کار را پیش از ایجاد حجم انجام دهید. .Pp گزینه‌های مختص دستگاه باید پیش از دستگاه‌های مربوطه بیایند، به عنوان مثال: .Dl bcachefs format --label=ssd /dev/sda --label=hdd /dev/sdb .Bl -tag -width Ds .It Fl -block_size Ns = Ns Ar size اندازه بلوک به بایت (مثلاً 4k) .It Fl -btree_node_size Ns = Ns Ar size اندازه گره B-tree، پیش‌فرض 256k .It Fl -errors Ns = Ns ( Cm continue | ro | panic ) اقدام در هنگام بروز خطای سیستم فایل .It Fl -data_replicas Ns = Ns Ar number تعداد رونوشت‌های داده. با فعال بودن کدگذاری پاک‌شدگی (erasure coding)، این مقدار در حال حاضر به .Ar 3 .Pq RAID6 محدود است. .It Fl -metadata_replicas Ns = Ns Ar number تعداد رونوشت‌های فراداده .It Fl -encoded_extent_max Ns = Ns Ar size حداکثر اندازه اکستنت‌های دارای چکسام یا فشرده‌شده .It Fl -metadata_checksum Ns = Ns ( Cm none | crc32c | crc64 | xxhash ) تنظیم نوع چکسام فراداده (پیش‌فرض: .Cm crc32c ) . .It Fl -data_checksum Ns = Ns ( Cm none | crc32c | crc64 | xxhash ) تنظیم نوع چکسام داده (پیش‌فرض: .Cm crc32c ) . .It Fl -compression Ns = Ns ( Cm none | lz4 | gzip | zstd ) تنظیم نوع فشرده‌سازی (پیش‌فرض: .Cm none ) . .It Fl -background_compression Ns = Ns ( Cm none | lz4 | gzip | zstd ) .It Fl -str_hash Ns = Ns ( Cm crc32c | crc64 | siphash ) تابع هش برای ورودی‌های دایرکتوری و ویژگی‌های گسترش‌یافته (xattrs) .It Fl -metadata_target Ns = Ns Ar target دستگاه یا برچسب برای نوشتن‌های فراداده .It Fl -foreground_target Ns = Ns Ar target دستگاه یا برچسب برای نوشتن‌های پیش‌زمینه .It Fl -background_target Ns = Ns Ar target دستگاه یا برچسب برای انتقال داده‌ها در پس‌زمینه .It Fl -promote_target Ns = Ns Ar target دستگاه یا برچسب برای ارتقای داده‌ها هنگام خواندن .It Fl -erasure_code فعال‌سازی کدگذاری پاک‌شدگی (RAID5/6؛ رونوشت‌های داده به ۳ محدود است) .It Fl -inodes_32bit محدود کردن شماره‌های اینود به ۳۲ بیت .It Fl -shared_inode_numbers اشتراک‌گذاری شماره‌های اینود جدید بر پایه شناسه CPU .It Fl -inodes_use_key_cache استفاده از حافظه نهان کلید B-tree برای درخت اینودها .It Fl -gc_reserve_percent Ns = Ns Ar percentage درصد فضای دیسک برای رزرو برای copygc .It Fl -gc_reserve_bytes Ns = Ns Ar percentage مقدار فضای دیسک برای رزرو برای copygc .sp این گزینه در صورت تنظیم، بر .Cm gc_reserve_percent اولویت دارد .It Fl -root_reserve_percent Ns = Ns Ar percentage درصد فضای دیسک برای رزرو برای کاربر ارشد .It Fl -wide_macs ذخیره کامل ۱۲۸ بیت از MACهای رمزنگاری، به جای ۸۰ .It Fl -acl فعال‌سازی POSIX acl .It Fl -usrquota فعال‌سازی سهمیه‌بندی کاربر .It Fl -grpquota فعال‌سازی سهمیه‌بندی گروه .It Fl -prjquota فعال‌سازی سهمیه‌بندی پروژه .It Fl -journal_transaction_names ثبت نام توابع تراکنش در ژورنال .It Fl -nocow حالت Nocow: عملیات نوشتن در صورت امکان به صورت درجا انجام خواهد شد. .sp اسنپ‌شات‌ها و پیوندهای ارجاعی (reflink) همچنان موجب نوشتن به صورت COW خواهند شد. .sp این فلگ به طور ضمنی چکسام داده، فشرده‌سازی و رمزنگاری را غیرفعال می‌کند. .It Fl -replicas Ns = Ns Ar number تنظیم هم‌زمان رونوشت‌های داده و فراداده. .It Fl -encrypted فعال‌سازی رمزنگاری کل سیستم فایل (chacha20/poly1305)؛ عبارت عبور درخواست خواهد شد. .It Fl -no_passphrase ذخیره کلید رمزنگاری اصلی به صورت رمزنگاری‌نشده در سوپربلاک .It Fl L , Fl -fs_label Ns = Ns Ar label ایجاد سیستم فایل با .Ar label مشخص‌شده. این برچسب سیستم فایل است و از برچسب‌های مختص هر دستگاه که برای انتخاب هدف به کار می‌روند متمایز است. روی یک سیستم فایل متصل‌شده، این مقدار می‌تواند توسط ابزارهایی که فراخوانی استاندارد .Dv FS_IOC_SETFSLABEL ioctl در لینوکس را صادر می‌کنند تغییر یابد. .It Fl U , Fl -uuid Ns = Ns Ar uuid ایجاد سیستم فایل با .Ar uuid مشخص‌شده .It Fl -superblock_size Ns = Ns Ar size .El .Pp گزینه‌های مختص دستگاه: .Bl -tag -width Ds .It Fl -discard فعال‌سازی پشتیبانی از discard/TRIM .It Fl -fs_size Ns = Ns Ar size ایجاد سیستم فایل با استفاده از .Ar size بایت روی دستگاه بعدی. .It Fl -bucket Ns = Ns Ar size اندازه باکت را مشخص می‌کند؛ باید بزرگ‌تر از اندازه گره B-tree باشد .It Fl -durability Ns = Ns Ar n داده‌های نوشته‌شده در این دستگاه به عنوان داده‌هایی در نظر گرفته می‌شوند که از قبل .Ar n بار تکرار (replicated) شده‌اند .It Fl l , Fl -label برچسب دیسک .It Fl f , Fl -force اجبار به ایجاد سیستم فایل، حتی اگر دستگاه از قبل حاوی یک سیستم فایل باشد. .It Fl q , Fl -quiet فقط چاپ خطاها .It Fl v , Fl -verbose راه‌اندازی سیستم فایل با جزئیات کامل .El .It Nm Ic show-super Oo Ar options Oc Ar device تخلیه اطلاعات سوپربلاک در خروجی استاندارد. .Bl -tag -width Ds .It Fl f , Fl -fields Ns = Ns Ar fields فهرست بخش‌ها برای چاپ .It Fl l , Fl -layout چاپ چیدمان سوپربلاک .El .It Nm Ic set-fs-option Oo Ar options Oc Ar device .Bl -tag -width Ds .It Fl -errors Ns = Ns ( Cm continue | ro | panic ) اقدام در هنگام بروز خطای سیستم فایل .It Fl -metadata_replicas Ns = Ns Ar number تعداد رونوشت‌های فراداده .It Fl -data_replicas Ns = Ns Ar number تعداد رونوشت‌های داده. با فعال بودن کدگذاری پاک‌شدگی، این مقدار در حال حاضر به .Ar 3 .Pq RAID6 محدود است. .It Fl -metadata_checksum Ns = Ns ( Cm none | crc32c | crc64 | xxhash ) تنظیم نوع چکسام فراداده (پیش‌فرض: .Cm crc32c ) . .It Fl -data_checksum Ns = Ns ( Cm none | crc32c | crc64 | xxhash ) تنظیم نوع چکسام داده (پیش‌فرض: .Cm crc32c ) . .It Fl -compression Ns = Ns ( Cm none | lz4 | gzip | zstd ) تنظیم نوع فشرده‌سازی (پیش‌فرض: .Cm none ) . .It Fl -background_compression Ns = Ns ( Cm none | lz4 | gzip | zstd ) .It Fl -str_hash Ns = Ns ( Cm crc32c | crc64 | siphash ) تابع هش برای ورودی‌های دایرکتوری و ویژگی‌های گسترش‌یافته .It Fl -metadata_target Ns = Ns Ar target دستگاه یا برچسب برای نوشتن‌های فراداده .It Fl -foreground_target Ns = Ns Ar target دستگاه یا برچسب برای نوشتن‌های پیش‌زمینه .It Fl -background_target Ns = Ns Ar target دستگاه یا برچسب برای انتقال داده‌ها در پس‌زمینه .It Fl -promote_target Ns = Ns Ar target دستگاه یا برچسب برای ارتقای داده‌ها هنگام خواندن .It Fl -erasure_code فعال‌سازی کدگذاری پاک‌شدگی (RAID5/6؛ رونوشت‌های داده به ۳ محدود است) .It Fl -inodes_32bit محدود کردن شماره‌های اینود به ۳۲ بیت .It Fl -shared_inode_numbers اشتراک‌گذاری شماره‌های اینود جدید بر پایه شناسه CPU .It Fl -inodes_use_key_cache استفاده از حافظه نهان کلید B-tree برای درخت اینودها .It Fl -gc_reserve_percent Ns = Ns Ar percentage درصد فضای دیسک برای رزرو برای copygc .It Fl -gc_reserve_bytes Ns = Ns Ar percentage مقدار فضای دیسک برای رزرو برای copygc .sp این گزینه در صورت تنظیم، بر .Cm gc_reserve_percent اولویت دارد .It Fl -root_reserve_percent Ns = Ns Ar percentage درصد فضای دیسک برای رزرو برای کاربر ارشد .It Fl -wide_macs ذخیره کامل ۱۲۸ بیت از MACهای رمزنگاری، به جای ۸۰ .It Fl -acl فعال‌سازی POSIX acl .It Fl -usrquota فعال‌سازی سهمیه‌بندی کاربر .It Fl -grpquota فعال‌سازی سهمیه‌بندی گروه .It Fl -prjquota فعال‌سازی سهمیه‌بندی پروژه .It Fl -degraded اجازه اتصال در حالت تقلیل‌یافته (degraded mode) .It Fl -very_degraded اجازه اتصال در شرایطی که داده‌ها مفقود خواهند بود .It Fl -discard فعال‌سازی پشتیبانی از discard/TRIM .It Fl -verbose اطلاعات اشکال‌زدایی اضافی هنگام اتصال یا بازیابی .It Fl -journal_flush_delay Ns = Ns Ar ms تأخیر به میلی‌ثانیه پیش از اعمال خودکار ژورنال .It Fl -journal_flush_disabled غیرفعال‌سازی تخلیه ژورنال هنگام sync/fsync .sp در صورت فعال بودن، نوشتن‌ها می‌توانند از دست بروند، اما فقط از زمان آخرین نوشتن ژورنال (پیش‌فرض ۱ ثانیه) .It Fl -journal_reclaim_delay Ns = Ns Ar ms تأخیر به میلی‌ثانیه پیش از بازپس‌گیری خودکار ژورنال .It Fl -move_bytes_in_flight Ns = Ns Ar bytes حداکثر مقدار ورودی/خروجی فعال در مسیر انتقال داده .It Fl -move_ios_in_flight Ns = Ns Ar number حداکثر تعداد عملیات ورودی/خروجی فعال در مسیر انتقال داده .It Fl -fsck اجرای fsck هنگام اتصال .It Fl -fix_errors Ns = Ns Ar error اصلاح خطاها در حین fsck بدون پرسش .It Fl -ratelimit_errors محدود کردن نرخ پیام‌های خطا در حین fsck .It Fl -nochanges حالت فوق‌العاده فقط‌خواندنی - هیچ عملیات نوشتنی به هیچ وجه صادر نخواهد شد، حتی اگر مجبور به بازپخش ژورنال باشیم .It Fl -norecovery عدم بازپخش ژورنال .It Fl -journal_transaction_names ثبت نام توابع تراکنش در ژورنال .It Fl -noexcl دستگاه در حالت انحصاری باز نشود .It Fl -direct_io استفاده از O_DIRECT (فقط در فضای کاربری) .It Fl -sb Ns = Ns Ar offset آفست سکتور سوپربلاک .It Fl -reconstruct_alloc بازسازی B-tree تخصیص (alloc) .It Fl -version_upgrade Ns = Ns ( Cm compatible | incompatible | none ) تنظیم سوپربلاک به آخرین نسخه، تا استفاده از هر قابلیت جدیدی ممکن شود .Pp .Cm compatible حالت پیش‌فرض است: ارتقاهای سازگار فراداده ممکن است به طور خودکار اعمال شوند، و هنگامی که سیستم فایل با یک هسته قدیمی‌تر متصل شود، ممکن است همچنان فیلدهای نسخه سازگار را تنزل دهد. از .Cm incompatible تنها برای یک ارتقای عمدی یک‌طرفه فراداده استفاده کنید که ممکن است مانع اتصال با هسته‌های قدیمی‌تر شود، و از .Cm none برای جلوگیری از ارتقاهای اختیاری نسخه استفاده کنید. .It Fl -nocow حالت Nocow: عملیات نوشتن در صورت امکان به صورت درجا انجام خواهد شد. .sp اسنپ‌شات‌ها و پیوندهای ارجاعی همچنان موجب نوشتن به صورت COW خواهند شد. .sp این فلگ به طور ضمنی چکسام داده، فشرده‌سازی و رمزنگاری را غیرفعال می‌کند. .It Fl -nocow_enabled فعال‌سازی حالت nocow: فعال‌سازی قفل‌گذاری زمان اجرا در مسیر انتقال داده که در صورت استفاده از nocow مورد نیاز است .It Fl -no_data_io صرف‌نظر کردن از submit_bio() برای خواندن‌ها و نوشتن‌های داده، به منظور اهداف آزمون عملکرد .El .El .Sh "دستورات اتصال (Mount commands)" .Bl -tag -width Ds .It Nm Ic mount Oo Ar options Oc Ar device mountpoint مسیر .Ic mount Fl t Cm bcachefs ابزار کمکی نصب‌شده .Nm mount.bcachefs را فراخوانی می‌کند؛ این همان مسیر اتصالی است که به عنوان .Nm Ic mount ارائه می‌شود. .Pp اتصال یک سیستم فایل. .Ar device می‌تواند یک دستگاه، فهرستی از دستگاه‌ها جداشده با دو نقطه، UUID=، OLD_BLKID_UUID=، یا LABEL=