'\"macro stdmacro
.\"
.\" Copyright (c) 2014,2019-2020 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-FREE 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pcp\-free \- گزارش وضعیت حافظه آزاد و استفاده‌شده در سیستم
.SH "خلاصه دستور (SYNOPSIS)"
\f3pcp\f1
[\f2pcp\ options\f1]
\f3free\f1
[\f3\-bkmgroltVw?\f1]
[\f3\-c\f1 \f2count\f1]
[\f3\-s\f1 \f2interval\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pcp-free
نمایشی خلاصه‌وار از مقدار کل حافظه فیزیکی و مبادله (swap) آزاد و استفاده‌شده در سیستم و همچنین حافظه‌های نهان (caches) استفاده‌شده توسط هسته را ارائه می‌دهد.
.PP
هنگامی که از طریق دستور
.BR pcp (1)
فراخوانی شود، گزینه‌های
.BR \-h /\c
.BR \-\-host ،
.BR \-a /\c
.BR \-\-archive ،
.BR \-O /\c
.BR \-\-origin ،
.BR \-s /\c
.BR \-\-samples ،
.BR \-t /\c
.BR \-\-interval ،
.BR \-Z /\c
.BR \-\-timezone
و چندین گزینه دیگر
.B pcp
به طور غیرمستقیم در دسترس قرار می‌گیرند؛ برای شرح آن‌ها به
.BR PCPIntro (1)
مراجعه کنید.
.PP
ستون‌های نمایش‌داده‌شده عبارتند از:
.TP
\fBtotal\fR
کل حافظه نصب‌شده (MemTotal و SwapTotal در /proc/meminfo)
.TP
\fBused\fR
حافظه استفاده‌شده (محاسبه‌شده به‌صورت \fBtotal\fR \- \fBfree\fR \- \fBbuffers\fR \- \fBcache\fR)
.TP
\fBfree\fR
حافظه استفاده‌نشده (MemFree و SwapFree در /proc/meminfo)
.TP
\fBshared\fR
حافظه استفاده‌شده (عمدتاً) توسط tmpfs (Shmem در /proc/meminfo)
.TP
\fBbuffers\fR
حافظه استفاده‌شده توسط بافرهای هسته (Buffers در /proc/meminfo)
.TP
\fBcache\fR
حافظه استفاده‌شده توسط حافظه نهان صفحات و slabها (Cached و SReclaimable در /proc/meminfo)
.TP
\fBbuff/cache\fR
مجموع \fBbuffers\fR و \fBcache\fR
.TP
\fBavailable\fR
تخمینی از مقدار حافظه‌ای که برای راه‌اندازی برنامه‌های جدید بدون نیاز به مبادله (swapping) در دسترس است.
برخلاف داده‌های ارائه‌شده توسط فیلدهای
\fBcache\fR
یا
\fBfree\fR ،
این فیلد حافظه نهان صفحات را در نظر می‌گیرد و همچنین این نکته را لحاظ می‌کند که همه slabهای حافظه قابل بازپس‌گیری به دلیل در حال استفاده بودن اقلام، بازپس گرفته نخواهند شد (MemAvailable در /proc/meminfo).
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\fB\-b\fP, \fB\-\-bytes\fP
نمایش مقدار حافظه بر حسب بایت.
.TP
\fB\-c\fR \fIcount\fR, \fB\-\-samples\fR=\fIcount\fR, \fB\-\-count\fR=\fIcount\fR
خاتمه دادن به نمایش پس از
\fIcount\fR
تکرار.
همچنین گزینه
.BR \-s
را ببینید.
.TP
\fB\-g\fP, \fB\-\-gigabytes\fP
نمایش مقدار حافظه بر حسب گیگابایت.
.TP
\fB\-k\fP, \fB\-\-kilobytes\fP
نمایش مقدار حافظه بر حسب کیلوبایت.
این حالت پیش‌فرض است.
.TP
\fB\-l\fP, \fB\-\-lohi\fP
نمایش آمار تفصیلی حافظه پایین و بالا (low و high).
.TP
\fB\-m\fP, \fB\-\-megabytes\fP
نمایش مقدار حافظه بر حسب مگابایت.
.TP
\fB-o\fP
غیرفعال کردن نمایش خط "تعدیل‌شده با بافر".
اگر گزینه
\fB-o\fP
مشخص نشود،
\fBfree\fP
حافظه بافر را از حافظه استفاده‌شده کسر کرده و آن را به حافظه آزاد گزارش‌شده اضافه می‌کند.
.TP
\fB\-r\fP, \fB\-\-terabytes\fP
نمایش مقدار حافظه بر حسب ترابایت.
.TP
\fB\-s\fR \fIdelay\fR, \fB\-\-interval\fR=\fIdelay\fR, \fB\-\-seconds\fR=\fIdelay\fR
فعال‌سازی نمونه‌برداری پیوسته در فواصل زمانی
\fIdelay\fP
ثانیه.
می‌توانید هر عدد ممیز شناوری را برای
\fIdelay\fP
تعیین کنید، یا در واقع هر مشخصه معتبر
.BR pmParseInterval (3)
که شامل زمان‌های تأخیر با دقت میکروثانیه است.
این گزینه می‌تواند همراه با گزینه
\fB\-c\fP
به کار رود.
.TP
\fB\-t\fP, \fB\-\-total\fP
نمایش خطی حاوی مقادیر مجموع (totals).
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.TP
\fB\-w\fR, \fB\-\-wide\fR
تغییر به حالت عریض (wide mode).
حالت عریض خطوطی طولانی‌تر از ۸۰ نویسه تولید می‌کند.
در این حالت
\fBbuffers\fR
و
\fBcache\fR
در دو ستون جداگانه گزارش می‌شوند.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنمای استفاده و خروج.
.SH "نکات (NOTES)"
دستور
.B pcp-free
از دستور
.BR free (1)
الهام گرفته شده است و هدف آن سازگاری با گزینه‌های خط فرمان و قالب خروجی آن است.
.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 free (1),
.BR pmParseInterval (3)
و
.BR environ (7).

.\" control lines for scripts/man-spell
.\" +ok+ SReclaimable MemAvailable SwapTotal MemTotal SwapFree MemFree
.\" +ok+ meminfo {from /proc/meminfo} Shmem tmpfs