نام (NAME)

bcachefs — ابزار مدیریت سیستم فایل bcachefs

خلاصه دستور (SYNOPSIS)

bcachefs command [options] [arguments]

توضیحات (DESCRIPTION)

ابزار bcachefs از زیردستورات زیر پشتیبانی می‌کند که در ادامه با جزئیات مستند شده‌اند:

دستورات سوپربلاک (Superblock commands)

bcachefs format [options] devices ...

قالب‌بندی یک یا فهرستی از دستگاه‌ها با ساختارهای داده bcachefs. باید این کار را پیش از ایجاد حجم انجام دهید.

گزینه‌های مختص دستگاه باید پیش از دستگاه‌های مربوطه بیایند، به عنوان مثال:

bcachefs format --label=ssd /dev/sda --label=hdd /dev/sdb

--block_size=size

اندازه بلوک به بایت (مثلاً 4k)

--btree_node_size=size

اندازه گره B-tree، پیش‌فرض 256k

--errors=(continue | ro | panic)

اقدام در هنگام بروز خطای سیستم فایل

--data_replicas=number

تعداد رونوشت‌های داده. با فعال بودن کدگذاری پاک‌شدگی (erasure coding)، این مقدار در حال حاضر به 3 (RAID6) محدود است.

--metadata_replicas=number

تعداد رونوشت‌های فراداده

--encoded_extent_max=size

حداکثر اندازه اکستنت‌های دارای چکسام یا فشرده‌شده

--metadata_checksum=(none | crc32c | crc64 | xxhash)

تنظیم نوع چکسام فراداده (پیش‌فرض: crc32c).

--data_checksum=(none | crc32c | crc64 | xxhash)

تنظیم نوع چکسام داده (پیش‌فرض: crc32c).

--compression=(none | lz4 | gzip | zstd)

تنظیم نوع فشرده‌سازی (پیش‌فرض: none).

--background_compression=(none | lz4 | gzip | zstd)

--str_hash=(crc32c | crc64 | siphash)

تابع هش برای ورودی‌های دایرکتوری و ویژگی‌های گسترش‌یافته (xattrs)

--metadata_target=target

دستگاه یا برچسب برای نوشتن‌های فراداده

--foreground_target=target

دستگاه یا برچسب برای نوشتن‌های پیش‌زمینه

--background_target=target

دستگاه یا برچسب برای انتقال داده‌ها در پس‌زمینه

--promote_target=target

دستگاه یا برچسب برای ارتقای داده‌ها هنگام خواندن

--erasure_code

فعال‌سازی کدگذاری پاک‌شدگی (RAID5/6؛ رونوشت‌های داده به ۳ محدود است)

--inodes_32bit

محدود کردن شماره‌های اینود به ۳۲ بیت

--shared_inode_numbers

اشتراک‌گذاری شماره‌های اینود جدید بر پایه شناسه CPU

--inodes_use_key_cache

استفاده از حافظه نهان کلید B-tree برای درخت اینودها

--gc_reserve_percent=percentage

درصد فضای دیسک برای رزرو برای copygc

--gc_reserve_bytes=percentage

مقدار فضای دیسک برای رزرو برای copygc

این گزینه در صورت تنظیم، بر gc_reserve_percent اولویت دارد

--root_reserve_percent=percentage

درصد فضای دیسک برای رزرو برای کاربر ارشد

--wide_macs

ذخیره کامل ۱۲۸ بیت از MACهای رمزنگاری، به جای ۸۰

--acl

فعال‌سازی POSIX acl

--usrquota

فعال‌سازی سهمیه‌بندی کاربر

--grpquota

فعال‌سازی سهمیه‌بندی گروه

--prjquota

فعال‌سازی سهمیه‌بندی پروژه

--journal_transaction_names

ثبت نام توابع تراکنش در ژورنال

--nocow

حالت Nocow: عملیات نوشتن در صورت امکان به صورت درجا انجام خواهد شد.

اسنپ‌شات‌ها و پیوندهای ارجاعی (reflink) همچنان موجب نوشتن به صورت COW خواهند شد.

