'\"macro stdmacro
.\"
.\" Copyright (c) 2000-2004 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 PMTRACE 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmtrace\f1 \- ابزار سنجش کارایی در خط فرمان
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmtrace\f1
[\f3-q?\f1]
[\f3\-c\f1 \f2value\f1 | \f3\-e\f1 \f2command\f1 | \f3\-v\f1 \f2value\f1]
[\f3\-h\f1 \f2host\f1]
[\f3\-S\f1 \f2state\f1]
\f2tag\f1
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmtrace
یک رابط خط فرمانی ساده برای عامل حوزه معیارهای کارایی (PMDA) ردگیری و کتابخانهٔ وابستهٔ \f2pcp_trace\f1 فراهم می‌کند.
.PP
رفتار پیش‌فرض
.B pmtrace
ارائهٔ داده‌های ردگیری نقطه‌ای به PMDA ردگیری است که در آن از آرگومان
.I tag
به‌عنوان نام شناسایی مرتبط با هر نقطهٔ ردگیری استفاده می‌شود.
سپس
.I tag
به یک شناسهٔ نمونه درون مجموعه‌معیارهای trace.point تبدیل می‌شود.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های دردسترس خط فرمان عبارتند از:
.TP 5
\fB\-c\fR \fIvalue\fR
اجازه می‌دهد یک مقدار شمارندهٔ (\f2value\f1) دلخواه از طریق معیارهای trace.count صادر شود.
.TP
\fB\-e\fR \fIcommand\fR
اجازه می‌دهد یک \f2command\f1 دلخواه اجرا شود.
از آنجا که این \f2command\f1 نقاط شروع و پایان مشخصی دارد، به‌عنوان یک تراکنش سنجیده خواهد شد.
اطلاعات حاصل از طریق معیارهای trace.transact در دسترس قرار می‌گیرند.
.TP
\fB\-h\fR \fIhost\fR
ارسال داده‌های ردگیری به PMDA ردگیری در حال اجرا روی
.IR host
به‌جای localhost.
این گزینه استفاده از متغیر محیطی
.BR PCP_TRACE_HOST
را لغو می‌کند.
.TP
\fB\-q\fR
فرونشانی پیام‌های حاصل از یک ردگیری موفق، تا
.B pmtrace
در سکوت (بدون خروجی اضافی) اجرا شود.
.TP
\fB\-S\fR \fIstate\fR
فعال‌سازی اشکال‌زدایی و ردگیری داخلی.
مقدار
.I state
ترکیبی بیتی از پرچم‌های اشکال‌زدایی طبق تعریف در
.BR pmtracestate (3)
است، و می‌توان آن را با نحو ده‌دهی یا شانزده‌شانزدهی ارائه‌شده توسط
.BR strtol (3)
مشخص کرد.
.TP
\fB\-v\fR \fIvalue\fR
اجازه می‌دهد یک مقدار ممیز شناور (\f2value\f1) دلخواه از طریق معیارهای trace.observe صادر شود.
.TP
\fB\-?\fR
نمایش پیام نحوهٔ استفاده و خروج.
.SH "خطاها (DIAGNOSTICS)"
همهٔ پیام‌ها روی خطای استاندارد تولید می‌شوند و خودتوضیح هستند.
.PP
وضعیت خروج
.B pmtrace
همیشه صفر است، مگر زمانی که گزینهٔ
.B \-e
استفاده شود؛ که در این صورت وضعیت خروج \f2command\f1 بازگردانده می‌شود.
.SH "فایل‌ها (FILES)"
.TP 5
.BI $PCP_DEMOS_DIR/trace/pmtrace.c
کد منبع برای
.B pmtrace
.SH "محیط (ENVIRONMENT)"
از آنجا که
.B pmtrace
از توابع کتابخانهٔ \f2libpcp_trace\f1 استفاده می‌کند، متغیرهای محیطی
\f3PCP_TRACE_HOST\f1، \f3PCP_TRACE_PORT\f1 و \f3PCP_TRACE_TIMEOUT\f1
همگی در نظر گرفته می‌شوند.
برای شرح مفصل معنای هر یک از آن‌ها به
.BR pmdatrace (3)
مراجعه کنید.
.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 pmdatrace (1)،
.BR pmprobe (1)،
.BR PMAPI (3)
و
.BR pmdatrace (3).

.\" control lines for scripts/man-spell
.\" +ok+ pcp_trace