'\" t
.\"
.\" Copyright (c) 2026 Red Hat.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.TH PMDABTRFS 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdabtrfs\f1 \- عامل دامنه معیارهای کارایی (PMDA) برای فایل‌سیستم btrfs
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/btrfs/pmdabtrfs\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
.SH "توضیحات (DESCRIPTION)"
.B pmdabtrfs
یک عامل دامنه معیارهای کارایی (PMDA) است که معیارهای کارایی را از طریق sysfs
.RB ( /sys/fs/btrfs )
از فایل‌سیستم btrfs استخراج می‌کند.
.PP
عامل
.B btrfs
PMDA معیارهایی را صادر می‌کند که شامل اطلاعات فایل‌سیستم
(برچسب، اندازه‌ها، نسل، الگوریتم مجموع مقابله‌ای [checksum])،
آمارهای ثبت تراکنش (transaction commit)،
تخصیص فضا برای گروه‌های بلوکی داده، فراداده (metadata) و سیستم،
آمارهای خطای به ازای هر دستگاه،
و آمارهای async discard می‌شود.
.PP
معیارها در دو دامنه نمونه (instance domain) سازمان‌دهی شده‌اند: یکی برای
فایل‌سیستم‌های btrfs (با کلید UUID) و دیگری برای دستگاه‌ها
(با کلید UUID::devid).
برای هر نمونه برچسب‌هایی ارائه شده است که شامل
UUID فایل‌سیستم، برچسب (label) و در صورت وجود شناسه دستگاه (device ID) می‌شود.
.PP
توضیح مختصری از گزینه‌های خط فرمان
.B pmdabtrfs
در ادامه آمده است:
.TP 5
.B \-d
شماره دامنه (
.IR domain
) معیارهای کارایی باید روی یک مقدار یکتا تنظیم شود.
.TP
.B \-l
محل فایل گزارش (logfile).
به‌طور پیش‌فرض، هنگامی که
.B pmdabtrfs
آغاز به کار می‌کند، فایل گزارشی به نام
.I btrfs.log
در دایرکتوری جاری
.BR pmcd (1)
یعنی
.BR $PCP_LOG_DIR/pmcd
نوشته می‌شود.
اگر فایل گزارش ایجاد نشود یا قابل نوشتن نباشد، خروجی به جای آن در خطای استاندارد نوشته می‌شود.
.SH "نصب (INSTALLATION)"
عامل btrfs PMDA به یک سیستم لینوکس با یک یا چند فایل‌سیستم سوارشدهٔ btrfs نیاز دارد.
این PMDA آمارها را از sysfs می‌خواند و نیازی به امتیازات ریشه (root) ندارد.
.PP
برای نصب این PMDA از اسکریپت Install استفاده کنید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/btrfs
# ./Install
.in
.fi
.ft 1
.PP
برای حذف این PMDA از اسکریپت Remove استفاده کنید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/btrfs
# ./Remove
.in
.fi
.ft 1
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینهٔ
.B \-D
یا
.B \-\-debug
خروجی پیام‌های عیب‌یابی بیشتری را در
.I stderr
برای کمک به ریشه‌یابی و حل مشکلات فعال می‌کند؛ اگرچه این اطلاعات گاهی مبهم است و در درجه اول برای راهنمایی توسعه‌دهندگان در نظر گرفته شده تا کاربران نهایی.
.I debug
فهرستی از گزینه‌های اشکال‌زدایی جداشده با کاما است؛ از
.BR pmdbg (1)
همراه با گزینهٔ
.B \-l
برای به دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.PP
گزینه‌های اشکال‌زدایی ویژهٔ
.B pmdabtrfs
به شرح زیر هستند:
.TS
box;
lf(B) | lf(B)
lf(B) | lf(R) .
گزینه	توضیحات
_
appl0	هشدار در صورتی که دایرکتوری sysfs مربوط به btrfs یافت نشود
.TE
.SH "محیط (ENVIRONMENT)"
متغیر محیطی
.B BTRFS_PATH
می‌تواند برای اهداف آزمایشی، جهت بازنویسی مسیر پیش‌فرض sysfs
.RB ( /sys/fs/btrfs )
تنظیم شود.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ pmdabtrfs btrfs sysfs devid UUID