.\" -*- coding: UTF-8 -*- .\" Copyright 2002-2011, Michael Kerrisk .\" 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 rt_sigqueueinfo 2 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم rt_sigqueueinfo, rt_tgsigqueueinfo \- إيداع إشارة وبيانات .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP /* تعريف ثوابت \fBSI_*\fP */ \fB#include \fP /* تعريف ثوابت \fBSYS_*\fP */ \fB#include \fP .P \fBint syscall(SYS_rt_sigqueueinfo, pid_t \fP\fItgid\fP\fB,\fP \fB int \fP\fIsig\fP\fB, siginfo_t *\fP\fIinfo\fP\fB);\fP \fBint syscall(SYS_rt_tgsigqueueinfo, pid_t \fP\fItgid\fP\fB, pid_t \fP\fItid\fP\fB,\fP \fB int \fP\fIsig\fP\fB, siginfo_t *\fP\fIinfo\fP\fB);\fP .fi .P \fIملاحظة\fP: لا توجد أغلفة glibc لاستدعاءات النظام هذه؛ انظر الملاحظات. .SH الوصف استدعاءات النظام \fBrt_sigqueueinfo\fP() و\fBrt_tgsigqueueinfo\fP() هي الواجهات منخفضة المستوى المستخدمة لإرسال إشارة بالإضافة إلى بيانات إلى عملية أو خيط. يمكن لمستقبل الإشارة الحصول على البيانات المصاحبة بإنشاء معالج إشارة مع علامة \fBSA_SIGINFO\fP في \fBsigaction\fP(2). .P استدعاءات النظام هذه ليست مخصصة للاستخدام المباشر من التطبيقات؛ إنها متاحة للسماح بتنفيذ \fBsigqueue\fP(3) و\fBpthread_sigqueue\fP(3). .P يرسل استدعاء النظام \fBrt_sigqueueinfo\fP() الإشارة \fIsig\fP إلى مجموعة الخيوط ذات المعرف \fItgid\fP. (مصطلح "مجموعة خيوط" مرادف لـ "عملية"، و\fItgid\fP يتوافق مع معرف عملية UNIX التقليدي.) سيتم تسليم الإشارة إلى عضو عشوائي من مجموعة الخيوط (أي أحد الخيوط الذي لا يحجب الإشارة حاليًا). .P تحدد الوسيطة \fIinfo\fP البيانات المصاحبة للإشارة. هذه الوسيطة هي مؤشر لبنية من النوع \fIsiginfo_t\fP، الموصوفة في \fBsigaction\fP(2) (والمعرفة بتضمين \fI\fP). يجب على المستدعي تعيين الحقول التالية في هذه البنية: .TP \fIsi_code\fP يجب أن يكون هذا أحد أكواد \fBSI_*\fP في ملف مصدر نواة لينكس \fIinclude/asm\-generic/siginfo.h\fP. إذا تم إرسال الإشارة إلى أي عملية غير المستدعي نفسه، تنطبق القيود التالية: .RS .IP \[bu] 3 لا يمكن أن يكون الكود قيمة أكبر من أو تساوي الصفر. على وجه الخصوص، لا يمكن أن يكون \fBSI_USER\fP، الذي تستخدمه النواة للإشارة إلى إشارة أرسلها \fBkill\fP(2)، ولا يمكن أن يكون \fBSI_KERNEL\fP، الذي يستخدم للإشارة إلى إشارة مولدة من النواة. .IP \[bu] .\" tkill(2) or لا يمكن أن يكون الكود (منذ لينكس 2.6.39) \fBSI_TKILL\fP، الذي تستخدمه النواة للإشارة إلى إشارة أرسلت باستخدام \fBtgkill\fP(2). .RE .TP \fIsi_pid\fP يجب تعيين هذا إلى معرف عملية، عادةً معرف عملية المرسل. .TP \fIsi_uid\fP يجب تعيين هذا إلى معرف مستخدم، عادةً معرف المستخدم الحقيقي للمرسل. .TP \fIsi_value\fP يحتوي هذا الحقل على بيانات المستخدم المصاحبة للإشارة. لمزيد من المعلومات، انظر وصف الوسيطة الأخيرة (\fIunion sigval\fP) لـ \fBsigqueue\fP(3). .P داخليًا، تعين النواة الحقل \fIsi_signo\fP إلى القيمة المحددة في \fIsig\fP، بحيث يمكن لمستقبل الإشارة أيضًا الحصول على رقم الإشارة عبر هذا الحقل. .P استدعاء النظام \fBrt_tgsigqueueinfo\fP() يشبه \fBrt_sigqueueinfo\fP()، لكنه يرسل الإشارة والبيانات إلى الخيط الفردي المحدد بمزيج من \fItgid\fP، معرف مجموعة خيوط، و\fItid\fP، خيط في تلك المجموعة. .SH "قيمة الإرجاع" عند النجاح، تعيد استدعاءات النظام هذه 0. عند الخطأ، تعيد \-1 ويتم تعيين \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء .TP \fBEAGAIN\fP تم الوصول إلى حد الإشارات التي يمكن إيداعها. (انظر \fBsignal\fP(7) لمزيد من المعلومات.) .TP \fBEINVAL\fP \fIsig\fP أو \fItgid\fP أو \fItid\fP غير صالح. .TP \fBEPERM\fP ليس لدى المستدعي صلاحية إرسال الإشارة إلى الهدف. للصلاحيات المطلوبة، انظر \fBkill\fP(2). .TP \fBEPERM\fP يحدد \fItgid\fP عملية غير المستدعي و\fIinfo\->si_code\fP غير صالح. .TP \fBESRCH\fP \fBrt_sigqueueinfo\fP(): لم يتم العثور على مجموعة خيوط تطابق \fItgid\fP. .P \fBrt_tgsigqueinfo\fP(): لم يتم العثور على خيط يطابق \fItgid\fP و\fItid\fP. .SH المعايير لينكس. .SH التاريخ .TP \fBrt_sigqueueinfo\fP() لينكس 2.2. .TP \fBrt_tgsigqueueinfo\fP() لينكس 2.6.31. .SH ملاحظات نظرًا لأن استدعاءات النظام هذه ليست مخصصة للاستخدام من التطبيقات، فلا توجد دوال تغليف glibc؛ استخدم \fBsyscall\fP(2) في الحالة غير المحتملة التي تريد فيها استدعاءها مباشرة. .P كما هو الحال مع \fBkill\fP(2)، يمكن استخدام الإشارة الصفرية (0) للتحقق مما إذا كانت العملية أو الخيط المحدد موجودًا. .SH "انظر أيضًا" \fBkill\fP(2)، \fBpidfd_send_signal\fP(2)، \fBsigaction\fP(2)، \fBsigprocmask\fP(2)، \fBtgkill\fP(2)، \fBpthread_sigqueue\fP(3)، \fBsigqueue\fP(3)، \fBsignal\fP(7) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .