'\"macro stdmacro
.\"
.\" Copyright (c) 2016,2019 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-NUMASTAT 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pcp-numastat\f1 \- گزارش وضعیت تخصیص حافظه NUMA
.SH "خلاصه دستور (SYNOPSIS)"
\f3pcp\f1 [\f2pcp\ options\f1] \f3numastat\f1
[\fB\-mnV?\fR] [\fB\-w\fR \fIwidth\fR] [\fB\-p\fR [\fIprocess\fR ...]]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pcp-numastat
آمار تخصیص NUMA را از تخصیص‌دهنده حافظه هسته نمایش می‌دهد.
هر فرآیند دارای خط‌مشی‌های NUMA است که مشخص می‌کنند صفحات حافظه روی کدام گره تخصیص یابند.
شمارنده‌های کارایی در هسته پیگیری می‌کنند که حافظه در کدام گره‌ها تخصیص یافته است و این مقادیر توسط
.BR pcp-numastat
نمونه‌برداری و گزارش می‌شوند.
.PP
شمارنده‌ها برای هر گره NUMA به‌طور جداگانه نگهداری می‌شوند.
جزئیات معنایی هر معیار گزارش‌شده را می‌توان با استفاده از دستور زیر به دست آورد:
.P
.ft CR
.nf
.in +0.5i
# pminfo \(hydt mem.numa.alloc
.in
.fi
.SH "گزینه‌ها (OPTIONS)"
هنگامی که این ابزار از طریق دستور
.BR pcp (1)
فراخوانی شود، گزینه‌های
.BR \-h /\c
.BR \-\-host ,
.BR \-a /\c
.BR \-\-archive ,
.BR \-O /\c
.BR \-\-origin ,
.BR \-Z /\c
.BR \-\-timezone
و چندین
.I گزینه دیگر pcp
به‌طور غیرمستقیم در دسترس قرار می‌گیرند؛ برای توضیحات کامل این گزینه‌ها به
.BR PCPIntro (1)
مراجعه کنید.
.PP
گزینه‌های خط فرمان اضافی موجود برای
.B pcp-numastat
عبارتند از:
.TP 5
\fB\-m\fR, \fB\-\-meminfo\fR
نمایش میزان مصرف حافظه در سراسر سیستم، مشابه خروجی meminfo.
.TP
\fB\-n\fR, \fB\-\-numastat\fR
نمایش اطلاعات آماری numastat.
.TP
\fB\-p\fR, \fB\-\-process\fR
نمایش میزان مصرف حافظه NUMA به تفکیک هر فرآیند با استفاده از معیارهای \fBproc.numa_maps\fR.
هر عملوند انتهایی \fIprocess\fR در صورتی که کاملاً عددی باشد به عنوان شناسه فرآیند (PID) و در غیر این صورت به عنوان عبارتی باقاعده برای تطبیق با نام دستور در نظر گرفته می‌شود.
تطبیق برای نام دستورها در برابر خط فرمان کامل (همان‌گونه که توسط \fBproc.psinfo.psargs\fR گزارش می‌شود) انجام می‌گیرد.
هنگامی که تنها یک عملوند شناسه فرآیند ارائه شود و دقیقاً با یک فرآیند مطابقت داشته باشد، جدول مفصلی از نگاشت‌های Hugepage، Heap، Stack و Private نمایش داده می‌شود (مشابه \fBnumastat \-p\fR). هنگامی که چندین عملوند شناسه فرآیند ارائه شود، یک جدول خلاصه به تفکیک فرآیند نمایش داده می‌شود (همچنین مانند \fBnumastat \-p\fR) و ممکن است بر اساس عرض نمایش موجود، به چندین بلوک ستونی از گره‌ها تقسیم شود.
.PP
در نمای تفکیک فرآیند، ستون‌های مربوط به گره‌ها همواره برای تمامی گره‌های NUMA موجود در سیستم (طبق گزارش معیارهای موجودی NUMA در PCP) نشان داده می‌شوند، حتی اگر نمونه‌های معیارهای مجزای \fBproc.numa_maps\fR برخی از گره‌ها را از قلم انداخته باشند. معیارهای ناموجود مربوط به هر فرآیند به صورت صفر گزارش می‌شوند.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش نسخه فعلی دستور.
.TP
\fB\-w\fR \fIwidth\fR, \fB\-\-width\fR=\fIwidth\fR
محدود کردن عرض نمایش به
.IR width .
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنمای نحوه استفاده و خروج.
.SH "نکات (NOTES)"
دستور
.B pcp-numastat
از دستور
.BR numastat (1)
الهام گرفته شده است و در نماهای مربوط به کل سیستم، خروجی مشابهی تولید می‌کند. نمای به تفکیک فرآیند (\fB\-p\fR) از چیدمان \fBnumastat \-p\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 numastat (1).

.\" control lines for scripts/man-spell
.\" +ok+ numastat {from pcp-numastat} NUMA