'\"! tbl | mmdoc
'\"macro stdmacro
.\"
.\" Copyright (c) 2025 Oracle and/or its affiliates.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" 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-ROCESTAT 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pcp\-rocestat \- گزارش آمار دستگاه‌های RoCE شرکت nVidia
.SH "خلاصه دستور (SYNOPSIS)"
.B pcp
[\fIگزینه‌های pcp\fR]
.B rocestat
[\fB\-\-hw_stats\fR|\fB\-\-lane_stats\fR]
.SH "توضیحات (DESCRIPTION)"
ابزار
.B pcp-rocestat
از شمارنده‌های ethtool برای هر دستگاه استفاده می‌کند و توان عملیاتی را بر اساس هر صف اولویت گزارش می‌دهد.
به‌طور پیش‌فرض،
.B pcp-rocestat
داده‌های زنده را برای میزبان محلی گزارش می‌کند.
این ابزار همچنین توانایی تحلیل داده‌های حاصل از بایگانی‌های PCP را دارد.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-hw_stats\fP
نمایش شمارنده‌های سخت‌افزاری.
.TP
\fB\-\-lane_stats\fP
نمایش آمار خطوط (lane).
.TP
\fB\-a\fR \fIarchive\fR, \fB\-\-archive\fR=\fIarchive\fR
مشخص کردن بایگانی PCP مورد نظر برای بررسی.
.TP
\fB\-s\fR \fIsamples\fR, \fB\-\-samples\fR=\fIsamples\fR
مشخص کردن تعداد
.I نمونه‌ها
برای گزارش.
.TP
\fB\-S\fR \fIstarttime\fR, \fB\-\-start\fR=\fIstarttime\fR
گزارش نمونه‌های بایگانی از زمان داده‌شده به بعد.
.TP
\fB\-T\fR \fIendtime\fR, \fB\-\-finish\fR=\fIendtime\fR
گزارش نمونه‌های بایگانی تا زمان داده‌شده.
.TP
\fB\-V\fR, \fB\-\-version\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) شرح داده شده است.
.PP
برای مشاهده متغیرهای محیطی تأثیرگذار بر ابزارهای PCP، به \fBpmGetOptions\fP(3) مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pcp (1)،
.BR pmParseInterval (3)
و
.BR environ (7).