'\"macro stdmacro
.\"
.\" Copyright (c) 2014 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 PMDAXFS 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdaxfs \- عامل دامنه معیارهای کارایی سیستم‌فایل XFS (PMDA)
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/xfs/pmdaxfs\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
.SH "توضیحات (DESCRIPTION)"
.B pmdaxfs
یک عامل دامنه معیارهای کارایی (PMDA) است که معیارهای کارایی توصیف‌کننده وضعیت سیستم‌فایل XFS را از هسته لینوکس استخراج می‌کند.
.PP
این
.B xfs
PMDA معیارهایی را صادر می‌کند که اطلاعات مربوط به استفاده از بافر متادیتا (metadata buffer)، ژورنال، عملیات btree، عملیات inode، ویژگی‌های گسترش‌یافته (extended attributes)، دایرکتوری‌ها، سهمیه‌بندی (quotas)، تعداد عملیات خواندن و نوشتن و البته توان عملیاتی (throughput) را اندازه‌گیری می‌کنند.
.PP
این PMDA قابلیتی را برای بازنشانی مقادیر تمام شمارنده‌ها به صفر با استفاده از
.BR pmstore (1)
و معیار xfs.control.reset فراهم می‌کند.
.PP
در ادامه توضیح مختصری از گزینه‌های خط فرمان
.B pmdaxfs
آمده است:
.TP 5
.B \-d
بسیار حیاتی است که شماره
.I domain
معیارهای کارایی مشخص‌شده در اینجا، یکتا و سازگار باشد. به این معنی که
.I domain
باید برای هر PMDA در یک میزبان متفاوت باشد، و همان شماره
.I domain
باید برای همان PMDA در تمام میزبان‌ها به کار رود.
.TP
.B \-l
مکان فایل لاگ (گزارش). به‌طور پیش‌فرض، هنگام راه‌اندازی
.B pmdaxfs
فایل لاگی به نام
.I xfs.log
در دایرکتوری جاری
.BR pmcd (1)
یعنی
.BR $PCP_LOG_DIR/pmcd
نوشته می‌شود. اگر ایجاد فایل لاگ امکان‌پذیر نبوده یا قابل نوشتن نباشد، خروجی به جای آن در خطای استاندارد (stderr) نوشته می‌شود.
.SH "نصب (INSTALLATION)"
عامل
.B xfs
PMDA به‌طور پیش‌فرض در لینوکس نصب و در دسترس است. اگر می‌خواهید نصب آن را لغو کنید، دستورهای زیر را با دسترسی ریشه (root) انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/xfs
# ./Remove
.in
.fi
.ft 1
.PP
اگر پس از حذف، مایلید مجدداً دسترسی به نام‌ها، متن راهنما و مقادیر معیارهای کارایی XFS را برقرار کنید، دستورهای زیر را به عنوان ریشه (root) اجرا کنید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/xfs
# ./Install
.in
.fi
.ft 1
.PP
.B pmdaxfs
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا گردد. اسکریپت‌های Install و Remove به هنگام نصب یا حذف عامل، به
.BR pmcd (1)
اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان استفاده‌شده برای راه‌اندازی
.B pmdaxfs
.TP 10
.B $PCP_PMDAS_DIR/xfs/help
فایل پیش‌فرض متن راهنما برای معیارهای xfs
.TP 10
.B $PCP_PMDAS_DIR/xfs/Install
اسکریپت نصب برای عامل
.B pmdaxfs
.TP 10
.B $PCP_PMDAS_DIR/xfs/Remove
اسکریپت لغو نصب برای عامل
.B pmdaxfs
.TP 10
.B $PCP_LOG_DIR/pmcd/xfs.log
فایل پیش‌فرض لاگ برای پیام‌های خطا و سایر اطلاعات از سوی
.B pmdaxfs
.PD
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای پارامتریک‌کردن نام فایل‌ها و دایرکتوری‌های مورد استفاده PCP به کار می‌روند. در هر نصب، فایل
.I /etc/pcp.conf
حاوی مقادیر محلی برای این متغیرها است. متغیر
.B $PCP_CONF
می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در
.BR pcp.conf (5)
شرح داده شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی تشخیصی بیشتری را در
.I stderr
فعال می‌کند تا به بررسی و اولویت‌بندی مشکلات کمک کند، هرچند این اطلاعات گاهی مبهم است و در وهله اول برای راهنمایی توسعه‌دهندگان در نظر گرفته شده است تا کاربران نهایی.
.I debug
فهرستی از گزینه‌های اشکال‌زدایی جدا شده با کاما است؛ از
.BR pmdbg (1)
به همراه گزینه
.B \-l
برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pmstore (1)،
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ pmdaxfs inode btree XFS xfs