'\" t
.\"
.\" Man page for pcp-buddyinfo
.\" 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-BUDDYINFO 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pcp-buddyinfo\f3 \- گزارش آمارهای الگوریتم buddy در هسته لینوکس
.SH "خلاصه دستور (SYNOPSIS)"
\f3pcp\f1
[\f2pcp\ options\f1]
\f3buddyinfo\f1
[\f3\-uVz?\f1]
[\f3\-s\f1 \f2samples\f1]
[\f3\-a\f1 \f2archive\f1]
[\f3\-Z\f1 \f2timezone\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pcp-buddyinfo
برای مشاهده آمارهای مختلف مربوط به buddyinfo استفاده می‌شود.
این ابزار به کاربران کمک می‌کند رفتار پویای الگوریتم buddy را که در زیرسیستم حافظه مجازی هسته لینوکس استفاده می‌شود، تحلیل کنند.
این اطلاعات شامل تعداد کل ناحیه‌های (zones) فعال در حال حاضر، تعداد صفحات با مرتبه‌های مختلف و موارد دیگر است.
به‌طور پیش‌فرض،
.B pcp-buddyinfo
داده‌های زنده را برای میزبان محلی گزارش می‌دهد.
.PP
آمارهای نشان‌داده‌شده به شرح زیر است:

.TS
lfB  lfB
l    lx.
HEADER          توضیحات
_               _
Normal          ناحیه‌های در دسترس
Nodes           گره‌های در دسترس
Order0          صفحه‌های در دسترس از مرتبه 0
Order1          صفحه‌های در دسترس از مرتبه 1
Order2          صفحه‌های در دسترس از مرتبه 2
Order3          صفحه‌های در دسترس از مرتبه 3
Order4          صفحه‌های در دسترس از مرتبه 4
Order5          صفحه‌های در دسترس از مرتبه 5
Order6          صفحه‌های در دسترس از مرتبه 6
Order7          صفحه‌های در دسترس از مرتبه 7
Order8          صفحه‌های در دسترس از مرتبه 8
Order9          صفحه‌های در دسترس از مرتبه 9
Order10         صفحه‌های در دسترس از مرتبه 10
.TE


هر ستون نشان‌دهنده تعداد صفحه‌هایی از یک مرتبه مشخص (یک اندازه مشخص) است که در هر زمان معین در دسترس هستند. برای نمونه، برای ناحیه DMA (دسترسی مستقیم به حافظه)، ۹۰ قطعه حافظه به اندازه 2^(0*PAGE_SIZE) وجود دارد. به همین ترتیب، ۶ قطعه به اندازه 2^(1*PAGE_SIZE) و ۲ قطعه حافظه به اندازه 2^(2*PAGE_SIZE) در دسترس است.
.PP
سطر DMA به نخستین ۱۶ مگابایت در سامانه اشاره دارد، سطر HighMem به تمامی حافظه‌های بالاتر از ۴ گیگابایت در سامانه اشاره می‌کند، و سطر Normal به تمامی حافظه‌های بین این دو اشاره دارد.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-a\fR \fIfile\fR, \fB\-\-archive\fR=\fIfile\fR
واکشی معیارهای buddyinfo از آرشیو PCP مشخص‌شده.
.TP
\fB\-s\fR \fIcount\fR, \fB\-\-samples\fR=\fIcount\fR
محدود کردن گزارش به \fIcount\fR نمونه از آمارهای buddyinfo.
.TP
\fB\-u\fR, \fB\-\-no-interpol\fR
غیرفعال کردن حالت درون‌یابی پیش‌فرض هنگام بازپخش یک آرشیو.
با گزینه
.B \-u
گزارش‌دهی درون‌یابی‌شده غیرفعال می‌شود و هر نمونه بر اساس بازه‌های نمونه‌برداری اصلی درون آرشیو گزارش می‌گردد.
در این حالت گزینه
.B \-t
نادیده گرفته می‌شود.
علاوه بر این، بازپخش بدون درون‌یابی تنها زمانی معنا دارد که یک آرشیو بازپخش شود (با استفاده از گزینه
.B \-a
که در بالا توصیف شد)؛ بنابراین هنگامی که
.B \-u
مشخص شده باشد، استفاده از گزینه
.B \-a
اجباری است.
.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\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "نکات (NOTES)"
دستور
.B pcp-buddyinfo
اطلاعات استخراج‌شده از فایل procfs هسته لینوکس به نشانی \fI/proc/buddyinfo\fP را گزارش می‌دهد.
.PP
اگر حالت درون‌یابی پیش‌فرض غیرفعال باشد، ممکن است برای برخی نمونه‌ها گزارش شود که بعضی معیارها (که در بازه‌های زمانی متفاوتی ثبت شده‌اند) مقادیر مفقود دارند، حتی اگر ثبت شده باشند.
.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 pmGetOptions (3),
.BR pcp.conf (5)
و
.BR environ (7).

.\" control lines for scripts/man-spell
.\" +ok+ PAGE_SIZE buddyinfo {from pcp-buddyinfo} HighMem