'\"macro stdmacro
.\"
.\" Copyright (c) 2009 Silicon Graphics, Inc.  All Rights Reserved.
.\"
.\" 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 PMDAIB 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdaib\f1 \- عامل دامنه معیارهای کارایی Infiniband (PMDA)
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/infiniband/pmdaib\f1
[\f3\-c\f1 \f2configFile\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-w\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmdaib
یک «عامل دامنه معیارهای کارایی» (PMDA) است که اطلاعات و معیارهای عملکرد را در مورد HCAهای محلی Infiniband و GUIDهای محلی یا دوردست Infiniband صادر می‌کند.
.PP
شرح مختصری از گزینه‌های خط فرمان
.B pmdaib
در ادامه آمده است:
.TP 5
.B \-c
محل فایل پیکربندی. به‌طور پیش‌فرض، فایل پیکربندی با نام
.BR $PCP_PMDAS_DIR/infiniband/config
شناخته می‌شود. برای اطلاعات بیشتر
.BR "فایل پیکربندی (CONFIG FILE)"
را ببینید.
.TP
.B \-d
مشخص کردن یک شماره
.I domain
(دامنه) جایگزین برای معیارهای کارایی. تقریباً هیچ‌گاه لازم نخواهد بود.
.TP
.B \-l
محل فایل وقایع (log). به‌طور پیش‌فرض، یک فایل وقایع با نام
.I ib.log
در
.BR $PCP_LOG_DIR/pmcd
نوشته می‌شود. اگر ایجاد فایل وقایع مقدور نباشد یا قابل نوشتن نباشد، خروجی به‌جای آن به خطای استاندارد (stderr) ارسال می‌شود.
.TP
.B \-w
نوشتن فایل پیکربندی پیش‌فرض در
.BR $PCP_PMDAS_DIR/infiniband
و خروج فوری. فایل پیکربندیِ ایجادشده حاوی درگاه‌های HCA محلی خواهد بود و فایل‌های موجود را بازنویسی نمی‌کند. از این آرگومان فقط باید برای ایجاد فایل پیکربندی الگو استفاده شود و هرگز نباید در
.I pmcd.conf
قرار گیرد. برای اطلاعات بیشتر درباره قالب فایل و پایش GUIDهای دوردست،
.BR "فایل پیکربندی (CONFIG FILE)"
را ببینید.
.SH "فایل پیکربندی (CONFIG FILE)"
به‌طور پیش‌فرض، PMDA بدون استفاده از فایل پیکربندی کار خواهد کرد. در این حالت عملیاتی، درگاه‌های HCA محلی پایش می‌شوند. توجه داشته باشید در صورتی که یک HCA جدید به سامانه اضافه شود، ممکن است نام‌گذاری دامنه نمونه (instance domain) تغییر کند؛ زیرا این نام‌گذاری همواره بر پایه نام‌گذاری هسته (kernel) خواهد بود.
.PP
در مواردی که این وضعیت مطلوب نباشد، یا در مواردی که پایش درگاه‌های Infiniband دوردست مورد نیاز باشد، باید یک فایل پیکربندی ایجاد شود. یک فایل «الگو» را می‌توان با اجرای دیمن
.B pmdaib
همراه با آرگومان
.B \-w
ایجاد کرد. این کار فایل پیکربندی جدیدی شامل درگاه‌ها و GUIDهای محلی خواهد ساخت.
.PP
اگر فایل پیکربندی
.I قابل اجرا (executable)
باشد، اجرا خواهد شد و خروجی آن به عنوان محتوای پیکربندی مورد استفاده قرار می‌گیرد.
.PP
فایل پیکربندی از رکوردهای خط‌محور تشکیل شده است. خطوط خالی و تمام نویسه‌های پس از نویسه
.I هش (#)
نادیده گرفته می‌شوند. هر خط دارای ۶ فیلد است:
.PP
[\f3instName\f1] [\f3portGUID\f1] [\f3portNum\f1] via [\f3localPortName\f1]:[\f3localPortNum\f1]
.PP
فیلد نخست برای اختصاص یک نام نمونه‌ی ایستا به درگاه Infiniband دارای یک GUID معین به کار می‌رود. تمام فیلدهای دیگر باید برای پایش درگاه مربوطه به درستی مقداردهی شوند.
.PP
برای نمونه، جهت پایش درگاه شماره ۱ از HCA محلی موسوم به \(aqmthca0\(aq، یک خطِ نمونه در فایل پیکربندی به صورت زیر خواهد بود:
.PP
myPort1 0xdeadbeef01234567 1 via mthca0:1
.PP
درگاه‌های دوردست را می‌توان به آسانی با مشخص کردن GUID مربوط به HCA یا سوئیچ و تعیین شماره درگاه دوردست پایش کرد. جفت‌فیلد \f3localPortName\f1:\f3localPortNum\f1 مشخص می‌کند از کدام درگاه و HCA محلی به عنوان «گام نخست» (first hop) جهت ارتباط با GUID دوردست استفاده شود. به عنوان نمونه، برای پایش درگاه شماره ۱۳ از یک سوئیچ دوردست که روی درگاه اولِ HCA دوم به ساختار متصل است:
.PP
switch13 0xfeeffeefabcdabcd 13 via mthca1:1
.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 PMAPI (3)
و
.BR ibnetdiscover (8).

.\" control lines for scripts/man-spell
.\" +ok+ ibnetdiscover localPortName
.\" +ok+ localPortNum Infiniband infiniband instName portGUID
.\" +ok+ portNum CONFIG pmdaib myPort GUIDs mthca HCAs GUID HCA ib