این فلگ به طور ضمنی چکسام داده، فشرده‌سازی و رمزنگاری را غیرفعال می‌کند.

--replicas=number

تنظیم هم‌زمان رونوشت‌های داده و فراداده.

--encrypted

فعال‌سازی رمزنگاری کل سیستم فایل (chacha20/poly1305)؛ عبارت عبور درخواست خواهد شد.

--no_passphrase

ذخیره کلید رمزنگاری اصلی به صورت رمزنگاری‌نشده در سوپربلاک

-L, --fs_label=label

ایجاد سیستم فایل با label مشخص‌شده. این برچسب سیستم فایل است و از برچسب‌های مختص هر دستگاه که برای انتخاب هدف به کار می‌روند متمایز است. روی یک سیستم فایل متصل‌شده، این مقدار می‌تواند توسط ابزارهایی که فراخوانی استاندارد FS_IOC_SETFSLABEL ioctl در لینوکس را صادر می‌کنند تغییر یابد.

-U, --uuid=uuid

ایجاد سیستم فایل با uuid مشخص‌شده

--superblock_size=size

گزینه‌های مختص دستگاه:

--discard

فعال‌سازی پشتیبانی از discard/TRIM

--fs_size=size

ایجاد سیستم فایل با استفاده از size بایت روی دستگاه بعدی.

--bucket=size

اندازه باکت را مشخص می‌کند؛ باید بزرگ‌تر از اندازه گره B-tree باشد

--durability=n

داده‌های نوشته‌شده در این دستگاه به عنوان داده‌هایی در نظر گرفته می‌شوند که از قبل n بار تکرار (replicated) شده‌اند

-l, --label

برچسب دیسک

-f, --force

اجبار به ایجاد سیستم فایل، حتی اگر دستگاه از قبل حاوی یک سیستم فایل باشد.

-q, --quiet

فقط چاپ خطاها

-v, --verbose

راه‌اندازی سیستم فایل با جزئیات کامل

bcachefs show-super [options] device

تخلیه اطلاعات سوپربلاک در خروجی استاندارد.

-f, --fields=fields

فهرست بخش‌ها برای چاپ

-l, --layout

چاپ چیدمان سوپربلاک

bcachefs set-fs-option [options] device

--errors=(continue | ro | panic)

اقدام در هنگام بروز خطای سیستم فایل

--metadata_replicas=number

تعداد رونوشت‌های فراداده

--data_replicas=number

تعداد رونوشت‌های داده. با فعال بودن کدگذاری پاک‌شدگی، این مقدار در حال حاضر به 3 (RAID6) محدود است.

--metadata_checksum=(none | crc32c | crc64 | xxhash)

تنظیم نوع چکسام فراداده (پیش‌فرض: crc32c).

--data_checksum=(none | crc32c | crc64 | xxhash)

تنظیم نوع چکسام داده (پیش‌فرض: crc32c).

--compression=(none | lz4 | gzip | zstd)

تنظیم نوع فشرده‌سازی (پیش‌فرض: none).

--background_compression=(none | lz4 | gzip | zstd)

--str_hash=(crc32c | crc64 | siphash)

تابع هش برای ورودی‌های دایرکتوری و ویژگی‌های گسترش‌یافته

--metadata_target=target

دستگاه یا برچسب برای نوشتن‌های فراداده

--foreground_target=target

دستگاه یا برچسب برای نوشتن‌های پیش‌زمینه

--background_target=target

دستگاه یا برچسب برای انتقال داده‌ها در پس‌زمینه

--promote_target=target

دستگاه یا برچسب برای ارتقای داده‌ها هنگام خواندن

--erasure_code

فعال‌سازی کدگذاری پاک‌شدگی (RAID5/6؛ رونوشت‌های داده به ۳ محدود است)

--inodes_32bit

محدود کردن شماره‌های اینود به ۳۲ بیت

--shared_inode_numbers

اشتراک‌گذاری شماره‌های اینود جدید بر پایه شناسه CPU

--inodes_use_key_cache

استفاده از حافظه نهان کلید B-tree برای درخت اینودها

--gc_reserve_percent=percentage

درصد فضای دیسک برای رزرو برای copygc

