'\"macro stdmacro
.\"
.\" Copyright (c) 2014 Joseph White
.\"
.\" 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 PERFALLOC 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
perfalloc \- اطلاع‌رسانی به
.BR pmdaperfevent (1)
برای غیرفعال‌سازی تخصیص شمارنده‌های سخت‌افزاری
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/perfevent/perfalloc\f1
[\f3\-D\f1]
[\f3\-d\f1]
[\f3\-f\f1 \f2lockfile\f1]
[\f3\-h\f1]
[\f3\-v\f1]
[\f2commandline\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B perfalloc
به
.BR pmdaperfevent (1)
اطلاع می‌دهد تا جمع‌آوری رویدادهای شمارنده‌های سخت‌افزاری را غیرفعال کند.
این کار به فرایندهای بدون امتیاز اجازه می‌دهد از شمارنده‌های سخت‌افزاری استفاده کنند.
.PP
اگر درخواست رزرو با شکست مواجه شود،
.B perfalloc
بلافاصله با کد خروج EXIT_FAILURE خارج می‌شود.
در صورت موفقیت‌آمیز بودن،
.B perfalloc
تا زمان دریافت یک سیگنال kill اجرا خواهد شد.
درخواست رزرو تا زمانی که
.B perfalloc
در حال اجرا باشد، برقرار می‌ماند.
.PP
توجه داشته باشید که
.B pmdaperfevent
تحت تأثیر مقدار تنظیمات
.I kernel.perf_event_paranoid
است که می‌تواند توسط
.BR sysctl (8)
تنظیم شود.
.PP
اگر یک خط فرمان مشخص شده باشد، به عنوان یک زیرفرایند از عامل اجرا می‌شود.
با پایان یافتن دستور، عامل نیز متوقف خواهد شد.
.PP
توضیح مختصری از گزینه‌های خط فرمان در ادامه آمده است:
.TP 5
.B \-D
اجرا در پیش‌زمینه (پیش‌فرض)
.TP
.B \-d
اجرا در پس‌زمینه
.TP
.B \-f FILE
استفاده از FILE به عنوان فایل قفل (پیش‌فرض: $PCP_PMDAS_DIR/perfevent/perflock)
.TP
.B \-h
نمایش پیام راهنما و خروج
.TP
.B \-v
نمایش شماره نسخه و خروج
.PD
.SH "گزارش باگ‌ها (BUGS)"
ممکن است بین درخواست perfalloc برای غیرفعال‌سازی شمارنده سخت‌افزاری و پردازش درخواست توسط perfevent PMDA تا ۱۰۰ میلی‌ثانیه تأخیر وجود داشته باشد.
.PP
فرایند perfalloc وضعیت درخواست را بررسی نمی‌کند و بنابراین قادر نیست تأییدی قطعی مبنی بر موفقیت‌آمیز بودن درخواست و غیرفعال شدن شمارنده‌های سخت‌افزاری ارائه دهد.
.SH "همچنین ببینید (SEE ALSO)"
.BR pmdaperfevent (1)،
.BR perfevent.conf (3)
و
.BR sysctl (8).

.\" control lines for scripts/man-spell
.\" +ok+ EXIT_FAILURE perf_event_paranoid perfevent
.\" +ok+ perflock {from PCP_PMDAS_DIR/perfevent/perflock}