.\" -*- coding: UTF-8 -*-
.\" Copyright 2006, Red Hat, Inc.
.\" Copyright 2013, Michael Kerrisk <mtk.manpages@gmail.com>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH perfmonctl 2 "22 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
perfmonctl \- واجهة لوحدة مراقبة الأداء IA\-64
.SH موجز
.nf
\fB#include <syscall.h>\fP
\fB#include <perfmon.h>\fP
.P
\fBlong perfmonctl(\fPint narg;
\fB                int \fP\fIfd\fP\fB, int \fP\fIcmd\fP\fB, void \fP\fIarg\fP\fB[\fP\fInarg\fP\fB], int \fP\fInarg\fP\fB);\fP
.fi
.P
\fIملاحظة\fP: لا يوجد غلاف glibc لاستدعاء النظام هذا؛ انظر HISTORY.
.SH الوصف
استدعاء النظام \fBperfmonctl\fP()  الخاص بـ IA\-64 يوفر واجهة لوحدة مراقبة
الأداء (PMU). تتكون PMU من سجلات PMD (بيانات مراقبة الأداء) وسجلات PMC (تحكم
مراقبة الأداء)، والتي تجمع إحصائيات العتاد.
.P
\fBperfmonctl\fP()  يطبق العملية \fIcmd\fP على وسائط الإدخال المحددة بواسطة
\fIarg\fP. عدد الوسائط يُعرف بواسطة \fInarg\fP. وسيطة \fIfd\fP تحدد سياق perfmon
المراد العمل عليه.
.P
القيم المدعومة لـ \fIcmd\fP هي:
.TP 
\fBPFM_CREATE_CONTEXT\fP
.nf
\fBperfmonctl(int \fP\fIfd\fP\fB, PFM_CREATE_CONTEXT, pfarg_context_t *\fP\fIctxt\fP\fB, 1);\fP
.fi
إعداد سياق.
.IP
وسيط \fIfd\fP يُتجاهل. يتم إنشاء سياق perfmon جديد كما هو محدد في \fIctxt\fP
ويُعاد واصف الملف الخاص به في \fIctxt\->ctx_fd\fP.
.IP
يمكن استخدام واصف الملف في الاستدعاءات اللاحقة لـ \fBperfmonctl\fP()  ويمكن
استخدامه لقراءة إشعارات الأحداث (نوع \fIpfm_msg_t\fP) باستخدام \fBread\fP(2). واصف
الملف قابل للاستقصاء باستخدام \fBselect\fP(2) و\fBpoll\fP(2) و\fBepoll\fP(7).
.IP
يمكن تدمير السياق باستدعاء \fBclose\fP(2) على واصف الملف.
.TP 
\fBPFM_WRITE_PMCS\fP
.\" pfm_write_pmcs()
.nf
\fBperfmonctl(int \fP\fIfd\fP\fB, PFM_WRITE_PMCS, pfarg_reg_t *\fP\fIpmcs\fP\fB, n);\fP
.fi
تعيين سجلات PMC.
.TP 
\fBPFM_WRITE_PMDS\fP
.nf
\fBperfmonctl(int \fP\fIfd\fP\fB, PFM_WRITE_PMDS, pfarg_reg_t *\fP\fIpmds\fP\fB, n);\fP
.fi
.\" pfm_write_pmds()
تعيين سجلات PMD.
.TP 
\fBPFM_READ_PMDS\fP
.\" pfm_read_pmds()
.nf
\fBperfmonctl(int \fP\fIfd\fP\fB, PFM_READ_PMDS, pfarg_reg_t *\fP\fIpmds\fP\fB, n);\fP
.fi
قراءة سجلات PMD.
.TP 
\fBPFM_START\fP
.\" pfm_start()
.nf
.\" .BI  "perfmonctl(int " fd ", PFM_START, arg, 1);
\fBperfmonctl(int \fP\fIfd\fP\fB, PFM_START, NULL, 0);\fP
.fi
بدء المراقبة.
.TP 
\fBPFM_STOP\fP
.\" pfm_stop()
.nf
\fBperfmonctl(int \fP\fIfd\fP\fB, PFM_STOP, NULL, 0);\fP
.fi
إيقاف المراقبة.
.TP 
\fBPFM_LOAD_CONTEXT\fP
.\" pfm_context_load()
.nf
\fBperfmonctl(int \fP\fIfd\fP\fB, PFM_LOAD_CONTEXT, pfarg_load_t *\fP\fIlargs\fP\fB, 1);\fP
.fi
أرفق السياق بخيط.
.TP 
\fBPFM_UNLOAD_CONTEXT\fP
.\" pfm_context_unload()
.nf
\fBperfmonctl(int \fP\fIfd\fP\fB, PFM_UNLOAD_CONTEXT, NULL, 0);\fP
.fi
افصل السياق عن خيط.
.TP 
\fBPFM_RESTART\fP
.\" pfm_restart()
.nf
\fBperfmonctl(int \fP\fIfd\fP\fB, PFM_RESTART, NULL, 0);\fP
.fi
أعد تشغيل المراقبة بعد تلقي إشعار تجاوز.
.TP 
\fBPFM_GET_FEATURES\fP
.\" pfm_get_features()
.nf
\fBperfmonctl(int \fP\fIfd\fP\fB, PFM_GET_FEATURES, pfarg_features_t *\fP\fIarg\fP\fB, 1);\fP
.fi
.TP 
\fBPFM_DEBUG\fP
.\" pfm_debug()
.nf
\fBperfmonctl(int \fP\fIfd\fP\fB, PFM_DEBUG, \fP\fIval\fP\fB, 0);\fP
.fi
إذا كانت \fIval\fP غير صفرية، فعّل وضع التصحيح، وإلا فعطّله.
.TP 
\fBPFM_GET_PMC_RESET_VAL\fP
.\" pfm_get_pmc_reset()
.nf
\fBperfmonctl(int \fP\fIfd\fP\fB, PFM_GET_PMC_RESET_VAL, pfarg_reg_t *\fP\fIreq\fP\fB, n);\fP
.fi
.\"
.\"
.\" .TP
.\" .B PFM_CREATE_EVTSETS
.\"
.\" create or modify event sets
.\" .nf
.\" .BI  "perfmonctl(int " fd ", PFM_CREATE_EVTSETS, pfarg_setdesc_t *desc , n);
.\" .fi
.\" .TP
.\" .B PFM_DELETE_EVTSETS
.\" delete event sets
.\" .nf
.\" .BI  "perfmonctl(int " fd ", PFM_DELETE_EVTSET, pfarg_setdesc_t *desc , n);
.\" .fi
.\" .TP
.\" .B PFM_GETINFO_EVTSETS
.\" get information about event sets
.\" .nf
.\" .BI  "perfmonctl(int " fd ", PFM_GETINFO_EVTSETS, pfarg_setinfo_t *info, n);
.\" .fi
أعد ضبط سجلات PMC إلى القيم المبدئية.
.SH "قيمة الإرجاع"
ترجع \fBperfmonctl\fP() صفرًا عند نجاح العملية. عند الخطأ، تُرجع \-1 ويُضبط
\fIerrno\fP للإشارة إلى الخطأ.
.SH المعايير
لينكس على IA\-64.
.SH التاريخ
.\" commit ecf5b72d5f66af843f189dfe9ce31598c3e48ad7
لينكس 2.4. أُزيل في لينكس 5.10.
.P
كانت استدعاء النظام هذا معطلاً لسنوات عديدة، وأُزيل نهائيًا في لينكس 5.10.
.P
لا توفر glibc غلافًا لاستدعاء النظام هذا؛ على النوى التي يوجد فيها، استدعه
باستخدام \fBsyscall\fP(2).
.SH "انظر أيضًا"
\fBgprof\fP(1)
.P
مواصفات واجهة perfmon2
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .