pthread_attr_setaffinity_np(3)

الاسم
pthread_attr_setaffinity_np, pthread_attr_getaffinity_np - تعيين/الحصول على سمة التقارب لوحدة المعالجة المركزية في كائن سمات الخيط

المكتبة
مكتبة مسالك POSIX (libpthread، -lpthread)

موجز
#define _GNU_SOURCE             /* انظر feature_test_macros(7) */
#include <pthread.h>

int pthread_attr_setaffinity_np(pthread_attr_t *attr,
                   size_t cpusetsize, const cpu_set_t *cpuset);
int pthread_attr_getaffinity_np(const pthread_attr_t *attr,
                   size_t cpusetsize, cpu_set_t *cpuset);

الوصف
تضبط الدالة pthread_attr_setaffinity_np() سمة قناع التقارب لوحدة المعالجة المركزية لكائن سمات الخيط المشار إليه بواسطة attr إلى القيمة المحددة في cpuset. تحدد هذه السمة قناع التقارب لوحدة المعالجة المركزية لخيط يُنشأ باستخدام كائن سمات الخيط attr.

تُرجع الدالة pthread_attr_getaffinity_np() سمة قناع التقارب لوحدة المعالجة المركزية لكائن سمات الخيط المشار إليه بواسطة attr في المخزن المؤقت المشار إليه بواسطة cpuset.

المعامل cpusetsize هو طول (بالبايت) المخزن المؤقت المشار إليه بواسطة cpuset. عادةً، يُحدد هذا المعامل كـ sizeof(cpu_set_t).

لمزيد من التفاصيل حول أقنعة تقارب المعالج (CPU affinity masks)، راجع sched_setaffinity(2). لوصف لمجموعة من الماكرو التي يمكن استخدامها لمعالجة وفحص مجموعات المعالجات، راجع CPU_SET(3).

قيمة الإرجاع
عند النجاح، تُعيد هذه الدوال القيمة 0؛ وعند الخطأ، تُعيد رقم خطأ غير صفري.

الأخطاء

EINVAL
    (pthread_attr_setaffinity_np()) حدد cpuset وحدة معالجة مركزية خارج المجموعة المدعومة من النواة. (يُعرّف خيار تهيئة النواة CONFIG_NR_CPUS نطاق المجموعة المدعومة من نوع بيانات النواة المستخدم لتمثيل مجموعات وحدات المعالجة المركزية.)

EINVAL
    (pthread_attr_getaffinity_np()) تقع وحدة معالجة مركزية في قناع التقارب لكائن سمات الخيط المشار إليه بواسطة attr خارج النطاق المحدد بواسطة cpusetsize (أي، cpuset/cpusetsize صغير جدًا).

ENOMEM
    (pthread_attr_setaffinity_np()) تعذر تخصيص الذاكرة.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
pthread_attr_setaffinity_np(), pthread_attr_getaffinity_np() | سلامة الخيوط | MT-Safe

المعايير
جنو؛ ومن هنا جاءت اللاحقة "_np" (غير منقول) في الأسماء.

التاريخ
glibc 2.3.4.

ملاحظات
في إصدار glibc 2.3.3 فقط، توفرت نسخ من هذه الدوال لم تكن تحتوي على معطى cpusetsize. بدلاً من ذلك، كان حجم مجموعة وحدة المعالجة المركزية المعطى لنداءات النظام الأساسية هو دائماً sizeof(cpu_set_t).

انظر أيضًا
sched_setaffinity(2), pthread_attr_init(3), pthread_setaffinity_np(3), cpuset(7), pthreads(7)

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

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

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