'\" t
.\"     Title: fstrim
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-16
.\"    Manual: System Administration
.\"    Source: util-linux 2.41.5
.\"  Language: Persian
.\"
.TH "FSTRIM" "8" "2026-06-16" "util\-linux 2.41.5" "System Administration"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
fstrim \- آزادسازی و پیرایش بلوک‌های استفاده‌نشده در یک سیستم فایل سوارشده
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBfstrim\fP [\fB\-v\fP] [\fB\-o\fP \fIoffset\fP] [\fB\-l\fP \fIlength\fP] [\fB\-m\fP \fIminimum\-size\fP] \fB\-A\fP|\fB\-a\fP|\fImountpoint\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBfstrim\fP بر روی یک سیستم‌فایل سوارشده برای آزادسازی (یا «trim» کردن) بلوک‌هایی که توسط سیستم‌فایل در حال استفاده نیستند، به کار می‌رود. این کار برای درایوهای حالت جامد (SSD) و حافظه‌های ذخیره‌سازی thinly\-provisioned مفید است.
.sp
به‌طور پیش‌فرض، \fBfstrim\fP تمامی بلوک‌های استفاده‌نشده در سیستم‌فایل را آزاد می‌کند. همان‌طور که در ادامه توضیح داده شده است، می‌توان از گزینه‌ها برای تغییر این رفتار بر اساس محدوده یا اندازه استفاده کرد.
.sp
آرگومان \fImountpoint\fP مسیر پوشه‌ای است که سیستم‌فایل در آن سوار شده است و در صورتی که گزینه‌های \fB\fI\-A\fP\fP، \fB\fI\-a\fP\fP، \fB\fI\-\-fstab\fP\fP یا \fB\fI\-\-all\fP\fP مشخص نشده باشند، اجباری است.
.sp
اجرای مکرر \fBfstrim\fP، یا حتی استفاده از \fBmount \-o discard\fP، ممکن است اثر منفی بر طول عمر دستگاه‌های SSD با کیفیت پایین بگذارد. برای بیشتر سیستم‌های رومیزی و سرور، بسامد پیرایش یک بار در هفته کافی است. توجه داشته باشید که همه دستگاه‌ها از پیرایش صف‌بندی‌شده (queued trim) پشتیبانی نمی‌کنند، بنابراین هر دستور پیرایش بار کاری و افت کارایی بر هر فرآیند دیگری که در آن زمان قصد استفاده از دیسک را دارد تحمیل می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.sp
آرگومان‌های \fIoffset\fP، \fIlength\fP و \fIminimum\-size\fP می‌توانند با پسوندهای ضربی KiB (=1024)، MiB (=1024*1024) و به همین ترتیب برای GiB، TiB، PiB، EiB، ZiB و YiB دنبال شوند (عبارت «iB» اختیاری است، برای نمونه «K» همان معنای «KiB» را دارد) یا پسوندهای KB (=1000)، MB (=1000*1000) و به همین ترتیب برای GB، TB، PB، EB، ZB و YB.
.sp
\fB\-A, \-\-fstab\fP
.RS 4
پیرایش تمام سیستم‌فایل‌های سوارشده ذکرشده در \fI/etc/fstab\fP روی دستگاه‌هایی که از عملیات discard پشتیبانی می‌کنند. اگر سیستم‌فایل ریشه در پرونده موجود نباشد، از خط فرمان هسته تعیین می‌شود. سایر گزینه‌های ارائه‌شده مانند \fB\-\-offset\fP، \fB\-\-length\fP و \fB\-\-minimum\fP بر روی همه این دستگاه‌ها اعمال می‌شوند. خطاهای ناشی از سیستم‌فایل‌هایی که از عملیات discard پشتیبانی نمی‌کنند، دستگاه‌های فقط‌خواندنی، autofs و سیستم‌فایل‌های فقط‌خواندنی بدون نمایش پیام نادیده گرفته می‌شوند. سیستم‌فایل‌های دارای گزینه سوارکردن «X\-fstrim.notrim» نادیده گرفته می‌شوند.
.RE
.sp
\fB\-a, \-\-all\fP
.RS 4
پیرایش تمام سیستم‌فایل‌های سوارشده روی دستگاه‌هایی که از عملیات discard پشتیبانی می‌کنند. سایر گزینه‌های ارائه‌شده مانند \fB\-\-offset\fP، \fB\-\-length\fP و \fB\-\-minimum\fP بر روی همه این دستگاه‌ها اعمال می‌شوند. خطاهای ناشی از سیستم‌فایل‌هایی که از عملیات discard پشتیبانی نمی‌کنند، دستگاه‌های فقط‌خواندنی و سیستم‌فایل‌های فقط‌خواندنی بدون نمایش پیام نادیده گرفته می‌شوند.
.RE
.sp
\fB\-n, \-\-dry\-run\fP
.RS 4
این گزینه همه مراحل را به جز فراخوانی واقعی ioctl با نام \fBFITRIM\fP انجام می‌دهد.
.RE
.sp
\fB\-o, \-\-offset\fP \fIoffset\fP
.RS 4
آفست بر حسب بایت در سیستم‌فایل که جستجو برای بلوک‌های آزاد جهت آزادسازی از آنجا آغاز می‌شود. مقدار پیش‌فرض صفر است که از ابتدای سیستم‌فایل شروع می‌شود.
.RE
.sp
\fB\-l, \-\-length\fP \fIlength\fP
.RS 4
تعداد بایت‌ها (پس از نقطه شروع) برای جستجوی بلوک‌های آزاد جهت آزادسازی. اگر مقدار مشخص‌شده از انتهای سیستم‌فایل فراتر رود، \fBfstrim\fP در مرز اندازه سیستم‌فایل متوقف خواهد شد. مقدار پیش‌فرض تا انتهای سیستم‌فایل امتداد می‌یابد.
.RE
.sp
\fB\-I, \-\-listed\-in\fP \fIlist\fP
.RS 4
فهرستی از پرونده‌ها را که با دونقطه (:) از هم جدا شده‌اند در قالب fstab یا mountinfo هسته مشخص می‌کند. تمام پرونده‌های موجودنبوده یا خالی بدون نمایش پیام نادیده گرفته می‌شوند. ارزیابی \fIlist\fP پس از اولین پرونده غیرخالی متوقف می‌شود. برای نمونه:
.sp
\fB\-\-listed\-in /etc/fstab:/proc/self/mountinfo\fP.
.sp
سیستم‌فایل‌های دارای گزینه سوارکردن «X\-fstrim.notrim» در fstab نادیده گرفته می‌شوند.
.RE
.sp
\fB\-m, \-\-minimum\fP \fIminimum\-size\fP
.RS 4
حداقل محدوده آزاد پیوسته برای آزادسازی، بر حسب بایت. (این مقدار به‌صورت داخلی به مضربی از اندازه بلوک سیستم‌فایل گرد می‌شود.) محدوده‌های آزاد کوچک‌تر از این مقدار نادیده گرفته می‌شوند و اگر از حداقلِ دستگاه کمتر باشد، \fBfstrim\fP حداقل را تنظیم کرده و آن را (fstrim_range.minlen) به فضای کاربری گزارش می‌دهد. با افزایش این مقدار، عملیات \fBfstrim\fP برای سیستم‌فایل‌هایی با فضای آزاد به‌شدت تکه‌تکه‌شده سریع‌تر کامل می‌شود، هرچند که همه بلوک‌ها آزاد نخواهند شد. مقدار پیش‌فرض صفر است که هر بلوک آزاد را آزاد می‌کند.
.RE
.sp
\fB\-t\fP, \fB\-\-types\fP \fIlist\fP
.RS 4
نوع‌های مجاز یا ممنوع سیستم‌فایل را هنگام استفاده با \fB\-\-all\fP یا \fB\-\-fstab\fP مشخص می‌کند. مقدار \fIlist\fP فهرستی از نام‌های سیستم‌فایل است که با کاما از هم جدا شده‌اند. این \fIlist\fP از نحوه ارزیابی الگوهای نوع توسط \fBmount \-t\fP پیروی می‌کند. فقط نوع‌های سیستم‌فایل مشخص‌شده مجاز هستند. اگر پیشوند فهرست «no» باشد یا هر سیستم‌فایل با «no» پیشوندگذاری شده باشد، تمام نوع‌های مشخص‌شده ممنوع هستند. اگر از این گزینه استفاده نشود، تمام سیستم‌فایل‌ها (به‌جز «autofs») مجاز هستند.
.RE
.sp
\fB\-v, \-\-verbose\fP
.RS 4
اجرای پرگو. با این گزینه \fBfstrim\fP تعداد بایت‌های ارسال‌شده از سیستم‌فایل به لایه‌های پایین پشته بلوکی به دستگاه را برای آزادسازی احتمالی خروجی می‌دهد. این عدد از دیدگاه دستگاه ذخیره‌سازی حداکثر مقدار آزادسازی است، زیرا فراخوانی مکرر ioctl با نام \fIFITRIM\fP همان سکتورها را پی‌درپی برای آزادسازی ارسال خواهد کرد.
.sp
دستور \fBfstrim\fP هر بار همان مقدار بایت‌های آزادسازی بالقوه را گزارش می‌دهد، اما فقط سکتورهایی که بین دفعات آزادسازی روی آن‌ها نوشته شده است در عمل توسط دستگاه ذخیره‌سازی آزاد می‌شوند. افزون بر این، لایه بلوکی هسته این حق را برای خود محفوظ می‌دارد که محدوده‌های آزادسازی را برای سازگاری با هندسه stripe در RAID، دستگاه‌های فاقد قابلیت trim در تنظیمات LVM و غیره تنظیم کند. این کاهش‌ها در fstrim_range.len (گزینه \fB\-\-length\fP) بازتاب نخواهند یافت.
.RE
.sp
\fB\-\-quiet\-unsupported\fP
.RS 4
پنهان‌سازی پیام‌های خطا در صورتی که عملیات پیرایش (ioctl) پشتیبانی نشود. این گزینه برای استفاده در پرونده سرویس \fBsystemd\fP یا در اسکریپت‌های \fBcron\fP(8) در نظر گرفته شده است تا هشدارهایی را که ناشی از مشکلات شناخته‌شده هستند پنهان کند؛ مانند گزارش \fIBad file descriptor\fP توسط راه‌انداز NTFS هنگامی که دستگاه به‌صورت فقط‌خواندنی سوار شده است، یا عدم پشتیبانی سیستم‌فایل از فراخوانی ioctl با نام \fIFITRIM\fP. این گزینه همچنین زمانی که سیستم‌فایل پشتیبانی‌نشده‌ای در خط فرمان \fBfstrim\fP مشخص شود، وضعیت خروج را پاک می‌کند.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.sp
0
.RS 4
موفقیت
.RE
.sp
1
.RS 4
شکست
.RE
.sp
32
.RS 4
همه شکست خوردند
.RE
.sp
64
.RS 4
آزادسازی برخی سیستم‌فایل‌ها موفق و برخی با شکست مواجه شد
.RE
.sp
دستور \fBfstrim \-\-all\fP مقدار 0 (همه موفق)، 32 (همه ناموفق) یا 64 (برخی ناموفق، برخی موفق) را بازمی‌گرداند.
.SH "نویسندگان (AUTHORS)"
.sp
.MTO "lczerner\(atredhat.com" "Lukas Czerner" ","
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBblkdiscard\fP(8),
\fBmount\fP(8)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "ردیاب اشکال" "."
.SH "دسترسی (AVAILABILITY)"
.sp
دستور \fBfstrim\fP بخشی از بسته util\-linux است که می‌توان آن را از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "."
دریافت کرد.