--gc_reserve_bytes=percentage

مقدار فضای دیسک برای رزرو برای copygc

این گزینه در صورت تنظیم، بر gc_reserve_percent اولویت دارد

--root_reserve_percent=percentage

درصد فضای دیسک برای رزرو برای کاربر ارشد

--wide_macs

ذخیره کامل ۱۲۸ بیت از MACهای رمزنگاری، به جای ۸۰

--acl

فعال‌سازی POSIX acl

--usrquota

فعال‌سازی سهمیه‌بندی کاربر

--grpquota

فعال‌سازی سهمیه‌بندی گروه

--prjquota

فعال‌سازی سهمیه‌بندی پروژه

--degraded

اجازه اتصال در حالت تقلیل‌یافته (degraded mode)

--very_degraded

اجازه اتصال در شرایطی که داده‌ها مفقود خواهند بود

--discard

فعال‌سازی پشتیبانی از discard/TRIM

--verbose

اطلاعات اشکال‌زدایی اضافی هنگام اتصال یا بازیابی

--journal_flush_delay=ms

تأخیر به میلی‌ثانیه پیش از اعمال خودکار ژورنال

--journal_flush_disabled

غیرفعال‌سازی تخلیه ژورنال هنگام sync/fsync

در صورت فعال بودن، نوشتن‌ها می‌توانند از دست بروند، اما فقط از زمان آخرین نوشتن ژورنال (پیش‌فرض ۱ ثانیه)

--journal_reclaim_delay=ms

تأخیر به میلی‌ثانیه پیش از بازپس‌گیری خودکار ژورنال

--move_bytes_in_flight=bytes

حداکثر مقدار ورودی/خروجی فعال در مسیر انتقال داده

--move_ios_in_flight=number

حداکثر تعداد عملیات ورودی/خروجی فعال در مسیر انتقال داده

--fsck

اجرای fsck هنگام اتصال

--fix_errors=error

اصلاح خطاها در حین fsck بدون پرسش

--ratelimit_errors

محدود کردن نرخ پیام‌های خطا در حین fsck

--nochanges

حالت فوق‌العاده فقط‌خواندنی - هیچ عملیات نوشتنی به هیچ وجه صادر نخواهد شد، حتی اگر مجبور به بازپخش ژورنال باشیم

--norecovery

عدم بازپخش ژورنال

--journal_transaction_names

ثبت نام توابع تراکنش در ژورنال

--noexcl

دستگاه در حالت انحصاری باز نشود

--direct_io

استفاده از O_DIRECT (فقط در فضای کاربری)

--sb=offset

آفست سکتور سوپربلاک

--reconstruct_alloc

بازسازی B-tree تخصیص (alloc)

--version_upgrade=(compatible | incompatible | none)

تنظیم سوپربلاک به آخرین نسخه، تا استفاده از هر قابلیت جدیدی ممکن شود

compatible حالت پیش‌فرض است: ارتقاهای سازگار فراداده ممکن است به طور خودکار اعمال شوند، و هنگامی که سیستم فایل با یک هسته قدیمی‌تر متصل شود، ممکن است همچنان فیلدهای نسخه سازگار را تنزل دهد. از incompatible تنها برای یک ارتقای عمدی یک‌طرفه فراداده استفاده کنید که ممکن است مانع اتصال با هسته‌های قدیمی‌تر شود، و از none برای جلوگیری از ارتقاهای اختیاری نسخه استفاده کنید.

--nocow

حالت Nocow: عملیات نوشتن در صورت امکان به صورت درجا انجام خواهد شد.

اسنپ‌شات‌ها و پیوندهای ارجاعی همچنان موجب نوشتن به صورت COW خواهند شد.

این فلگ به طور ضمنی چکسام داده، فشرده‌سازی و رمزنگاری را غیرفعال می‌کند.

--nocow_enabled

فعال‌سازی حالت nocow: فعال‌سازی قفل‌گذاری زمان اجرا در مسیر انتقال داده که در صورت استفاده از nocow مورد نیاز است

--no_data_io

