'\"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_MERGE 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmlogger_merge\f1 \- اسکریپت کمکی برای ادغام بایگانی‌های Performance Co-Pilot
.SH "خلاصه دستور (SYNOPSIS)"
.B $PCP_BINADM_DIR/pmlogger_merge
[\f3\-fNVE?\f1]
[\f2input-basename\f1 ... \f2output-name\f1]
.SH "توضیحات (DESCRIPTION)"
.B pmlogger_merge
یک اسکریپت کمکی است که توسط
.BR pmlogger_daily (1)
هنگام ادغام تمام بایگانی‌های Performance Co-Pilot (PCP)
مربوط به یک میزبان منفرد در یک روز مشخص،
درون یک بایگانی ادغام‌شده PCP استفاده می‌شود.
.PP
.B pmlogger_merge
یک اسکریپت پوششی برای
.BR pmlogextract (1)
است که تمام بایگانی‌های منطبق با آرگومان‌های
.I input-basename
را ادغام کرده و با استفاده از
.I output-name
به‌عنوان نام پایه برای فایل‌های فیزیکی تشکیل‌دهنده بایگانی،
یک بایگانی جدید ایجاد می‌کند.
آرگومان‌های
.I input-basename
می‌توانند حاوی نویسه‌های عام به سبک
.BR sh (1)
باشند.
.PP
اگر هر یک از فایل‌های تشکیل‌دهنده بایگانی‌های
.I input-basename
فشرده شده باشند، در صورت موفقیت،
.B pmlogger_merge
فایل‌های
.I output-name
را با استفاده از
.BR pmlogcompress (1)
فشرده‌سازی خواهد کرد.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود خط فرمان عبارتند از:
.TP 5
\fB\-f\fR, \fB\-\-force\fR
این گزینه باعث می‌شود پس از ایجاد بایگانی خروجی، تمامی فایل‌های ورودی حذف شوند.
.TP
\fB\-N\fR, \fB\-\-showme\fR
اجرای
.B pmlogger_merge
در حالت «show me» یا «dry run» (اجرای آزمایشی) که در آن،
وظایفی که قرار است انجام شوند گزارش می‌شوند اما هیچ تغییری اعمال نمی‌شود.
این حالت معمولاً برای اشکال‌زدایی در ترکیب با یک گزینه
.B \-V
(با جزئیات) یا دو گزینه
.B \-V
(با جزئیات زیاد) استفاده می‌شود.
.TP
\fB\-V\fR, \fB\-\-verbose\fR
افزایش میزان جزئیات در گزارش پیشرفت خروجی.
.TP
\fB\-E\fR, \fB\-\-expunge\fR
هنگامی که تفاوت‌هایی در فراداده‌های سنجه‌ها بین بایگانی‌های مدنظر برای ادغام مشاهده شود،
رفتار پیش‌فرض
.B pmlogger_merge
این است که با یک خطای مهلک متوقف شود و بایگانی \f2output-name\f1 ایجاد نگردد.
در عوض، پرچم
.B \-E
یک هشدار صادر می‌کند و سنجه‌های متأثر را از بایگانی خروجی ادغام‌شده حذف می‌کند.
این مورد برای چرخش خودکار روزانه بایگانی‌ها در نظر گرفته شده است،
جایی که موفقیت‌آمیز بودن ادغام، بازنویسی و فشرده‌سازی بدون‌نظارت بایگانی‌های روزانه بسیار حائز اهمیت است.
همچنین ببینید:
.BR pmlogger_daily (1)
و پرچم
.B \-x
در
.BR pmlogextract (1).
.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 pmlogcompress (1),
.BR pmlogextract (1),
.BR pmlogger (1)
و
.BR pmlogger_daily (1).