.\" -*- coding: UTF-8 -*-
.\" Copyright 2004, Andries E. Brouwer <aeb@cwi.nl>
.\" 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 set_tid_address 2 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
set_tid_address \- ضبط المؤشر لمعرف الخيط
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <sys/syscall.h>\fP      /* تعريف ثوابت \fBSYS_*\fP */
\fB#include <unistd.h>\fP
.P
\fBpid_t syscall(SYS_set_tid_address, int *\fP\fItidptr\fP\fB);\fP
.fi
.P
\fIملاحظة\fP: لا توفر glibc غلافًا لـ \fBset_tid_address\fP()، مما يستلزم استخدام
\fBsyscall\fP(2).
.SH الوصف
لكل خيط، يحافظ النواة على سمتين (عناوين) تُدعيان \fIset_child_tid\fP و
\fIclear_child_tid\fP. تحتوي هاتان السمتان على القيمة NULL مبدئيًا.
.TP 
\fIset_child_tid\fP
إذا بدأ خيط باستخدام \fBclone\fP(2) مع العلم \fBCLONE_CHILD_SETTID\fP، يُضبط
\fIset_child_tid\fP إلى القيمة الممررة في وسيط \fIctid\fP لتلك الاستدعاء النظامي.
.IP
عند ضبط \fIset_child_tid\fP، أول شيء يفعله الخيط الجديد هو كتابة معرف خيطه في
هذا العنوان.
.TP 
\fIclear_child_tid\fP
إذا بدأ خيط باستخدام \fBclone\fP(2) مع العلم \fBCLONE_CHILD_CLEARTID\fP، يُضبط
\fIclear_child_tid\fP إلى القيمة الممررة في وسيط \fIctid\fP لتلك الاستدعاء
النظامي.
.P
يضبط الاستدعاء النظامي \fBset_tid_address\fP() قيمة \fIclear_child_tid\fP للخيط
المستدعي إلى \fItidptr\fP.
.P
عندما ينتهي خيط لا تكون قيمة \fIclear_child_tid\fP فيه NULL، فإنه، إذا كان
الخيط يشارك الذاكرة مع خيوط أخرى، يُكتب 0 في العنوان المحدد في
\fIclear_child_tid\fP وتُنفذ النواة العملية التالية:
.P
.in +4n
.EX
futex(clear_child_tid, FUTEX_WAKE, 1, NULL, NULL, 0);
.EE
.in
.P
تأثير هذه العملية هو إيقاظ خيط واحد يُنفذ انتظار futex على موقع
الذاكرة. تُتجاهل الأخطاء من عملية إيقاظ futex.
.SH "قيمة الإرجاع"
تُرجع \fBset_tid_address\fP() دائمًا معرف خيط المستدعي.
.SH الأخطاء
تنجح \fBset_tid_address\fP() دائمًا.
.SH المعايير
لينكس.
.SH التاريخ
لينكس 2.5.48.
.P
التفاصيل المقدمة هنا صالحة منذ لينكس 2.5.49.
.SH "انظر أيضًا"
\fBclone\fP(2), \fBfutex\fP(2), \fBgettid\fP(2)
.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 .