نام (NAME)

pmdabtrfs - عامل دامنه معیارهای کارایی (PMDA) برای فایل‌سیستم btrfs

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

$PCP_PMDAS_DIR/btrfs/pmdabtrfs [-D debug] [-d domain] [-l logfile]

توضیحات (DESCRIPTION)

pmdabtrfs یک عامل دامنه معیارهای کارایی (PMDA) است که معیارهای کارایی را از طریق sysfs (/sys/fs/btrfs) از فایل‌سیستم btrfs استخراج می‌کند.

عامل btrfs PMDA معیارهایی را صادر می‌کند که شامل اطلاعات فایل‌سیستم (برچسب، اندازه‌ها، نسل، الگوریتم مجموع مقابله‌ای [checksum])، آمارهای ثبت تراکنش (transaction commit)، تخصیص فضا برای گروه‌های بلوکی داده، فراداده (metadata) و سیستم، آمارهای خطای به ازای هر دستگاه، و آمارهای async discard می‌شود.

معیارها در دو دامنه نمونه (instance domain) سازمان‌دهی شده‌اند: یکی برای فایل‌سیستم‌های btrfs (با کلید UUID) و دیگری برای دستگاه‌ها (با کلید UUID::devid). برای هر نمونه برچسب‌هایی ارائه شده است که شامل UUID فایل‌سیستم، برچسب (label) و در صورت وجود شناسه دستگاه (device ID) می‌شود.

توضیح مختصری از گزینه‌های خط فرمان pmdabtrfs در ادامه آمده است:

-d

شماره دامنه ( domain ) معیارهای کارایی باید روی یک مقدار یکتا تنظیم شود.

-l

محل فایل گزارش (logfile). به‌طور پیش‌فرض، هنگامی که pmdabtrfs آغاز به کار می‌کند، فایل گزارشی به نام btrfs.log در دایرکتوری جاری pmcd(1) یعنی $PCP_LOG_DIR/pmcd نوشته می‌شود. اگر فایل گزارش ایجاد نشود یا قابل نوشتن نباشد، خروجی به جای آن در خطای استاندارد نوشته می‌شود.

نصب (INSTALLATION)

عامل btrfs PMDA به یک سیستم لینوکس با یک یا چند فایل‌سیستم سوارشدهٔ btrfs نیاز دارد. این PMDA آمارها را از sysfs می‌خواند و نیازی به امتیازات ریشه (root) ندارد.

برای نصب این PMDA از اسکریپت Install استفاده کنید:

# cd $PCP_PMDAS_DIR/btrfs
# ./Install

برای حذف این PMDA از اسکریپت Remove استفاده کنید:

# cd $PCP_PMDAS_DIR/btrfs
# ./Remove

گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)

گزینهٔ -D یا --debug خروجی پیام‌های عیب‌یابی بیشتری را در stderr برای کمک به ریشه‌یابی و حل مشکلات فعال می‌کند؛ اگرچه این اطلاعات گاهی مبهم است و در درجه اول برای راهنمایی توسعه‌دهندگان در نظر گرفته شده تا کاربران نهایی. debug فهرستی از گزینه‌های اشکال‌زدایی جداشده با کاما است؛ از pmdbg(1) همراه با گزینهٔ -l برای به دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.

گزینه‌های اشکال‌زدایی ویژهٔ pmdabtrfs به شرح زیر هستند:

محیط (ENVIRONMENT)

متغیر محیطی BTRFS_PATH می‌تواند برای اهداف آزمایشی، جهت بازنویسی مسیر پیش‌فرض sysfs (/sys/fs/btrfs) تنظیم شود.

همچنین ببینید (SEE ALSO)

PCPIntro(1)، pmcd(1)، pcp.conf(5) و pcp.env(5).