'\"macro stdmacro
.\"
.\" Copyright (c) 2020 Red Hat.  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 PMLOGPASTE 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmlogpaste \- درج متن در یک متریک در آرشیو PCP
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmlogpaste\f1
[\f3\-?\f1]
[\f3\-f\f1 \f2file\f1]
[\f3\-h\f1 \f2hostname\f1]
[\f3\-l\f1 \f2label\f1]
[\f3\-m\f1 \f2metric\f1]
[\f3\-o\f1 \f2outfile\f1]
[\f3\-t\f1 \f2timezone\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmlogpaste
متن ورودی را از یک فایل یا خط فرمان دریافت کرده و آن را به عنوان مقدار یک متریک در یک آرشیو جدید PCP می‌نویسد.
این مقدار متریک با زمان فعلی برچسب زمانی می‌خورد و به عنوان یک متریک از نوع رشته (string) ذخیره می‌شود.
.PP
هدف اصلی این ابزار دریافت خروجی‌های ثبت‌شده و نگهداری آن‌ها در یک آرشیو PCP است.
این قابلیت اجازه می‌دهد، برای مثال، خروجی حاصل از اجرای یک بنچمارک در کنار متریک‌های کارایی ثبت‌شده در طول آن اجرا، در قالب یک آرشیو واحد ذخیره شوند.
آرشیوها را می‌توان با استفاده از ابزار
.BR pmlogextract (1)
ادغام کرد.
.PP
ابزار
.B pmlogpaste
به صورت داخلی از رابط‌های کتابخانه
.BR LOGIMPORT (3)
استفاده می‌کند که از ایجاد آرشیوها از منابع خارجیِ داده‌های کارایی پشتیبانی می‌کنند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود در خط فرمان عبارتند از:
.TP 5
\fB\-f\fR \fIfile\fR, \fB\-\-file\fR=\fIfile\fR
فایلی با متن ورودی که باید آرشیو شود، یا «\-» برای ورودی استاندارد.
.TP
\fB\-h\fR \fIhostname\fR, \fB\-\-hostname\fR=\fIhostname\fR
نام میزبان مبدأ برای آرشیو.
مقدار پیش‌فرض، نام میزبان محلی است، یا اگر دریافت آن ممکن نباشد «localhost» خواهد بود.
.TP
\fB\-l\fR \fIlabel\fR, \fB\-\-label\fR=\fIlabel\fR
افزودن برچسب‌های متنی (context labels) به آرشیو تولیدشده.
این گزینه می‌تواند چندین بار مشخص شود تا برچسب‌های متعددی در آرشیو ایجاد گردند.
مقدار
.I label
باید به قالب
.IR name:value
باشد.
.TP
\fB\-m\fR \fImetric\fR, \fB\-\-metric\fR=\fImetric\fR
نام متریک برای آرشیو.
نام پیش‌فرض متریک
.IR paste.value
است.
.TP
\fB\-o\fR \fIoutfile\fR, \fB\-\-outfile\fR=\fIoutfile\fR
فایل خروجی آرشیو.
نام پیش‌فرض آرشیو
.IR paste
است.
.TP
\fB\-t\fR \fItimezone\fR, \fB\-\-timezone\fR=\fItimezone\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 pmcd (1)،
.BR pmlogextract (1)
و
.BR LOGIMPORT (3).