صرف‌نظر کردن از submit_bio() برای خواندن‌ها و نوشتن‌های داده، به منظور اهداف آزمون عملکرد

دستورات اتصال (Mount commands)

bcachefs mount [options] device mountpoint

مسیر mount -t bcachefs ابزار کمکی نصب‌شده mount.bcachefs را فراخوانی می‌کند؛ این همان مسیر اتصالی است که به عنوان bcachefs mount ارائه می‌شود.

اتصال یک سیستم فایل. device می‌تواند یک دستگاه، فهرستی از دستگاه‌ها جداشده با دو نقطه، UUID=<UUID>، OLD_BLKID_UUID=<UUID>، یا LABEL=<label> باشد. زمانی که systemd مقدار UUID=<UUID> را پیش از آنکه ابزار کمکی اتصال bcachefs بتواند تمام اعضا را پویش کند مصرف می‌کند، از OLD_BLKID_UUID=<UUID> در مدخل‌های fstab استفاده کنید. mountpoint مسیری است که سیستم فایل باید در آن متصل شود. اگر تنظیم نشود، سیستم فایل در واقع متصل نخواهد شد اما تمام مراحل پیش از اتصال سیستم فایل (مانند درخواست عبارت عبور) همچنان انجام خواهند شد.

-o options

گزینه‌های اتصال که به صورت یک فهرست جداشده با کاما ارائه می‌شوند. برای فهرست کامل به راهنمای کاربر مراجعه کنید.

degraded

اجازه اتصال با دستگاه‌های مفقود. از degraded=yes برای مجاز کردن عملکرد عادی با وجود دستگاه‌های مفقود استفاده کنید، و از degraded=very تنها زمانی که حتی در صورت عدم امکان نگهداری تعداد رونوشت درخواستی، نوشتن‌ها مجاز به ادامه باشند.

از اتصال‌های خواندن-نوشتن تقلیل‌یافته (degraded) برای بازیابی و نگهداری در شرایطی که برخی اعضا موقتاً در دسترس نیستند استفاده کنید. زیرمجموعه‌های متفاوتی از یک سیستم فایل یکسان را به صورت خواندن-نوشتن متصل نکنید، یا یک زیرمجموعه را به صورت خواندن-نوشتن و سپس بعداً زیرمجموعه دیگری را پیش از تجمیع کامل سیستم فایل و تطبیق آن به صورت خواندن-نوشتن متصل ننمایید. این کار تاریخچه مغز دوشقه (split-brain) ایجاد می‌کند: هر زیرمجموعه می‌تواند نوشتن‌هایی را بپذیرد که زیرمجموعه دیگر هرگز ندیده است، و هنگامی که اعضا بعداً دوباره گرد هم آورده شوند ممکن است هیچ مقدار واحد صحیحی برای فایل‌های متناقض وجود نداشته باشد.

در صورت تردید، سیستم‌های فایل تقلیل‌یافته را تا زمان در دسترس قرار گرفتن اعضای مفقود به صورت فقط‌خواندنی متصل کنید، یا پیش از اجازه نوشتن، سیستم فایل کامل را تجمیع نمایید.

verbose

اطلاعات اشکال‌زدایی اضافی هنگام اتصال یا بازیابی

fsck

اجرای fsck هنگام اتصال

fix_errors

اصلاح خطاها بدون پرسش هنگام fsck

read_only

اتصال در حالت فقط‌خواندنی

version_upgrade

ارتقای نسخه

-k, --key-location=(fail | wait | ask)

محل بارگذاری رمز عبور. (پیش‌فرض: ask).

fail

عدم درخواست رمز عبور، در صورتی که سیستم فایل رمزنگاری شده باشد ناموفق شود.

wait

انتظار برای در دسترس قرار گرفتن رمز عبور پیش از اتصال.

ask

درخواست رمز عبور از کاربر.

-c, --colorize=(true | false)

اجبار به روشن یا خاموش کردن رنگ. پیش‌فرض: تشخیص خودکار TTY

-n, --no-mtab

عدم به‌روزرسانی /etc/mtab. این گزینه برای سازگاری با mount(8) پذیرفته شده است؛ bcachefs مستقیماً از فراخوانی سیستمی mount استفاده می‌کند و /etc/mtab را به‌روزرسانی نمی‌کند.

