'\"macro stdmacro
.\"
.\" Copyright (c) 2008 Aconex.  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 PMLOGLABEL 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmloglabel \- بررسی و تعمیر برچسب آرشیو معیارهای کارایی
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmloglabel\f1
[\f3\-lLsv?\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-h\f1 \f2hostname\f1]
[\f3\-p\f1 \f2pid\f1]
[\f3\-V\f1 \f2version\f1]
[\f3\-Z\f1 \f2timezone\f1]
\f2archive\f1
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmloglabel
تمام جزئیات برچسب‌ها را در هر یک از فایل‌های یک آرشیو Performance Co-Pilot (PCP) اعتبارسنجی کرده، گزارش می‌دهد و می‌تواند آن‌ها را اصلاح کند.
این آرشیو دارای نام پایه
.I archive
است و باید پیش‌تر با استفاده از
.BR pmlogger (1)
ایجاد شده باشد.
.PP
هر یک از فایل‌های موجود در یک آرشیو PCP (فراداده، نمایه زمانی، و یک یا چند حجم داده) باید در ابتدا حاوی یک برچسب معتبر باشند، در غیر این صورت ابزارهای PCP از باز کردن آرشیو به‌طور کلی خودداری خواهند کرد.
.PP
بنابراین، عملکرد اصلی
.B pmloglabel
امکان تعمیر هرگونه فیلد ناهماهنگ یا آسیب‌دیده در برچسب است، به گونه‌ای که کل آرشیو از دست نرود.
این دستور باقی‌مانده آرشیو را بررسی نمی‌کند، اما شانس مناسبی برای بازیابی داده‌هایی که در غیر این صورت از دست می‌رفتند فراهم می‌سازد.
دستورهای
.B pmloglabel
و
.B pmlogextract
در کنار یکدیگر قادرند از انواع گوناگون خرابی‌ها، یک آرشیو معتبر PCP تولید کنند.
.PP
توجه داشته باشید که اگر مشخص شود نمایه زمانی آسیب دیده است، فایل "*.index" را می‌توان با خیال راحت کنار گذاشت و آرشیو همچنان در دسترس خواهد بود؛ هرچند بازیابی داده‌ها بدون نمایه ممکن است زمان بیشتری ببرد.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\fB\-h\fR \fIhostname\fR, \fB\-\-host\fR=\fIhostname\fR
اصلاح
.I hostname
ثبت‌شده در برچسب آرشیو، برای تمام فایل‌های موجود در آرشیو.
.TP
\fB\-l\fR, \fB\-\-label\fR
تخلیه و نمایش برچسب آرشیو، شامل نمایش نسخه قالب آرشیو، تاریخ و زمان شروع و پایان (فعلی) آرشیو، و میزبانی که مقادیر معیارهای کارایی از آن جمع‌آوری شده است.
.TP
\fB\-L\fR
مانند
.BR \-l ،
اما با جزئیات کمی بیشتر، که منطقه زمانی و شناسه فرایند ایجادکننده را نیز از برچسب آرشیو نمایش می‌دهد.
.TP
\fB\-p\fR \fIpid\fR, \fB\-\-pid\fR=\fIpid\fR
تنظیم شناسه فرایند ذخیره‌شده در برچسب آرشیو روی
.IR pid ،
برای تمام فایل‌های موجود در آرشیو.
.TP
\fB\-s\fR
بازنویسی مقادیر نگهبان (sentinel values) که پیش و پس از برچسب آرشیو قرار دارند، برای تمام فایل‌های موجود در آرشیو.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
حالت پرگو.
اطلاعات پیشرفت بیشتری در هر مرحله تولید می‌شود.
.TP
\fB\-V\fR \fIversion\fR, \fB\-\-version\fR=\fIversion\fR
ثبت شماره نسخه
.I version
در فیلد عدد جادویی (magic number) در ابتدای برچسب آرشیو، برای تمام فایل‌های موجود در آرشیو.
.TP
\fB\-Z\fR \fItimezone\fR, \fB\-\-timezone\fR=\fItimezone\fR
تغییر منطقه زمانی در برچسب‌های آرشیو به
.I timezone
در قالب متغیر محیطی
.B TZ
مطابق با آنچه در
.BR environ (7)
شرح داده شده است.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنمای استفاده و خروج.
.SH "مثال‌ها (EXAMPLES)"
مثال زیر نحوه استفاده از
.B pmloglabel
را در یافتن و سپس تصحیح یک فیلد آسیب‌دیده (PID) در برچسب نمایه زمانی آرشیوی با نام "20080125" نشان می‌دهد.
.sp 0.5v
.P
.in +1i
.ft CR
.nf
$ pmlogdump \-l 20080125
pmlogdump: Cannot open archive "20080125": Illegal label record at start of a PCP archive file
$ pmloglabel 20080125
Mismatched PID (5264/5011) between temporal index and data volume 0
$ pmloglabel \-p 5264 20080125
$ pmlogdump \-l 20080125
Log Label (Log Format Version 2)
Performance metrics from host fw1
  commencing Fri Jan 25 00:10:09.341 2008
  ending     Sat Jan 26 00:09:54.344 2008
.fi
.SH "وضعیت خروج (EXIT STATUS)"
دستور
.B pmloglabel
در صورتی که برچسب‌های آرشیو سالم باشند با وضعیت 0 خارج می‌شود.
اگر به صورت نادرست فراخوانی شود، وضعیت خروج 1 خواهد بود.
اگر خرابی شناسایی شود و در پایان همچنان وجود داشته باشد، وضعیت خروج 2 خواهد بود.
اگر درخواست نوشتن برچسب‌های آرشیو داده شود و بخشی از این نوشتن با شکست مواجه گردد، وضعیت خروج 3 خواهد بود.
.SH "فایل‌ها (FILES)"
.TP 5
.I $PCP_LOG_DIR/pmlogger/<hostname>
دایرکتوری پیش‌فرض برای آرشیوهای PCP حاوی مقادیر معیارهای کارایی جمع‌آوری‌شده از میزبان
.IR <hostname> .
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های مورد استفاده PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی اطلاعات تشخیصی بیشتر را در
.I stderr
فعال می‌کند تا به تحلیل و دسته‌بندی مشکلات کمک کند، اگرچه این اطلاعات گاهی پیچیده است و در وهله اول برای راهنمایی توسعه‌دهندگان در نظر گرفته شده تا کاربران نهایی.
.I debug
فهرستی از گزینه‌های اشکال‌زدایی است که با کاما از هم جدا شده‌اند؛ از
.BR pmdbg (1)
همراه با گزینه
.B \-l
برای دریافت فهرستی از گزینه‌های موجود اشکال‌زدایی و معانی آن‌ها استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmlogcheck (1),
.BR pmlogdump (1),
.BR pmlogextract (1),
.BR pmlogger (1),
.BR pmlogger_check (1),
.BR pmlogger_daily (1),
.BR pmlogrewrite (1),
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ fw {from hostname fw1}