'\" t
.\"
.\" Copyright (c) 2000 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 PMTIME 1 "" "Performance Co-Pilot"
.SH "نام (NAME)"
pmtime \- سرور کنترل زمان برای Performance Co-Pilot
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmtime\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-V?\f1]
[\f3\-p\f1 \f2port\f1]
.SH "توضیحات (DESCRIPTION)"
.B pmtime
یک رابط کاربری گرافیکی برای برنامه‌های پایش کارایی است که از زیرساخت PCP استفاده می‌کنند و نیازمند کنترل تعاملی زمان هستند.
.PP
.B pmtime
به‌طور معمول مستقیماً توسط کاربران فراخوانی نمی‌شود.
بلکه معمولاً توسط برنامه‌های کلاینت اجرا می‌شود (مانند
.BR pmchart (1)،
.BR pmstat (1)
یا
.BR pmval (1)).
.PP
دو حالت برای تعامل با یک فرآیند
.B pmtime
وجود دارد: حالت میزبان زنده و حالت بایگانی تاریخی.
در حالت بایگانی، پنجره ابزارهای کنترل زمان مناسبی را برای دستکاری موقعیت در بایگانی نمایش می‌دهد و کنترل کامل شبیه VCR را جهت حرکت به جلو و عقب در زمان با نرخ‌ها و بازه‌های زمانی قابل‌پیکربندی فراهم می‌کند.
در حالت زنده، پنجره
.B pmtime
شامل کنترل‌های زمانی ساده‌تری است که برای پایش زنده مناسب هستند.
.PP
توجه داشته باشید که پنجره
.B pmtime
تنها زمانی قابل مشاهده می‌شود که به‌صورت صریح درخواست شده باشد.
چندین برنامه کلاینت می‌توانند به یک سرور
.B pmtime
واحد متصل شوند \- هنگامی که آخرین برنامه کلاینت خارج شود،
.B pmtime
نیز خارج خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود خط فرمان عبارتند از:
.TP 5
\fB\-p\fR \fIport\fR, \fB\-\-guiport\fR=\fIport\fR
.I port
شماره پورتی است که
.B pmtime
برای ارتباط با کلاینت‌های خود (برنامه‌های پایش) استفاده خواهد کرد.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنمای استفاده و خروج.
.SH "محیط (ENVIRONMENT)"
هنگامی که شماره پورت به‌صورت صریح در خط فرمان از طریق گزینه
.B \-p
درخواست نشده باشد، می‌توان متغیر محیطی
.I PMTIME_PORT
را برای تعیین شماره پورتی تنظیم کرد که بررسی پورت‌های آزاد از آن آغاز می‌شود، زمانی که
.B pmtime
در حال جستجوی شماره پورت برای استفاده است.
.PP
شماره پورت پیش‌فرض برای شروع \fB43334\fP است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی عیب‌یابی اضافی را روی
.I stderr
برای کمک به تفکیک و دسته‌بندی مشکلات فعال می‌کند، اگرچه اطلاعات گاهی مبهم هستند و در درجه اول برای راهنمایی توسعه‌دهندگان به جای کاربران نهایی در نظر گرفته شده‌اند.
.I debug
فهرستی از گزینه‌های اشکال‌زدایی است که با کاما از هم جدا شده‌اند؛ از
.BR pmdbg (1)
همراه با گزینه
.B \-l
برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.PP
گزینه‌های اشکال‌زدایی ویژه
.B pmtime
به شرح زیر هستند:
.TS
box;
lf(B) | lf(B)
lf(B) | lxf(R) .
گزینه	توضیحات
_
appl0	T{
فعال‌سازی عیب‌یابی داخلی که تمام رویدادهای \fBpmtime\fP را گزارش می‌دهد، مانند تنظیم منطقه زمانی، تغییرات وضعیت، تغییرات بازه زمانی، تغییرات مقیاس زمانی و غیره.
T}
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmchart (1)،
.BR pmstat (1)
و
.BR pmval (1).