tkill(2)

الاسم
tkill, tgkill - إرسال إشارة إلى خيط

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

موجز
#include <signal.h>           /* Definition of SIG* constants */
#include <sys/syscall.h>      /* Definition of SYS_* constants */
#include <unistd.h>

[[deprecated]] int syscall(SYS_tkill, pid_t tid, int sig);

#include <signal.h>

int tgkill(pid_t tgid, pid_t tid, int sig);

ملاحظة: لا توفر glibc غلافًا لـ tkill()، مما يستلزم استخدام syscall(2).

الوصف
ترسل tgkill() الإشارة sig إلى الخيط ذي معرف الخيط tid في مجموعة الخيوط tgid. (على النقيض، يمكن استخدام kill(2) لإرسال إشارة فقط إلى عملية (أي مجموعة خيوط) ككل، وسيتم تسليم الإشارة إلى خيط عشوائي داخل تلك العملية.)

tkill() هو سلف مهمل لـ tgkill(). يسمح فقط بتحديد معرف الخيط الهدف، مما قد يؤدي إلى إرسال الإشارة إلى الخيط الخطأ إذا أنهى خيط عمله وأُعيد استخدام معرف خيطه. تجنب استخدام استدعاء النظام هذا.

هذه هي واجهات استدعاء النظام الخام، المخصصة للاستخدام الداخلي لمكتبة الخيوط.

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

الأخطاء

EAGAIN
    تم الوصول إلى حد المورد RLIMIT_SIGPENDING و sig هي إشارة زمن حقيقي.

EAGAIN
    ذاكرة نواة غير كافية كانت متاحة و sig هي إشارة زمن حقيقي.

EINVAL
    تم تحديد معرف خيط أو معرف مجموعة خيوط أو إشارة غير صالحة.

EPERM
    تم رفض الإذن. للأذونات المطلوبة، انظر kill(2).

ESRCH
    لا توجد عملية بمعرف الخيط المحدد (ومعرف مجموعة الخيوط).

المعايير
لينكس.

التاريخ

tkill()
    لينكس 2.4.19 / 2.5.4.

tgkill()
    لينكس 2.5.75، glibc 2.30.

ملاحظات
انظر وصف CLONE_THREAD في clone(2) لشرح مجموعات الخيوط.

انظر أيضًا
clone(2), gettid(2), kill(2), rt_sigqueueinfo(2)

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

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

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