-f, --fake

انجام همه کارها به جز فراخوانی سیستمی واقعی mount. برای سازگاری با mount(8) پذیرفته شده است.

-s, --sloppy

نادیده گرفتن گزینه‌های ناشناخته اتصال به جای ناموفق شدن. برای سازگاری با mount(8) پذیرفته شده است؛ bcachefs از قبل گزینه‌های ناشناخته را نادیده می‌گیرد.

-v

حالت پرگویی. می‌تواند بیش از یک بار مشخص شود.

دستورات تعمیر (Repair commands)

bcachefs fsck [options] devices ...

بررسی یک سیستم فایل موجود برای یافتن خطاها.

-p

تعمیر خودکار (بدون پرسش)

-n

عدم تعمیر، فقط بررسی خطاها

-y

فرض کردن پاسخ «بله» به تمام پرسش‌ها

-f

اجبار به بررسی حتی اگر سیستم فایل تمیز علامت‌گذاری شده باشد

-r, --ratelimit_errors

عدم نمایش بیش از ۱۰ خطا از یک نوع مشخص

-R, --reconstruct_alloc

بازسازی B-tree تخصیص (alloc)

-v

حالت پرگویی

دستورات مدیریت سیستم فایل در حال اجرا (Commands for managing a running filesystem)

bcachefs fs usage [options] [filesystem]

نمایش میزان مصرف دیسک.

-h, --human-readable

چاپ اندازه‌ها به صورت خوانا برای انسان.

bcachefs fs top [options] [filesystem]

نمایش شمارنده‌های زنده عملکرد سیستم فایل. هنگامی که خروجی استاندارد یک پایانه باشد، این کار یک نمایش تعاملی را آغاز می‌کند. زمانی که خروجی استاندارد یک پایانه نباشد، یک نمونه چاپ کرده و خارج می‌شود.

-h, --human-readable

چاپ اندازه‌ها به صورت خوانا برای انسان.

--once

چاپ یک نمونه و خروج؛ معادل با تعیین تعداد ۱.

-n, --count=count

چاپ count نمونه و خروج. تعداد ۰ نمایش تعاملی را در حال اجرا نگه می‌دارد.

-d, --delay=seconds

تأخیر میان نمونه‌ها، به ثانیه.

دستورات مدیریت دستگاه‌ها در یک سیستم فایل در حال اجرا (Commands for managing devices within a running filesystem)

bcachefs device add [options] device

افزودن یک دستگاه به یک سیستم فایل موجود.

--fs_size=size

اندازه سیستم فایل روی دستگاه

--bucket=size

تنظیم اندازه باکت

--discard

فعال‌سازی discard

-l, --label=label

برچسب دیسک

-f, --force

استفاده از دستگاه حتی اگر به نظر برسد که از قبل قالب‌بندی شده است

bcachefs device remove [options] device

حذف یک دستگاه از یک سیستم فایل

-f, --force

اجبار به حذف، حتی اگر برخی داده‌ها قابل انتقال نباشند

-F, --force-metadata

اجبار به حذف، حتی اگر برخی فراداده‌ها قابل انتقال نباشند

bcachefs device online device

افزودن مجدد یک دستگاه به یک سیستم فایل در حال اجرا

bcachefs device offline device

آفلاین کردن یک دستگاه، بدون حذف آن

-f, --force

اجبار، در صورتی که افزونگی داده‌ها کاهش یابد

bcachefs device evacuate device

انتقال داده‌ها به بیرون از یک دستگاه مشخص

bcachefs device set-state [options] new-state device

new-state=(rw | ro | evacuating | spare)

وضعیت جدید عضو. از rw برای لغو تخلیه در حال انجام و بازگرداندن دستگاه به استفاده عادی استفاده کنید.

-f, --force

اجبار، در صورتی که افزونگی داده‌ها کاهش یابد

--force-if-data-lost

اجبار، در صورتی که داده‌ها از دست بروند

-o, --offline

تنظیم وضعیت یک دستگاه آفلاین

bcachefs device resize device [size]

