'\"macro stdmacro
.\"
.\" Copyright (c) 2023 Ken McDonell.  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 PMLOGREDACT 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmlogredact\f1 \- حذف اطلاعات حساس از آرشیوهای PCP
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmlogredact\f1
[\f3\-vx?\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-c\f1 \f2config\f1]
\f2inarch\f1 [\f2outarch\f1]
.SH "توضیحات (DESCRIPTION)"
آرشیوهای Performance Co-Pilot (PCP) ممکن است حاوی حجم زیادی از اطلاعات جمع‌آوری‌شده از تمامی مؤلفه‌های یک سیستم باشند.
.PP
بخشی از این اطلاعات ممکن است خارج از بستر جمع‌آوری اولیه برای تحلیل عملکرد سیستم، حساس تلقی شوند.
نمونه‌هایی از اطلاعات حساس می‌تواند شامل نام‌های کاربری، مسیرهای دایرکتوری‌های خانگی کاربران (که ممکن است به نام‌های کاربری اشاره داشته باشند)، نام‌های میزبان، نشانی‌های IP، نشانی‌های MAC، آرگومان‌های خط فرمان، متغیرهای محیطی فرایند و غیره باشد.
.PP
.B pmlogredact
می‌تواند برای حذف اطلاعات حساس پیش از ارسال آرشیوها به سازمانی دیگر، یا ذخیره‌سازی آن‌ها در موقعیت جغرافیایی دیگر، و یا جهت برآورده کردن الزامات قانونی یا حفظ حریم خصوصی استفاده شود.
آرشیو خروجی
.I outarch
نسخه پالایش‌شده آرشیو ورودی
.IR inarch
است.
.PP
.B pmlogredact
لایه‌ای سبک بر روی
.BR pmlogrewrite (1)
است، بنابراین فایل‌های پیکربندی
.B pmlogredact
از همان نحوِ فایل‌های پیکربندی
.BR pmlogrewrite (1)
پیروی می‌کنند.
.PP
مجموعه‌ای پیش‌فرض از قواعد پالایش در فایل‌های
.I $PCP_VAR_DIR/config/pmlogredact/*
وجود دارد.
این قواعد برخی از معیارها را حذف می‌کنند، دامنه‌های نمونه (instance domains) برخی از معیارها را بازنویسی کرده و مقادیر برخی از معیارها را بازنویسی می‌نمایند.
.hy 0
گزینه
.B \-x
(یا
.BR \-\-exclude\-std )
می‌تواند برای
.B عدم
استفاده از مجموعه قواعد پیش‌فرض به کار رود.
.PP
.hy
فایل‌های پیکربندی اضافی (یا جایگزین) را می‌توان با یک یا چند گزینه
.B \-c
(یا
.hy 0
.BR \-\-config )
.hy
مشخص کرد، که در آن هر
.I config
یا یک فایل است یا یک دایرکتوری (به معنای تمامی فایل‌های درون آن دایرکتوری).
.PP
گزینه
.B \-v
(یا
.BR \-\-verbose )
جزئیات بیشتری به خروجی می‌افزاید (و مستقیماً به
.BR pmlogrewrite (1)
منتقل می‌شود).
.PP
گزینه
.B \-?
(یا
.BR \-\-help )
پیام راهنمای نحوه استفاده را نمایش داده و خارج می‌شود.
.SH "فایل‌ها (FILES)"
.TP 5
.I $PCP_VAR_DIR/config/pmlogredact/*
قواعد پیش‌فرض پالایش
.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 pmlogrewrite (1)،
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ std