'\" t
.\"
.\" Copyright (c) 2023 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-ZONEINFO 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pcp-zoneinfo\f1 \- گزارش آمارهای ناحیه‌های NUMA
.SH "خلاصه دستور (SYNOPSIS)"
\f3pcp\f1
[\f2pcp\ options\f1]
\f3zoneinfo\f1
[\f3\-Vz?\f1]
[\f3\-s\f1 \f2samples\f1]
[\f3\-a\f1 \f2archive\f1]
[\f3\-S\f1 \f2start_time\f1]
[\f3\-T\f1 \f2end_time\f1]
[\f3\-Z\f1 \f2timezone\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pcp-zoneinfo
برای مشاهده انواع مختلف آمارهای مرتبط با گره‌های NUMA به کار می‌رود.
این دستور با استفاده از گزینه‌های گوناگون، به کاربر کمک می‌کند تا اطلاعات سودمندی در رابطه با دسترسی‌پذیری ناحیه‌ها برای گره‌های مختلف NUMA را تحلیل کند.
این قابلیت برای بررسی رفتار حافظه مجازی مفید است.
به‌طور پیش‌فرض،
.B pcp-zoneinfo
داده‌های زنده را برای میزبان محلی گزارش می‌دهد.

آمارهای نشان داده شده به شرح زیر هستند:

.TS
cfB s
lfB lfB
l   lx.
آمارهای هر گره (برای هر گره NUMA)
سرآیند	توضیحات
nr_inactive_anon	صفحه‌های ناشناس غیرفعال ناحیه
nr_active_anon	صفحه‌های حافظه ناشناس فعال
nr_inactive_file	صفحه‌های حافظه پرونده غیرفعال
nr_active_file	صفحه‌های حافظه پرونده فعال
nr_unevictable	صفحه‌های تخلیه‌ناپذیر
nr_slab_reclaimable	صفحه‌های slab قابل بازپس‌گیری
nr_slab_unreclaimable	صفحه‌های slab غیرقابل بازپس‌گیری
nr_isolated_anon	صفحه‌های حافظه ناشناس مجزا
nr_isolated_file	صفحه‌های حافظه پرونده مجزا
nr_anon_pages	صفحه‌های pagecache نگاشت‌شده ناشناس
nr_mapped	صفحه‌های pagecache نگاشت‌شده
nr_file_pages	صفحه‌های pagecache پرونده
nr_dirty	وضعیت کثیف صفحه‌ها
nr_writeback	وضعیت بازنویسی صفحه‌ها
nr_writeback_temp	صفحه‌های بازنویسی موقت
nr_shmem	صفحه‌های حافظه اشتراکی
nr_shmem_hugepages	صفحه‌های بزرگ حافظه اشتراکی
nr_shmem_pmdmapped	نگاشت‌های PMD حافظه اشتراکی
nr_file_hugepages	صفحه‌های بزرگ مبتنی بر پرونده
nr_file_pmdmapped	نگاشت‌های PMD مبتنی بر پرونده
nr_anon_transparent_hugepages	T{
.ad l
صفحه‌های بزرگ شفاف ناشناس
T}
nr_unstable	صفحه‌های در وضعیت ناپایدار در هر ناحیه
nr_vmscan_write	T{
.ad l
صفحه‌های نوشته‌شده از LRU توسط پویشگر VM.
قرار است VM تعداد صفحاتی را که از LRU
نوشته می‌شوند به حداقل برساند (به‌منظور
بهره‌وری زمان‌بندی ورودی/خروجی و موفقیت در بازپس‌گیری).
T}
nr_vmscan_immediate_reclaim	T{
.ad l
اولویت‌بندی برای بازپس‌گیری در هنگام پایان بازنویسی
T}
nr_dirtied	صفحه‌های واردشده به وضعیت کثیف
nr_written	صفحه‌های نوشته‌شده در هر ناحیه
nr_kernel_misc_reclaimable	صفحه‌های متفرقه قابل بازپس‌گیری هسته
.TE

.TS
cfB s
lfB lfB
l   lx.
آمارهای هر ناحیه (در هر ناحیه برای هر گره NUMA)
سرآیند	توضیحات
pages free	فضای آزاد
pages min	حداقل فضا
pages low	فضای کم
pages high	فضای زیاد
pages spanned	فضای پوشش‌یافته
pages present	فضای موجود
pages managed	فضای مدیریت‌شده
pages protection	فضای حفاظت
nr_free_pages	تعداد صفحه‌های آزاد
nr_zone_inactive_anon	صفحه‌های ناشناس غیرفعال ناحیه
nr_zone_active_anon	صفحه‌های ناشناس فعال ناحیه
nr_zone_inactive_file	صفحه‌های مبتنی بر پرونده غیرفعال ناحیه
nr_zone_active_file	صفحه‌های مبتنی بر پرونده فعال ناحیه
nr_zone_unevictable	صفحه‌های تخلیه‌ناپذیر ناحیه
nr_zone_write_pending	صفحه‌های در انتظار نوشتن ناحیه
nr_mlock	صفحه‌های تحت mlock
nr_page_table_pages	صفحه‌های جدول صفحه
nr_kernel_stack	صفحه‌های پشته هسته
nr_bounce	صفحه‌های بافر جهش (bounce buffer)
nr_zspages	صفحه‌های تخصیص‌دهنده حافظه zsmalloc
nr_free_cma	صفحه‌های آزاد تخصیص‌دهنده حافظه پیوسته (CMA)
numa_hit	T{
.ad l
تخصیص‌های موفق از ناحیه مرجح NUMA
T}
numa_miss	T{
.ad l
تخصیص‌های ناموفق از ناحیه مرجح NUMA
T}
numa_foreign	تخصیص‌های خارجی ناحیه NUMA
numa_interleave	تخصیص‌های متناوب در NUMA
numa_local	T{
.ad l
تخصیص‌های موفق از ناحیه محلی NUMA
T}
numa_other	T{
.ad l
تخصیص‌های ناموفق از ناحیه محلی NUMA
T}
.TE

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-a\fR \fIfile\fR, \fB\-\-archive\fR=\fIfile\fR
دریافت /proc/zoneinfo برای یک \fIfile\fR بایگانی مشخص‌شده.
.TP
\fB\-s\fR \fIcount\fR, \fB\-\-samples\fR=\fIcount\fR
گرفتن آمارهای zoneinfo به تعداد \fIcount\fR نمونه مشخص‌شده.
.TP
\fB\-S\fR, \fB\-\-start\fR=\fItime\fR
پالایش نمونه‌ها از بایگانی از \fItime\fR داده‌شده به بعد.
.TP
\fB\-T\fR, \fB\-\-finish=time\fR
پالایش نمونه‌ها از بایگانی تا \fItime\fR داده‌شده.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.TP
\fB\-z\fR, \fB\-\-hostzone\fR
استفاده از منطقه زمانی محلی میزبانی که منبع معیارهای کارایی است، همان‌طور که با گزینه‌های
.B \-h
یا
.B \-a
مشخص شده است.
پیش‌فرض استفاده از منطقه زمانی میزبان محلی است.
.TP
\fB\-Z\fR \fItimezone\fR, \fB\-\-timezone\fR=\fItimezone\fR
استفاده از
.I timezone
برای تاریخ و زمان.
قالب
.I timezone
مشابه متغیر محیطی
.B TZ
است، همان‌طور که در
.BR environ (7)
شرح داده شده است.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "نکات (NOTES)"
.B pcp-zoneinfo
اطلاعات را از
.IR /proc/zoneinfo
جمع‌آوری می‌کند.
.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).


.\" control lines for scripts/man-spell
.\" +ok+ nr_anon_transparent_hugepages nr_vmscan_immediate_reclaim
.\" +ok+ nr_kernel_misc_reclaimable nr_slab_unreclaimable
.\" +ok+ nr_zone_inactive_anon nr_zone_inactive_file nr_zone_write_pending
.\" +ok+ nr_page_table_pages nr_slab_reclaimable nr_zone_active_anon
.\" +ok+ nr_zone_active_file nr_zone_unevictable nr_shmem_hugepages
.\" +ok+ nr_shmem_pmdmapped nr_file_hugepages nr_file_pmdmapped
.\" +ok+ nr_writeback_temp nr_inactive_anon nr_inactive_file nr_isolated_anon
.\" +ok+ nr_isolated_file nr_kernel_stack nr_vmscan_write numa_interleave
.\" +ok+ nr_active_anon nr_active_file nr_unevictable unreclaimable
.\" +ok+ nr_anon_pages nr_file_pages nr_free_pages nr_writeback numa_foreign
.\" +ok+ unevictable nr_free_cma nr_unstable nr_dirtied nr_written nr_zspages
.\" +ok+ prioritise numa_local numa_other pagecache nr_bounce nr_mapped
.\" +ok+ writeback numa_miss minimise Zoneinfo nr_dirty nr_mlock nr_shmem
.\" +ok+ zsmalloc numa_hit mlock NUMA numa VM
.\" +ok+ PMD {not PMCD from shared memory PMD mappings}