.TH "XFS_SPACEMAN" "8" "مه ۲۰۲۵" "xfsprogs" "دستورات مدیریت سیستم"
.SH "نام (NAME)"
xfs_spaceman \- ابزار کنترل و گزارشگیری فضای خالی دیسک در XFS
.SH "خلاصه دستور (SYNOPSIS)"
.B xfs_spaceman
[
.B \-c
.I cmd
]
.I file
.br
.B xfs_spaceman \-V
.SH "توضیحات (DESCRIPTION)"
دستور \fBxfs_spaceman\fR برای گزارشگیری از مصرف فضا، ارسال دستورات trim/discard و پاکسازی فضای خالی در فایلسیستمهای متصلشده XFS استفاده میشود.
.SH "گزینه‌ها (OPTIONS)"
.TP 1.0i
.BI \-c " cmd"
دستورات
.B xfs_spaceman
می‌توانند به‌صورت تعاملی (پیش‌فرض) یا به‌صورت آرگومان در خط فرمان اجرا شوند.
می‌توان چندین آرگومان
.B \-c
مشخص کرد. دستورات به ترتیب مشخص‌شده اجرا می‌شوند و سپس برنامه خارج می‌شود.

.SH "دستورات (COMMANDS)"
.TP
.BI "freesp [ \-dgrs ] [-a agno]... [ \-b | \-e bsize | \-h bsize | \-m factor ]"
بدون آرگومان،
.B freesp
یک هیستوگرام از تمام اکستنت‌های فضای خالی در فایل‌سیستم را نمایش می‌دهد.
این دستور گزینه‌های زیر را می‌پذیرد:

.RS 1.0i
.PD 0
.TP 0.4i
.B \-a agno
جمع‌آوری اطلاعات فضای خالی از این گروه تخصیص (allocation group).
این گزینه می‌تواند چندین بار برای جمع‌آوری از چندین گروه مشخص شود.

.TP
.B \-b
این آرگومان تعیین می‌کند که اندازه‌های دسته‌های هیستوگرام، توان‌های متوالی از دو باشند.
این حالت پیش‌فرض است و با گزینه‌های
.BR "-e" "، " "-h" " و " "-m"
مانعة‌الجمع است.

.TP
.B \-d
چاپ اطلاعات خطایابی مانند اطلاعات خام اکستنت‌های فضای خالی.

.TP
.B \-g
چاپ تعداد بلوک‌ها و اکستنت‌های فضای خالی برای هر AG.

.TP
.B \-e bsize
تنظیم اندازه تمام دسته‌های هیستوگرام روی یک مقدار مشخص.
این گزینه با گزینه‌های
.BR "-b" "، " "-h" " و " "-m"
مانعة‌الجمع است.

.TP
.B \-h bsize
ایجاد یک دسته هیستوگرام با حد پایین این مقدار.
حد بالای این دسته یک واحد کمتر از حد پایین دسته هیستوگرام بعدی خواهد بود.
این گزینه می‌تواند چندین بار برای کنترل اندازه دقیق دسته‌ها مشخص شود.
این گزینه با گزینه‌های
.BR "-b" "، " "-e" " و " "-m"
مانعة‌الجمع است.

.TP
.B \-m factor
ایجاد هر دسته هیستوگرام با اندازه‌ای که این ضریب برابر اندازه دسته قبلی ایجادشده باشد.
این گزینه با گزینه‌های
.BR "-b" "، " "-e" " و " "-h"
مانعة‌الجمع است.

.TP
.B \-r
پرس‌وجو از دستگاه بی‌درنگ (realtime device) برای اطلاعات فضای خالی.

