'\"macro stdmacro
.\"
.\" Copyright (c) 2024 Red Hat.
.\"
.\" 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 PCP-XSOS 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pcp-xsos\f1 \- گزارش‌های خلاصه و سطح‌بالا برای یک سیستم
.SH "خلاصه دستور (SYNOPSIS)"
\f3pcp\f1
[\f2pcp\ options\f1]
\f3xsos\f1
[\f3\-\-all\f1]
[\f3\-dmnNopx\f1]
[\f3\-u\f1 \f2units\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pcp-xsos
گزارشی خلاصه از یک سیستم را با استفاده از یک آرشیو PCP یا مقادیر متریک زنده از آن سیستم ارائه می‌دهد.
.PP
این ابزار به گونه‌ای طراحی شده است که سریع باشد و مشابه ابزارهایی مانند
.BR ps (1)،
تنها یک نمونه‌برداری منفرد انجام می‌دهد.
از این رو، میزان جزئیات گزارش در ازای سرعت اجرا تعدیل شده است.
.B pcp-xsos
به عنوان یک ابزار تریاژ اولیه عملکرد طراحی شده است که مدیر سیستم را به سرعت از مسیرهای بررسی که ممکن است ثمربخش‌تر باشند آگاه می‌کند.
در حال حاضر تمرکز به طور کامل بر متریک‌های سیستم‌عامل است، اما این یک الزام قطعی نیست و با گذشت زمان ممکن است گسترش یابد تا هر حوزه عملکردی مرتبط با متریک‌های PCP را گزارش کند.
.PP
هنگامی که این ابزار از طریق دستور
.BR pcp (1)
فراخوانی شود،
.I گزینه‌های
.B pcp
شامل
.BR \-h /\c
.BR \-\-host ،
.BR \-a /\c
.BR \-\-archive ،
.BR \-O /\c
.BR \-\-origin
به‌طور غیرمستقیم در دسترس قرار می‌گیرند؛ برای مشاهده توضیحات آن‌ها به
.BR PCPIntro (1)
مراجعه کنید.
.PP
گزارش پیش‌فرض در صورت ارائه نشدن هیچ گزینه خط فرمانی، نمای کلی سیستم‌عامل است.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\fB\-\-all\fP
گزارش‌دهی پشت‌سرهم برای هر زیربخش، یکی پس از دیگری.
.TP
\fB\-o\fP, \fB\-\-os\fP
نمایش گزارش پیش‌فرض همراه با اطلاعات سطح‌بالای هسته، شامل نسخه، مدت زمان روشن بودن سیستم (uptime)، تعداد کاربران، وضعیت فرآیندها و میزان استفاده تجمیعی از پردازنده.
.TP
\fB\-d\fP, \fB\-\-disks\fP
گزارش اطلاعات فضای ذخیره‌سازی از آرشیو یا میزبان زنده، شامل ظرفیت کل هر دستگاه بلوکی و همچنین فضای در دسترس فایل‌سیستم برای هر فایل‌سیستم متصل‌شده (mounted).
.TP
\fB\-m\fP, \fB\-\-memory\fP
گزارش دقیق حافظه، شامل درصد حافظه کل مصرف‌شده برای عملکردهای گوناگون سیستم‌عامل، میزان استفاده از swap، و به صورت اختیاری اطلاعات hugepages و بالون (balloon) حافظه ماشین مجازی.
.TP
\fB\-n\fP, \fB\-\-netdev\fP
آمار مربوط به هر رابط شبکه پیکربندی‌شده، از جمله نرخ انتقال بسته‌ها و بایت‌ها (از زمان راه‌اندازی سیستم)، خطاها، بسته‌های دور انداخته‌شده (drops) و غیره.
علاوه بر این، با این گزینه خط فرمان، آمار سوکت‌ها نیز برای raw، UDP و TCP (هم IPv4 و هم IPv6) گزارش می‌شود.
.TP
\fB\-N\fP, \fB\-\-netstats\fP
گزارش آمار تجمیعی شبکه مانند شمارنده‌های مختلف خطای ICMP و TCP و زمان‌های انقضا (timeouts).
.TP
\fB\-p\fP, \fB\-\-ps\fP
بررسی فرآیندهای در حال اجرا به شیوه‌ای مشابه با
.BR ps .
این فرآیندها گروه‌بندی و پالایش می‌شوند تا مهم‌ترین فرآیندها از نظر استفاده از منابع (CPU، حافظه) و همچنین فرآیندها در وضعیت‌های زامبی (zombie) یا مسدودشده (blocked) نمایش داده شوند.
.TP
\fB\-u\fR \fIunit\fP, \fB\-\-units\fR=\fIunit\fR
تغییر واحد نمایش بایت برای گزارش‌های گوناگون.
مقادیر معتبر برای
.I unit
عبارتند از \(lqb\(rq (بایت)، \(lqk\(rq (کیبی‌بایت)، \(lqm\(rq (میبی‌بایت)، \(lqg\(rq (گیبی‌بایت) یا \(lqt\(rq (تبی‌بایت).
.TP
\fB\-x\fP, \fB\-\-nocolor\fP
نمایش گزارش‌ها بدون استفاده از رنگ برای برجسته‌سازی جنبه‌های گوناگون هر زیرسیستم.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "نکات (NOTES)"
ابزار
.B pcp-xsos
از ابزار
.BR xsos
الهام گرفته شده است و هدف آن سازگاری با خط فرمان آن در صورت امکان و همچنین ارائه سبکی یکپارچه در خروجی است.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتربندی نام فایل‌ها و دایرکتوری‌های مورد استفاده PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.PP
برای مشاهده متغیرهای محیطی که بر ابزارهای PCP تأثیر می‌گذارند، به \fBpmGetOptions\fP(3) مراجعه کنید که عملکردهای \fBpmgetopt\fP(1) مورد استفاده توسط \fBpcp-xsos\fP را فراهم می‌کند.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pcp (1)،
.BR ps (1)،
.BR pmgetopt (1)،
.BR pmGetOptions (3)
و
.BR environ (7).

.\" control lines for scripts/man-spell