الاسم¶

getcpu - تحديد وحدة المعالجة المركزية وعقدة NUMA التي يعمل عليها الخيط المستدعي

المكتبة¶

مكتبة سي المعيارية (libc، -lc)

موجز¶

#define _GNU_SOURCE             /* انظر feature_test_macros(7) */
#include <sched.h>

int getcpu(unsigned int *_Nullable cpu, unsigned int *_Nullable node);

الوصف¶

استدعاء النظام getcpu() يحدد المعالج والعقدة التي يعمل عليها الخيط أو العملية المستدعية حاليًا ويكتبهما في الأعداد الصحيحة المشار إليها بواسطة الوسيطتين cpu و node. المعالج هو عدد صحيح صغير فريد يعرّف وحدة المعالجة المركزية. العقدة هي معرّف صغير فريد يعرّف عقدة NUMA. عندما تكون أي من cpu أو node NULL، لا يُكتب شيء إلى المؤشر المعني.

المعلومات الموضوعة في cpu مضمونة لتكون حديثة فقط في وقت الاستدعاء: ما لم يتم تثبيت تقارب وحدة المعالجة المركزية باستخدام sched_setaffinity(2)، قد يغير النواة وحدة المعالجة المركزية في أي وقت. (عادةً لا يحدث هذا لأن المجدول يحاول تقليل الحركات بين وحدات المعالجة المركزية للحفاظ على الخبيئات ساخنة، لكنه ممكن.) يجب على المستدعي السماح بإمكانية أن المعلومات المعادة في cpu و node لم تعد حديثة بحلول وقت عودة الاستدعاء.

قيمة الإرجاع¶

عند النجاح، يُعاد الرقم 0. وعند حدوث خطأ، يُعاد الرقم -1، ويُضبط errno للإشارة إلى الخطأ.

الأخطاء¶

EFAULT

الوسائط تشير إلى خارج مساحة عنوان العملية المستدعية.

المعايير¶

لينكس.

التاريخ¶

لينكس 2.6.19 (x86-64 و i386)، glibc 2.29.

int getcpu(unsigned int *cpu, unsigned int *node,
           struct getcpu_cache *tcache);

ملاحظات¶

يبذل لينكس أقصى جهد لجعل هذا الاستدعاء بأسرع ما يمكن. (على بعض البنيات، يتم ذلك عبر تنفيذ في vdso(7).) القصد من getcpu() هو السماح للبرامج بإجراء تحسينات باستخدام بيانات لكل وحدة معالجة مركزية أو لتحسين NUMA.

انظر أيضًا¶

mbind(2), sched_setaffinity(2), set_mempolicy(2), sched_getcpu(3), cpuset(7), vdso(7)

ترجمة¶

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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