تغییر اندازه سیستم فایل روی یک دستگاه. کوچک‌سازی آنلاین به هسته سیستم فایل متصل‌شده منتقل می‌شود؛ اگر آن هسته از کوچک‌سازی پشتیبانی نکند، فراخوانی ioctl تغییر اندازه با شکست مواجه می‌شود. کوچک‌سازی آفلاین هنوز توسط پیاده‌سازی سیستم فایل ارائه‌شده در فضای کاربری پشتیبانی نمی‌شود.

bcachefs device resize-journal device [size]

تغییر اندازه ژورنال روی یک دستگاه

دستورات مدیریت زیرحجم‌ها و اسنپ‌شات‌ها (Commands for managing subvolumes and snapshots)

subvolume create [options] path

ایجاد یک زیرحجم جدید

subvolume delete [options] path

حذف یک زیرحجم موجود

ریشه‌های زیرحجم ممکن است به عنوان ریشه‌های زیرحجم تغییر نام داده شده یا جابه‌جا شوند. فایل‌ها و دایرکتوری‌های عادی نمی‌توانند در سراسر مرزهای زیرحجم تغییر نام یابند؛ هنگام سازمان‌دهی مجدد محتوا میان زیرحجم‌ها، داده‌ها را کپی کنید یا از پیوند ارجاعی (reflink) استفاده نمایید.

subvolume snapshot [options] source dest

ایجاد یک اسنپ‌شات از source در dest. در صورت تعیین، source باید یک زیرحجم باشد؛ در صورت عدم تعیین، اسنپ‌شات از زیرحجم حاوی dest ایجاد خواهد شد.

-r

فقط‌خواندنی کردن اسنپ‌شات

subvolume list [options] target

فهرست کردن زیرحجم‌ها در یک سیستم فایل متصل‌شده.

--json

خروجی JSON با قابلیت خواندن ماشینی.

-t, --tree

نمایش یک نمای سلسله‌مراتبی.

-R, --recursive

فهرست کردن بازگشتی زیرحجم‌ها.

-s, --snapshots

شامل کردن زیرحجم‌های اسنپ‌شات.

--readonly

تنها نمایش زیرحجم‌های فقط‌خواندنی.

--sort=(name | size | time)

مرتب‌سازی خروجی.

subvolume list-snapshots [options] target

فهرست کردن اسنپ‌شات‌ها و مصرف دیسک آن‌ها در یک سیستم فایل متصل‌شده.

-f, --flat

نمایش یک فهرست مسطح به جای درخت پیش‌فرض.

-R, --recursive

فهرست کردن درخت‌های اسنپ‌شات برای زیرحجم‌های تودرتو نیز.

--json

خروجی JSON با قابلیت خواندن ماشینی، شامل شناسه‌های اسنپ‌شات و روابط والد.

--readonly

تنها نمایش اسنپ‌شات‌های فقط‌خواندنی در نمای مسطح.

--sort=(name | size | time)

مرتب‌سازی خروجی مسطح.

دستورات مدیریت داده‌های سیستم فایل (Commands for managing filesystem data)

bcachefs scrub [-m | --metadata] filesystem

اعتبارسنجی چکسام‌ها و اصلاح خطاها، در صورت امکان. هنگامی که scrub خطاهای چکسام را پیدا می‌کند، مسیرهای فایل تحت تأثیر در حال حاضر در گزارش وقایع هسته گزارش می‌شوند.

-m, --metadata

تنها بررسی فراداده

bcachefs reconcile status [-t type[,...]]

[filesystem] نمایش کارهای معوقه تطبیق در پس‌زمینه. تطبیق (reconcile) افزونگی را پس از یک اتصال تقلیل‌یافته یا جایگزینی دستگاه بازیابی می‌کند؛ سیستم‌های فایل متصل‌شده همچنین زمانی که اکستنت‌های تقلیل‌یافته شناسایی شوند، کارهای تطبیق را به صورت خودکار در صف قرار می‌دهند.

-t, --types type[,...]

محدود کردن خروجی به انواع تطبیق انتخاب‌شده.

bcachefs reconcile wait [-t type[,...]]

[filesystem] انتظار برای به پایان رسیدن کارهای تطبیق در پس‌زمینه.

-t, --types type[,...]

انتظار تنها برای انواع تطبیق انتخاب‌شده.

دستورات رمزنگاری (Commands for encryption)

bcachefs unlock device

باز کردن قفل یک سیستم فایل رمزنگاری‌شده پیش از اجرا یا اتصال.

-c

بررسی اینکه آیا دستگاه رمزنگاری شده است یا خیر

-k=(session | user | user_session)

دسته‌کلید (Keyring) برای افزودن به آن (پیش‌فرض: user)

bcachefs set-passphrase devices ...

تغییر عبارت عبور در یک سیستم فایل رمزنگاری‌شده موجود (متصل‌نشده). این کار کلید رمزنگاری موجود سیستم فایل را مجدداً بسته‌بندی می‌کند (rewraps)؛ رمزنگاری را در سیستم فایلی که بدون --encrypted قالب‌بندی شده است فعال نمی‌کند.

bcachefs remove-passphrase devices ...

حذف محافظت عبارت عبور از یک سیستم فایل رمزنگاری‌شده موجود (متصل‌نشده). این کار کلید رمزنگاری موجود سیستم فایل را بدون محافظت عبارت عبور ذخیره می‌کند؛ داده‌های موجود را رمزگشایی نکرده و رمزنگاری سیستم فایل را غیرفعال نمی‌سازد.

دستورات مهاجرت (Commands for migration)

bcachefs migrate [options] device

مهاجرت یک سیستم فایل موجود به bcachefs

-f fs

ریشه سیستم فایل برای مهاجرت

--encrypted

فعال‌سازی رمزنگاری کل سیستم فایل (chacha20/poly1305)

--no_passphrase

ذخیره کلید رمزنگاری اصلی به صورت رمزنگاری‌نشده در سوپربلاک

-F

اجبار، حتی اگر فایل فراداده از قبل وجود داشته باشد

bcachefs migrate-superblock [options] device

ایجاد سوپربلاک پیش‌فرض، پس از مهاجرت

-d device

دستگاه برای ایجاد سوپربلاک برای آن

-o offset

آفست سوپربلاک موجود

دستورات کار روی فایل‌ها در سیستم فایل bcachefs (Commands for operating on files in a bcachefs filesystem)

bcachefs set-file-option [options] [files|folders] ...

تنظیم ویژگی‌های گوناگون به ازای هر فایل روی فایل‌ها و دایرکتوری‌ها در یک سیستم فایل bcachefs. هنگامی که روی دایرکتوری‌ها اعمال شود، ویژگی‌ها به صورت بازگشتی به تمام فایل‌ها و زیردایرکتوری‌های درون آن منتشر می‌شوند. گزینه‌های تغییریافته برای نوشتن‌های جدید بلافاصله اعمال می‌شوند. برای داده‌های موجود، تطبیق پس‌زمینه گزینه‌های ورودی/خروجی تغییریافته را به صورت ناهمگام اعمال می‌کند، به عنوان مثال بازنویسی اکستنت‌های موجود با یک الگوریتم فشرده‌سازی جدید یا تعداد رونوشت تازه.

--data_replicas=number

تعداد رونوشت‌های داده. با فعال بودن کدگذاری پاک‌شدگی، این مقدار در حال حاضر به 3 (RAID6) محدود است.

--data_checksum=(none | crc32c | crc64 | xxhash)

تنظیم نوع چکسام داده (پیش‌فرض: crc32c).

--compression=(none | lz4 | gzip | zstd)

تنظیم نوع فشرده‌سازی (پیش‌فرض: none).

--background_compression=(none | lz4 | gzip | zstd)

--metadata_target=target

دستگاه یا برچسب برای نوشتن‌های فراداده

--foreground_target=target

دستگاه یا برچسب برای نوشتن‌های پیش‌زمینه

--background_target=target

دستگاه یا برچسب برای انتقال داده‌ها در پس‌زمینه

--promote_target=target

دستگاه یا برچسب برای ارتقای داده‌ها هنگام خواندن

--erasure_code

فعال‌سازی کدگذاری پاک‌شدگی (RAID5/6؛ رونوشت‌های داده به ۳ محدود است)

--project

--nocow

حالت Nocow: عملیات نوشتن در صورت امکان به صورت درجا انجام خواهد شد.

--remove-all

حذف تمام گزینه‌های فایل از فایل‌ها/دایرکتوری‌های مشخص‌شده

برای حذف گزینه‌های خاص، از --option=- استفاده کنید

گزینه‌ها را می‌توان برای انجام چندین عملیات در یک دستور واحد به یکدیگر زنجیر کرد، به عنوان مثال:

bcachefs set-file-option --remove-all --compression=lz4

.

bcachefs set-file-option --compression=- --background_compression=zstd:10 --data_replicas=- file.txt

bcachefs reflink-option-propagate [--set-may-update] files...

انتشار گزینه‌های ورودی/خروجی فعلی هر فایل، از جمله فشرده‌سازی، چکسام، رونوشت‌ها و اهداف، به اکستنت‌های آن. این شامل اکستنت‌های غیرمستقیم دارای پیوند ارجاعی (reflinked) می‌شود که در آن‌ها اشاره‌گر reflink اجازه به‌روزرسانی گزینه‌ها را می‌دهد.

--set-may-update

فعال‌سازی انتشار گزینه روی اشاره‌گرهای قدیمی reflink که پیش از فلگ مجوز may-update-options وجود داشته‌اند. این کار نیازمند دسترسی‌های مدیریتی است و تنها یک بار برای هر فایل تحت تأثیر مورد نیاز است.

دستورات اشکال‌زدایی (Commands for debugging)

این دستورات روی سیستم‌های فایل آفلاین و متصل‌نشده کار می‌کنند.

bcachefs dump [options] device

تخلیه فراداده سیستم فایل

-o output

فلگ الزامی: خروجی تصویر (تصاویر) qcow2

-f, --force

اجبار؛ بازنویسی در صورت نیاز

--nojournal

عدم تخلیه کل ژورنال، فقط مدخل‌های تغییریافته (dirty entries)

bcachefs list [options] devices ...

فهرست کردن فراداده سیستم فایل در خروجی استاندارد

-b (extents | inodes | dirents | xattrs)

درخت B-tree برای فهرست کردن از آن. (پیش‌فرض: extents)

-l, --level

عمق B-tree برای نزول در آن. ( 0 == برگ‌ها؛ پیش‌فرض: 0)

-s inode:offset

موقعیت شروع برای فهرست کردن

-e inode:offset

موقعیت پایان

-m, --mode (keys | formats | nodes | nodes-ondisk)

(پیش‌فرض: keys)

-f

ابتدا بررسی (fsck) سیستم فایل انجام شود

-c, --colorize=(true | false)

اجبار به روشن یا خاموش کردن رنگ. پیش‌فرض: تشخیص خودکار TTY

-v

حالت پرگویی

bcachefs list_journal [options] devices ...

-a

خواندن کل ژورنال، نه فقط مدخل‌های تغییریافته

-n, --nr-entries=nr

تعداد مدخل‌های ژورنال برای چاپ، با شروع از جدیدترین

-s, --seq=seq[..seq]

توالی یا بازه مدخل ژورنال برای چاپ (به عنوان مثال، 123, 100..200, 100.., ..200)

-t, --transaction-filter=bbpos

فیلتر کردن تراکنش‌هایی که bbpos را به‌روزرسانی نمی‌کنند

-k, --key-filter=btree

فیلتر کردن کلیدهایی که btree را به‌روزرسانی نمی‌کنند

-v, --verbose

حالت پرگویی

دستورات FUSE (FUSE commands)

bcachefs fusemount

اتصال یک سیستم فایل از طریق FUSE

دستورات متفرقه (Miscellaneous commands)

bcachefs completions shell

تولید تکمیل‌های پوسته

bcachefs version

نمایش نسخه ابزار فراخوانی‌شده bcachefs

وضعیت خروج (EXIT STATUS)

The bcachefs utility exits 0 on success, and >0 if an error occurs.