perfmonctl(2)

الاسم
perfmonctl - واجهة لوحدة مراقبة الأداء IA-64

موجز
#include <syscall.h>
#include <perfmon.h>

long perfmonctl(int narg;
                int fd, int cmd, void arg[narg], int narg);

ملاحظة: لا يوجد غلاف glibc لاستدعاء النظام هذا؛ انظر HISTORY.

الوصف
استدعاء النظام perfmonctl() الخاص بـ IA-64 يوفر واجهة لوحدة مراقبة الأداء (PMU). تتكون PMU من سجلات PMD (بيانات مراقبة الأداء) وسجلات PMC (تحكم مراقبة الأداء)، والتي تجمع إحصائيات العتاد.

perfmonctl() يطبق العملية cmd على وسائط الإدخال المحددة بواسطة arg. عدد الوسائط يُعرف بواسطة narg. وسيطة fd تحدد سياق perfmon المراد العمل عليه.

القيم المدعومة لـ cmd هي:

PFM_CREATE_CONTEXT
    perfmonctl(int fd, PFM_CREATE_CONTEXT, pfarg_context_t *ctxt, 1);
    إعداد سياق.

    وسيط fd يُتجاهل. يتم إنشاء سياق perfmon جديد كما هو محدد في ctxt ويُعاد واصف الملف الخاص به في ctxt->ctx_fd.

    يمكن استخدام واصف الملف في الاستدعاءات اللاحقة لـ perfmonctl() ويمكن استخدامه لقراءة إشعارات الأحداث (نوع pfm_msg_t) باستخدام read(2). واصف الملف قابل للاستقصاء باستخدام select(2) وpoll(2) وepoll(7).

    يمكن تدمير السياق باستدعاء close(2) على واصف الملف.

PFM_WRITE_PMCS
    perfmonctl(int fd, PFM_WRITE_PMCS, pfarg_reg_t *pmcs, n);
    تعيين سجلات PMC.

PFM_WRITE_PMDS
    perfmonctl(int fd, PFM_WRITE_PMDS, pfarg_reg_t *pmds, n);
    تعيين سجلات PMD.

PFM_READ_PMDS
    perfmonctl(int fd, PFM_READ_PMDS, pfarg_reg_t *pmds, n);
    قراءة سجلات PMD.

PFM_START
    perfmonctl(int fd, PFM_START, NULL, 0);
    بدء المراقبة.

PFM_STOP
    perfmonctl(int fd, PFM_STOP, NULL, 0);
    إيقاف المراقبة.

PFM_LOAD_CONTEXT
    perfmonctl(int fd, PFM_LOAD_CONTEXT, pfarg_load_t *largs, 1);
    أرفق السياق بخيط.

PFM_UNLOAD_CONTEXT
    perfmonctl(int fd, PFM_UNLOAD_CONTEXT, NULL, 0);
    افصل السياق عن خيط.

PFM_RESTART
    perfmonctl(int fd, PFM_RESTART, NULL, 0);
    أعد تشغيل المراقبة بعد تلقي إشعار تجاوز.

PFM_GET_FEATURES
    perfmonctl(int fd, PFM_GET_FEATURES, pfarg_features_t *arg, 1);

PFM_DEBUG
    perfmonctl(int fd, PFM_DEBUG, val, 0);
    إذا كانت val غير صفرية، فعّل وضع التصحيح، وإلا فعطّله.

PFM_GET_PMC_RESET_VAL
    perfmonctl(int fd, PFM_GET_PMC_RESET_VAL, pfarg_reg_t *req, n);
    أعد ضبط سجلات PMC إلى القيم المبدئية.

قيمة الإرجاع
ترجع perfmonctl() صفرًا عند نجاح العملية. عند الخطأ، تُرجع -1 ويُضبط errno للإشارة إلى الخطأ.

المعايير
لينكس على IA-64.

التاريخ
لينكس 2.4. أُزيل في لينكس 5.10.

كانت استدعاء النظام هذا معطلاً لسنوات عديدة، وأُزيل نهائيًا في لينكس 5.10.

لا توفر glibc غلافًا لاستدعاء النظام هذا؛ على النوى التي يوجد فيها، استدعه باستخدام syscall(2).

انظر أيضًا
gprof(1)

مواصفات واجهة perfmon2

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.