." Man page generated from reStructuredText
." by the Docutils 0.23 manpage writer.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\ \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
. RS \
. nr rst2man-indent\n[rst2man-indent-level] \n[an-margin]
. nr rst2man-indent-level +1
..
.de UNINDENT
. RE
.nr rst2man-indent-level -1
.in \n[rst2man-indent\n[rst2man-indent-level]]u
..
.TH "BTRFS" "5" "Jul 15, 2026" "7.1" "BTRFS"
.SH "نام (NAME)"
btrfs \- مباحث عمومی فایلسیسم BTRFS (گزینه‌های اتصال، ویژگی‌های فایل و سایر موارد)
.SH "توضیحات (DESCRIPTION)"
.sp
این سند مباحث مرتبط با فایل‌سیستم BTRFS را تشریح می‌کند که مختص ابزار خط فرمان خاصی نیستند. این مباحث شامل موارد زیر است:
.INDENT 0.0
.IP 1. 4
گزینه‌های اتصال (Mount options)
.IP 2. 4
قابلیت‌های فایل‌سیستم (Filesystem features)
.IP 3. 4
پشتیبانی از فایل مبادله حافظه (Swapfile support)
.IP 4. 4
الگوریتم‌های چکسام و اعتبارسنجی (Checksum algorithms)
.IP 5. 4
فشرده‌سازی داده‌ها (Compression)
.IP 6. 4
رابط sysfs
.IP 7. 4
عملیات انحصاری فایل‌سیستم
.IP 8. 4
محدودیت‌های فنی فایل‌سیستم
.IP 9. 4
پشتیبانی بوت‌لودر (Bootloader support)
.IP 10. 4
ویژگی‌های فایل (File attributes)
.IP 11. 4
حالت Zoned
.IP 12. 4
دستگاه کنترلی (Control device)
.IP 13. 4
فایل‌سیستم با چندین پروفایل گروه بلوکی
.IP 14. 4
دستگاه بذری (Seeding device)
.IP 15. 4
وضعیت RAID56 و راهکارهای توصیه‌شده
.IP 16. 4
واژه‌نامه تخصصی (Glossary)
.IP 17. 4
مدل ذخیره‌سازی و ملاحظات سخت‌افزاری
.UNINDENT
.SH "گزینه‌های اتصال (MOUNT OPTIONS)"
.SS "گزینه‌های اختصاصی BTRFS"
.sp
این بخش گزینه‌های اتصال مختص BTRFS را توضیح می‌دهد. برای گزینه‌های عمومی مانت، لطفاً به صفحه راهنمای
.BR mount (8)
مراجعه فرمایید.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اکثر گزینه‌های اتصال بر کل فایل‌سیستم اعمال می‌شوند و تنها گزینه‌های مشخص‌شده در اولین ساب‌والیوم متصل‌شده اعمال خواهند شد. این بدان معناست که نمی‌توان گزینه‌هایی مانند \fInodatacow\fP، \fInodatasum\fP یا \fIcompress\fP را به صورت جداگانه برای هر ساب‌والیوم از طریق گزینه‌های مانت تنظیم نمود.
.UNINDENT
.UNINDENT
.sp
گزینه‌های اتصال به ترتیب پردازش می‌شوند و مقدار آخرین گزینه اعمال خواهد شد.
.TP
\fBalloc_start=\fP\fI<bytes>\fP
تعیین آفست شروع تخصیص فضا (به دلایل سازگاری باقی مانده و منسوخ شده است).
.TP
\fBautodefrag\fP, \fBnoautodefrag\fP
فعال‌سازی یکپارچه‌سازی خودکار (Auto-defragmentation) در پس‌زمینه هنگام نوشتن داده‌های تصادفی در فایل‌ها.
.TP
\fBcheck_int\fP, \fBcheck_int_data\fP, \fBcheck_int_print_mask=\fP\fI<value>\fP
ابزارهای داخلی شبیه‌سازی قطعی ناگهانی برق جهت تست پایداری و یکپارچگی فایل‌سیستم.
.TP
\fBcommit=\fP\fI<seconds>\fP
فاصله زمانی ذخیره دوره‌ای داده‌ها بر روی دیسک (پیش‌فرض ۳۰ ثانیه).
.TP
\fBcompress\fP, \fBcompress=\fP\fI<type[:level]>\fP, \fBcompress-force\fP, \fBcompress-force=\fP\fI<type[:level]>\fP
فعال‌سازی فشرده‌سازی برای فایل‌های جدید. نوع فشرده‌سازی می‌تواند \fIzlib\fP، \fIlzo\fP یا \fIzstd\fP باشد. سطح فشرده‌سازی نیز برای zlib (۱ تا ۹) و zstd (۱ تا ۱۵) قابل تعیین است. سوییچ \fIcompress-force\fP فشرده‌سازی را بدون بررسی هوریستیک فشرده‌پذیری بر تمام فایل‌ها اجبار می‌کند.
.TP
\fBdatacow\fP, \fBnodatacow\fP
فعال یا غیرفعال کردن کپی هنگام نوشتن (Copy-on-Write) برای فایل‌های جدید. غیرفعال‌سازی CoW همچنین محاسبات چکسام داده را غیرفعال می‌سازد.
.TP
\fBdatasum\fP, \fBnodatasum\fP
فعال یا غیرفعال کردن محاسبه و بررسی چکسام داده‌ها برای فایل‌های جدید ایجادشده.
.TP
\fBdegraded\fP
امکان اتصال فایل‌سیستم در صورتی که تعدادی از دیسک‌های آرایه RAID مفقود یا آسیب‌دیده باشند.
.TP
\fBdevice=\fP\fI<devicepath>\fP
مشخص کردن صریح یکی از دیسک‌های فایل‌سیستم چنددیسکی در هنگام اتصال.
.TP
\fBdiscard\fP, \fBdiscard=async\fP, \fBdiscard=sync\fP, \fBnodiscard\fP
ارسال دستورات TRIM/discard به حافظه‌های SSD جهت آزادسازی بلوک‌های پاک‌شده. حالت \fIasync\fP (پیش‌فرض در کرنل‌های نوین) دستورات را به صورت ناهمگام و بدون افت کارایی سیستم ارسال می‌کند.
.TP
\fBmax_inline=\fP\fI<bytes>\fP
حداکثر اندازه فایلی که داده‌های آن به صورت درون‌خطی در ساختار متاداده ذخیره می‌شود (پیش‌فرض اندازه سکتور یا ۲۰۴۸ بایت).
.TP
\fBrescan_uuid\fP
اجبار بررسی و اتصال مجدد UUID دستگاه‌ها.
.TP
\fBskip_balance\fP
جلوگیری از ازسرگیری خودکار عملیات توازن متوقف‌شده در هنگام مانت فایل‌سیستم.
.TP
\fBspace_cache\fP, \fBspace_cache=v1\fP, \fBspace_cache=v2\fP, \fBnospace_cache\fP
فعال‌سازی حافظه پنهان فضای آزاد جهت تسریع تخصیص بلوک‌ها. نگارش \fIv2\fP (free space tree) بسیار کارآمدتر بوده و در سیستم‌های امروزی توصیه می‌شود.
.TP
\fBssd\fP, \fBssd_spread\fP, \fBnossd\fP
بهینه‌سازی‌های تخصیص فضا برای حافظه‌های فلش و SSD.
.TP
\fBsubvol=\fP\fI<path>\fP, \fBsubvolid=\fP\fI<ID>\fP
اتصال یک ساب‌والیوم خاص بر اساس مسیر نسبی یا شناسه عددی آن به جای ساب‌والیوم پیش‌فرض.
.TP
\fBuser_subvol_rm_allowed\fP
اجازه دادن به کاربران عادی (غیر root) برای حذف ساب‌والیوم‌هایی که در مالکیت خود دارند.
.SH "الگوریتم‌های اعتبارسنجی (CHECKSUM ALGORITHMS)"
.sp
سیستم فایل Btrfs به صورت پیش‌فرض از CRC32C برای تضمین سلامت متاداده و داده‌ها استفاده می‌کند. علاوه بر آن، الگوریتم‌های قوی‌تری مانند xxhash، sha256 و blake2b نیز در زمان فرمت‌بندی با \fBmkfs.btrfs\fP قابل انتخاب هستند.
.SH "پشتیبانی از SWAPFILE"
.sp
ایجاد فایل swap در سیستم‌فایل Btrfs امکان‌پذیر است، مشروط بر اینکه فایل بر روی یک ساب‌والیوم بدون فشرده‌سازی و بدون ویژگی CoW (تنظیم \fIchattr +C\fP قبل از ایجاد داده) قرار داشته باشد.
.SH "همچنین ببینید (SEE ALSO)"
.sp
.BR btrfs (8),
.BR btrfs\-balance (8),
.BR btrfs\-subvolume (8),
.BR mkfs.btrfs (8),
.BR mount (8)