.TP
.B \-s
نمایش خلاصه‌ای از اطلاعات فضای خالی یافت‌شده.
.PD
.RE
.TP
.B info
نمایش اطلاعات منتخب از هندسه (geometry) فایل‌سیستم.
فایل بازشده باید یک نقطه اتصال از فایل‌سیستم XFS باشد.
خروجی قالبی مشابه با آنچه
.BR "xfs_info" "(8)"
هنگام پرس‌وجو از یک فایل‌سیستم چاپ می‌کند خواهد داشت.
.TP
.BI "health [ \-a agno] [ \-c ] [ \-f ] [ \-i inum ] [ \-n ] [ \-q ] [ \-r rgno ] [ paths ]"
گزارش سلامت گروه مشخص‌شده از متادیتای فایل‌سیستم.
.RS 1.0i
.PD 0
.TP 0.4i
.B \-a agno
گزارش وضعیت سلامت گروه تخصیص (AG) داده‌شده.
.TP
.B \-c
پیمایش تمام اینودهای فایل‌سیستم و گزارش وضعیت سلامت هر فایل.
اگر گزینه
.B \-a
داده شود، فقط اینودهای موجود در آن AG پیمایش می‌شوند.
.TP
.B \-f
گزارش سلامت متادیتایی که کل فایل‌سیستم را تحت تاثیر قرار می‌دهد.
.TP
.B \-i inum
گزارش سلامت یک اینود مشخص.
.TP
.B \-n
هنگام گزارش سلامت یک فایل، تلاش برای گزارش مسیر کامل فایل در صورت امکان.
این گزینه برای به حداقل رساندن زمان اجرا به‌طور پیش‌فرض غیرفعال است.
.TP
.B \-q
فقط گزارش متادیتای ناسالم.
.TP
.B \-r
گزارش سلامت گروه بی‌درنگ (realtime group) مشخص‌شده.
.TP
.B paths
گزارش سلامت فایل‌ها در مسیر مشخص‌شده.
.PD
.RE
.TP
.BR "help [ " command " ]"
نمایش توضیح مختصری از یک یا تمام دستورات.
.TP
.BI "prealloc [ \-u id ] [ \-g id ] [ -p id ] [ \-m minlen ] [ \-s ]"
حذف پیش‌تخصیص حدسی (speculative preallocation).
اگر هیچ‌کدام از گزینه‌های
.BR "-u" "، " "-g" " یا " "-p"
مشخص نشوند، این دستور روی تمام فایل‌ها عمل می‌کند.
این دستور گزینه‌های زیر را می‌پذیرد:

.RS 1.0i
.PD 0
.TP 0.4i
.B \-u uid
پاکسازی تمام پیش‌تخصیص‌های حدسی برای فایل‌های دارای این شناسه کاربر.
این گزینه می‌تواند در ترکیب با گزینه‌های
.B "-g" " و " "-p"
مشخص شود.

.TP
.B \-g gid
پاکسازی تمام پیش‌تخصیص‌های حدسی برای فایل‌های دارای این شناسه گروه.
این گزینه می‌تواند در ترکیب با گزینه‌های
.B "-u" " و " "-p"
مشخص شود.

.TP
.B \-p pid
پاکسازی تمام پیش‌تخصیص‌های حدسی برای فایل‌های دارای این شناسه پروژه.
این گزینه می‌تواند در ترکیب با گزینه‌های
.B "-u" " و " "-g"
مشخص شود.

.TP
.B \-m minlen
نادیده گرفتن تمام فایل‌های کوچک‌تر از این اندازه.
برای این آرگومان می‌توان واحدها را مشخص کرد.

.TP
.B \-s
صبر کردن تا حذف کامل شود.
.PD
.RE
.TP
.B print
نمایش فهرستی از تمام فایل‌های باز.
.TP
.B quit
خروج از
.BR xfs_spaceman .
.TP
.BI "trim ( \-a agno | \-f | " "offset" " " "length" " ) [ -m minlen ]"
دستور دادن به دستگاه ذخیره‌سازی زیرین برای آزادسازی تمام فضایی که ممکن است پشتیبان فضای خالی در فایل‌سیستم باشد.
این دستور گزینه‌های زیر را می‌پذیرد:
(یکی از
.BR -a "، " -f " یا جفت "
.IR offset / length
الزامی است.)

.RS 1.0i
.PD 0
.TP 0.4i
.B \-a agno
کوتاه‌سازی (Trim) اکستنت‌های فضای خالی در گروه تخصیص داده‌شده.
این گزینه با گزینه
.BR "-f" " و گزینه‌های "
.IR "offset" "/" "length"
مانعة‌الجمع است.

.TP
.B \-f
کوتاه‌سازی تمام فضای خالی در فایل‌سیستم.
این گزینه با گزینه
.BR "-a" " و گزینه‌های "
.IR "offset" "/" "length"
مانعة‌الجمع است.

.TP
.IR "offset" "، " "length"
کوتاه‌سازی تمام فضای خالی درون محدوده فیزیکی تعریف‌شده توسط
.I offset
و
.I length
از این فایل‌سیستم.
واحدها را می‌توان به این آرگومان‌ها ضمیمه کرد.
این گزینه با گزینه‌های
.BR "-a" " و " "-f"
مانعة‌الجمع است.

.TP
.B \-m minlen
اکستنت‌های فضای خالی کوتاه‌تر از این طول کوتاه‌سازی نشوند.
واحدها را می‌توان به این آرگومان ضمیمه کرد.
.PD
.RE