'\"macro stdmacro
.\"
.\" Copyright (c) 2013-2019 Red Hat.
.\" 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 PMLOGGER_REWRITE 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmlogger_rewrite \- اسکریپت کمکی برای بازنویسی بایگانی‌های Performance Co-Pilot
.SH "خلاصه دستور (SYNOPSIS)"
.B $PCP_BINADM_DIR/pmlogger_rewrite
[\f3\-dNsVvw?\f1]
[\f3\-c\f1 \f2config\f1]
\f2archive\f1 ...
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmlogger_rewrite
یک اسکریپت کمکی است که توسط
.BR pmlogger_daily (1)
هنگام بازنویسی بایگانی‌های Performance Co-Pilot (PCP)
استفاده می‌شود.
بازنویسی معمولاً برای هماهنگی با تغییرات تدریجی فراداده‌ها مورد نیاز است تا بایگانی‌های قدیمی به‌روزرسانی شده و سپس با بایگانی‌های فعلی ادغام شوند.
.PP
اسکریپت
.B pmlogger_rewrite
یک پوشش (wrapper) برای
.BR pmlogrewrite (1)
است که می‌تواند تمام بایگانی‌های منطبق با آرگومان‌های
.I archive
را بازنویسی کند.
هر آرگومان
.I archive
می‌تواند نام فایل یک بایگانی PCP، نام پایه (basename) فایل‌ها در یک بایگانی PCP، یا یک دایرکتوری باشد (که در این حالت تمام بایگانی‌های زیرمجموعه PCP با پیمایش بازگشتی پیدا می‌شوند).
.PP
دستور
.B pmlogrewrite
با گزینهٔ
.B \-i
اجرا می‌شود تا بازنویسی به‌صورت «درجا» (in place) انجام گیرد.
همچنین از گزینهٔ
.B \-q
نیز استفاده می‌شود تا در صورتی که نیازی به بازنویسی نبود، هیچ تغییری در فایل‌های بایگانی ایجاد نشود.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر عیناً به
.BR pmlogrewrite
منتقل می‌شوند:
.hy 0
.B \-c
(یا
.BR \-\-config )،
.B \-d
(یا
.BR \-\-desperate )،
.B \-s
(یا
.BR \-\-scale )،
.B \-v
(یا
.BR \-\-verbose )
و
.B \-w
(یا
.BR \-\-warnings ).
برای اطلاع از مفهوم این گزینه‌ها به
.BR pmlogrewrite (1)
مراجعه کنید.
.br
.hy
.PP
سایر گزینه‌ها عبارتند از:
.TP 5
\fB\-N\fR, \fB\-\-showme\fR
اجرای
.B pmlogger_rewrite
در حالت «نمایشی» یا «آزمایشی» (dry run) که در آن کارهایی که قرار است انجام شوند گزارش می‌شوند، اما هیچ تغییری ایجاد نمی‌شود.
این حالت معمولاً برای اشکال‌زدایی در ترکیب با یک گزینهٔ
.B \-V
(حالت پرگو) یا دو گزینهٔ
.B \-V
(حالت بسیار پرگو) استفاده می‌شود.
.TP
\fB\-V\fR, \fB\-\-verbose\fR
افزایش پرگویی (جزئیات تفصیلی) خروجی اسکریپت.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتربندی نام فایل‌ها و دایرکتوری‌های مورد استفاده PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmlogger (1)،
.BR pmlogger_daily (1)
و
.BR pmlogrewrite (1).