'\"macro stdmacro
.\"
.\" Copyright (c) 2005 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 GENPMDA 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3genpmda\f1 \- تولیدکننده PMDA در Performance Co-Pilot
.SH "خلاصه دستور (SYNOPSIS)"
\f3genpmda\f1
[\f3\-dv\f1]
[\f3\-D\f1 \f2domain\f1]
[\f3\-n\f1 \f2pmns\f1]
[\f3\-o\f1 \f2dir\f1]
[\f3\-s\f1 \f2stdpmid\f1]
[\f3\-t\f1 \f2topdir\f1]
\f3\-c\f1 \f2config\f1
\f3\-i\f1 \f2IAM\f1
.SH "توضیحات (DESCRIPTION)"
ابزار
.B genpmda
یک ابزار توسعه سریع نرم‌افزار برای ساخت عامل‌های جدید دامنه متریک‌های کارایی (Performance Metrics Domain Agents) است؛ ببینید:
.BR PMDA (3).
این ابزار روشی بسیار ساده و کارآمد برای گسترش Performance Co-pilot (PCP) با متریک‌های کارایی جدید، بدون نیاز به درک جزئیات سطح پایین نحوه ساخت PMDAها فراهم می‌سازد.
.PP
دستور
.B genpmda
یک فایل پیکربندی شامل یک فضای نام گسترش‌یافته متریک‌های کارایی (ببینید:
.BR PMNS (5))
را می‌خواند و تقریباً تمام کدهای منبع لازم برای پیاده‌سازی یک PMDA کاملاً کاربردی را به‌طور خودکار تولید می‌کند؛ از جمله Makefile، فضای نام، اسکریپت‌های پشتیبانی برای پیکربندی PMDA جدید و متن‌های راهنمای متریک‌ها.
PMDAهای نسبتاً ساده را می‌توان بدون نیاز به نوشتن هیچ کد اضافی به‌طور خودکار از فایل پیکربندی تولید کرد.
PMDAهای پیچیده‌تر، برای مثال آن‌هایی که شامل چندین دامنه نمونه (instance domain) هستند، تنها نیاز دارند که متدهای بازخوانی دامنه‌های نمونه به‌صورت دستی نوشته شوند.
.PP
نمونه‌ای از قالب فایل پیکربندی پذیرفته‌شده توسط
.B genpmda
در زیر آورده شده است.
.SH "گزینه‌ها (OPTIONS)"
.TP 0
.B "گزینه‌های الزامی:"
.TP 5
.BI "\-c" " config"
فایل
\f2config\f1
ورودی؛ مثال زیر را ببینید
.TP
.BI "\-i" " IAM"
نام PMDA با عنوان
\f2IAM\f1،
که باید در
\f2stdpmid\f1
وجود داشته باشد یا اینکه از گزینه
\f3\-D\f1
برای تعیین یک
\f2domain\f1
استفاده شود.
.TP 0
.B "سایر گزینه‌ها:"
.TP 5
.BI "\-d"
تولید یک اسکریپت نصب (Install) برای یک PMDA در حالت دیمن (پیش‌فرض DSO است)
.TP
.BI "\-D" " domain"
استفاده از شماره
\f2domain\f1
در
\f3pmns\f1
و
\f3domain.h\f1
تولیدشده (در صورتی که
\f3\-s\f1
داده نشده باشد)
.TP
.BI "\-n" " pmns"
استفاده از
\f2pmns\f1
به‌عنوان ریشه فضای نام (پیش‌فرض مطابق با فلگ
\f3\-i\f1
است)
.TP
.BI "\-o" " dir"
استفاده از
\f2dir\f1
برای کدهای منبع تولیدشده، پیش‌فرض
\f3./generated\f1
است
.TP
.BI "\-s" " stdpmid"
مسیر به
\f2stdpmid\f1
(پیش‌فرض
\f3../../pmns/stdpmid\f1)
.TP
.BI "\-t" " topdir"
استفاده از
\f2topdir\f1
در GNUmakefile تولیدشده، پیش‌فرض
\f3../../..\f1
است
.TP
.BI "\-v"
چاپ پیام‌های با جزئیات (verbose) درباره فرآیندهایی که
.B genpmda
انجام می‌دهد.
.PP
مثال:
    تولید یک PMDA به نام "example" با استفاده از دامنه ۹۹:
.P
    \f3genpmda \-D 99 \-v \-i EXAMPLE \-c example.conf\f1
.PP
در اینجا فایل پیکربندی \f2example.conf\f1 (برای گزینه الزامی \f3\-c\f1) آورده شده است:
.br
.in +0.5i
.sp
.nf
example {
    metric
}

example.metric {
    ##  metric            string
    ##  pmid              EXAMPLE:CLUSTER:0
    ##  indom             PM_INDOM_NULL
    ##  type              PM_TYPE_STRING
    ##  units             PMDA_PMUNITS(0,0,0,0,0,0)
    ##  semantics         PM_SEM_DISCRETE
    ##  briefhelptext     one line help text for example.metric.string
    ##  helptext          long help text for example.metric.string
    ##  helptext          This is the second line of the long help text
    ##  helptext          and this is the third line.
    ##  fetch             function example_string_fetch_callback
    ##  code              atom->cp = "hello world";
    ##  code              return 1;
    ##  endmetric
}

.fi
.sp 2
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
\fBPCP_\fP
برای پارامتریک کردن نام فایل‌ها و دایرکتوری‌های مورد استفاده PCP به کار می‌روند.
در هر نصب، فایل
\fI/etc/pcp.conf\fP
حاوی مقادیر محلی برای این متغیرها است.
متغیر
\fB$PCP_CONF\fP
می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌گونه که در
\fBpcp.conf\fP(5)
توصیف شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR pmcd (1),
.BR PMDA (3),
.BR pcp.conf (5),
.BR pcp.env (5)
و
.BR PMNS (5).

.\" control lines for scripts/man-spell
.\" +ok+ briefhelptext endmetric
.\" +ok+ example_string_fetch_callback helptext