.\" -*- coding: UTF-8 -*-
'\" t
.\" 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 pthread_attr_setscope 3 "17 مايو 2025" "صفحات دليل لينكس 6.18" 
.SH الاسم
pthread_attr_setscope, pthread_attr_getscope \- تعيين/الحصول على سمة نطاق
التنافس في كائن سمات الخيط
.SH المكتبة
مكتبة مسالك POSIX (\fIlibpthread\fP،\ \fI\-lpthread\fP)
.SH موجز
.nf
\fB#include <pthread.h>\fP
.P
\fBint pthread_attr_setscope(pthread_attr_t *\fP\fIattr\fP\fB, int \fP\fIscope\fP\fB);\fP
\fBint pthread_attr_getscope(const pthread_attr_t *restrict \fP\fIattr\fP\fB,\fP
\fB                          int *restrict \fP\fIscope\fP\fB);\fP
.fi
.SH الوصف
تضبط الدالة \fBpthread_attr_setscope\fP() سمة نطاق التنافس لكائن سمات الخيط
المشار إليه بواسطة \fIattr\fP إلى القيمة المحددة في \fIscope\fP. تُعرّف سمة نطاق
التنافس مجموعة الخيوط التي يتنافس ضدها خيط للحصول على موارد مثل وحدة
المعالجة المركزية. يحدد POSIX.1 قيمتين محتملتين لـ \fIscope\fP:
.TP 
\fBPTHREAD_SCOPE_SYSTEM\fP
يتنافس الخيط على الموارد مع جميع الخيوط الأخرى في جميع العمليات على النظام
الموجودة في نفس نطاق تخصيص الجدولة (مجموعة من معالج واحد أو أكثر). تُجدول
خيوط \fBPTHREAD_SCOPE_SYSTEM\fP بالنسبة لبعضها البعض وفقًا لسياسة الجدولة
والأولوية الخاصة بها.
.TP 
\fBPTHREAD_SCOPE_PROCESS\fP
يتنافس الخيط على الموارد مع جميع الخيوط الأخرى في نفس العملية التي أُنشئت
أيضًا بنطاق تنافس \fBPTHREAD_SCOPE_PROCESS\fP. تُجدول خيوط
\fBPTHREAD_SCOPE_PROCESS\fP بالنسبة للخيوط الأخرى في العملية وفقًا لسياسة
الجدولة والأولوية الخاصة بها. يترك POSIX.1 غير محدد كيفية تنافس هذه الخيوط
مع الخيوط الأخرى في عمليات أخرى على النظام أو مع خيوط أخرى في نفس العملية
أُنشئت بنطاق تنافس \fBPTHREAD_SCOPE_SYSTEM\fP.
.P
يتطلب POSIX.1 أن يدعم التنفيذ واحدًا على الأقل من نطاقات التنافس هذه. يدعم
لينكس \fBPTHREAD_SCOPE_SYSTEM\fP، لكنه لا يدعم \fBPTHREAD_SCOPE_PROCESS\fP.
.P
على الأنظمة التي تدعم نطاقات تنافس متعددة، ولكي يكون لإعداد المعامل الذي
تجريه \fBpthread_attr_setscope\fP() تأثير عند استدعاء \fBpthread_create\fP(3)، يجب
على المستدعي استخدام \fBpthread_attr_setinheritsched\fP(3) لتعيين سمة وراثة
الجدولة لكائن السمات \fIattr\fP إلى \fBPTHREAD_EXPLICIT_SCHED\fP.
.P
تُرجع الدالة \fBpthread_attr_getscope\fP() سمة نطاق التنافس لكائن سمات الخيط
المشار إليه بواسطة \fIattr\fP في المخزن المؤقت المشار إليه بواسطة \fIscope\fP.
.SH "قيمة الإرجاع"
عند النجاح، تُعيد هذه الدوال القيمة 0؛ وعند الخطأ، تُعيد رقم خطأ غير صفري.
.SH الأخطاء
قد تفشل \fBpthread_attr_setscope\fP() مع الأخطاء التالية:
.TP 
\fBEINVAL\fP
حُددت قيمة غير صالحة في \fIscope\fP.
.TP 
\fBENOTSUP\fP
حدد \fIscope\fP القيمة \fBPTHREAD_SCOPE_PROCESS\fP، وهي غير مدعومة على لينكس.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBpthread_attr_setscope\fP(),
\fBpthread_attr_getscope\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
POSIX.1\-2008.
.SH التاريخ
POSIX.1\-2001.
.SH ملاحظات
يشير نطاق التنافس \fBPTHREAD_SCOPE_SYSTEM\fP عادةً إلى أن خيط مساحة المستخدم
مرتبط مباشرة بكيان جدولة نواة واحد. هذا هو الحال على لينكس لتنفيذ
LinuxThreads القديم وتنفيذ NPTL الحديث، وكلاهما تنفيذان للخيوط بنسبة 1:1.
.P
يحدد POSIX.1 أن نطاق التنافس المبدئي مُعرّف بواسطة التنفيذ.
.SH "انظر أيضًا"
.ad l
.nh
\fBpthread_attr_init\fP(3), \fBpthread_attr_setaffinity_np\fP(3),
\fBpthread_attr_setinheritsched\fP(3), \fBpthread_attr_setschedparam\fP(3),
\fBpthread_attr_setschedpolicy\fP(3), \fBpthread_create\fP(3), \fBpthreads\fP(7)
.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 .