.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 2002, 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 sigqueue 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم sigqueue \- إيداع إشارة وبيانات إلى عملية .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBint sigqueue(pid_t \fP\fIpid\fP\fB, int \fP\fIsig\fP\fB, const union sigval \fP\fIvalue\fP\fB);\fP .fi .P .RS -4 متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)): .RE .P \fBsigqueue\fP(): .nf _POSIX_C_SOURCE >= 199309L .fi .SH الوصف ترسل الدالة \fBsigqueue\fP() الإشارة المحددة في \fIsig\fP إلى العملية التي يُعطى معرفها (PID) في \fIpid\fP. الأذونات المطلوبة لإرسال إشارة هي نفسها للدالة \fBkill\fP(2). كما هو الحال مع \fBkill\fP(2)، يمكن استخدام الإشارة الصفرية (0) للتحقق من وجود عملية بمعرف PID معين. .P يُستخدم المعامل \fIvalue\fP لتحديد عنصر بيانات مصاحب (إما عدد صحيح أو قيمة مؤشر) ليُرسل مع الإشارة، وله النوع التالي: .P .in +4n .EX union sigval { int sival_int; void *sival_ptr; }; .EE .in .P إذا كانت العملية المستقبلة قد ثبتت معالجًا لهذه الإشارة باستخدام العلم \fBSA_SIGINFO\fP للدالة \fBsigaction\fP(2)، فيمكنها الحصول على هذه البيانات عبر حقل \fIsi_value\fP من بنية \fIsiginfo_t\fP الممررة كوسيط ثانٍ للمعالج. علاوة على ذلك، سيُضبط حقل \fIsi_code\fP لتلك البنية على \fBSI_QUEUE\fP. .SH "قيمة الإرجاع" عند النجاح، تُرجع \fBsigqueue\fP() 0، مما يشير إلى أن الإشارة أُودعت بنجاح في العملية المستقبلة. وإلا، تُرجع \-1 ويُضبط \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء .TP \fBEAGAIN\fP وُصل إلى الحد الأقصى للإشارات التي يمكن وضعها في قائمة الانتظار. (انظر \fBsignal\fP(7) لمزيد من المعلومات.) .TP \fBEINVAL\fP كان \fIsig\fP غير صالح. .TP \fBEPERM\fP لا تملك العملية الإذن لإرسال الإشارة إلى العملية المستقبلة. للأذونات المطلوبة، انظر \fBkill\fP(2). .TP \fBESRCH\fP لا توجد عملية بمعرف PID يطابق \fIpid\fP. .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBsigqueue\fP() T} سلامة الخيوط MT\-Safe .TE .SH الإصدارات .SS "الاختلافات بين مكتبة C والنواة" في لينكس، تُنفذ \fBsigqueue\fP() باستخدام استدعاء النظام \fBrt_sigqueueinfo\fP(2). يختلف استدعاء النظام في وسيطه الثالث، وهو بنية \fIsiginfo_t\fP التي ستُزود لمعالج الإشارة للعملية المستقبلة أو تُرجع بواسطة استدعاء \fBsigtimedwait\fP(2) للعملية المستقبلة. داخل غلاف glibc للدالة \fBsigqueue\fP()، يُهيأ هذا الوسيط، \fIuinfo\fP، كالتالي: .P .in +4n .EX uinfo.si_signo = sig; /* الوسيط المُمرَّر إلى sigqueue() */ uinfo.si_code = SI_QUEUE; uinfo.si_pid = getpid(); /* مُعرِّف عملية المُرسِل */ uinfo.si_uid = getuid(); /* المعرّف الفريد الحقيقي للمُرسِل */ uinfo.si_value = val; /* الوسيط المُمرَّر إلى sigqueue() */ .EE .in .SH المعايير POSIX.1\-2008. .SH التاريخ لينكس 2.2. POSIX.1\-2001. .SH ملاحظات إذا أدت هذه الدالة إلى إرسال إشارة إلى العملية التي استدعتها، ولم تكن تلك الإشارة محجوبة بواسطة الخيط المستدعي، ولم تكن هناك خيوط أخرى راغبة في معالجة هذه الإشارة (إما بإلغاء حجبها، أو بانتظارها باستخدام \fBsigwait\fP(3))، فيجب عندئذٍ تسليم إشارة واحدة على الأقل إلى هذا الخيط قبل أن تعود هذه الدالة. .SH "انظر أيضًا" \fBkill\fP(2), \fBrt_sigqueueinfo\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2), \fBpthread_sigqueue\fP(3), \fBsigwait\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 .