'\" t
.\"
.\" Copyright (c) 2021 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 PMDAZFS 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdazfs\f1 \- عامل دامنه معیارهای عملکرد (PMDA) سیستم‌فایل ZFS برای لینوکس
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/linux_zfs/pmdazfs\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
.SH "توضیحات (DESCRIPTION)"
.B pmdazfs
یک عامل دامنه معیارهای عملکرد (PMDA) است که معیارهای عملکرد توصیف‌کننده وضعیت سیستم‌فایل ZFS را از فایل‌های آمار واقع در /proc استخراج می‌کند.
.PP
عامل دامنه
.B zfs
معیارهایی را صادر می‌کند که اطلاعات مربوط به حافظه موقت (ARC، L2ARC، ZIL و VDEV)، بافرینگ، RAIDZ، عملیات‌های dnode و ورودی/خروجی استخرها (pools IO) را اندازه‌گیری می‌کنند.
.PP
شرح مختصری از گزینه‌های خط فرمان
.B pmdazfs
در ادامه آمده است:
.TP 5
.B \-d
شماره دامنه (
.I domain
) معیارهای عملکرد باید روی یک مقدار یکتا تنظیم شود.
.TP
.B \-l
محل فایل لاگ.
به‌طور پیش‌فرض، یک فایل لاگ به نام
.I zfs.log
هنگام آغاز به‌کار
.B pmdazfs
در دایرکتوری جاری
.BR pmcd (1)
نوشته می‌شود، یعنی
.BR $PCP_LOG_DIR/pmcd .
اگر فایل لاگ نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به‌جای آن در خطای استاندارد (stderr) نوشته می‌شود.
.SH "نصب (INSTALLATION)"
OpenZFS در PCP گنجانده نشده است و باید از طریق بسته‌های موجود یا کد منبع روی سیستم نصب شود.
پس از نصب و پیکربندی OpenZFS، فایل‌های آمار باید در /proc پدیدار شوند و می‌توان PMDA را با استفاده از اسکریپت Install به PMCD اضافه کرد:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/zfs
# ./Install
.in
.fi
.ft 1
.PP
برای حذف PMDA از اسکریپت Remove استفاده کنید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/zfs
# ./Remove
.in
.fi
.ft 1
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی عیب‌یابی بیشتری را روی
.I stderr
فعال می‌کند تا به بررسی و اولویت‌بندی مشکلات کمک کند؛ هرچند این اطلاعات گاهی پیچیده و مبهم هستند و در وهله اول به‌منظور راهنمایی توسعه‌دهندگان به‌جای کاربران نهایی طراحی شده‌اند.
.I debug
یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از
.BR pmdbg (1)
همراه با گزینه
.B \-l
برای به‌دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و مفاهیم آن‌ها استفاده کنید.
.PP
گزینه‌های اشکال‌زدایی مختص
.B pmdazfs
عبارتند از:
.TS
box;
lf(B) | lf(B)
lf(B) | lf(R) .
گزینه	توضیحات
_
appl0	در صورت پیدا نشدن هر یک از فایل‌های آمار ZFS هشدار می‌دهد
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ linux_zfs pmdazfs OpenZFS RAIDZ dnode VDEV ZFS ZIL zfs