killpg(3)

الاسم
killpg - إرسال إشارة إلى مجموعة عمليات

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

موجز
#include <signal.h>

int killpg(int pgrp, int sig);

    متطلبات ماكروات اختبار الميزات لـ glibc (انظر feature_test_macros(7)):

killpg():
    _XOPEN_SOURCE >= 500
        || /* منذ glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE

الوصف
ترسل killpg() الإشارة sig إلى مجموعة العمليات pgrp. انظر signal(7) لقائمة الإشارات.

إذا كان pgrp يساوي 0، ترسل killpg() الإشارة إلى مجموعة عمليات العملية المستدعية. (يقول POSIX: إذا كان pgrp أقل من أو يساوي 1، فالسلوك غير محدد.)

للأذونات المطلوبة لإرسال إشارة إلى عملية أخرى، انظر kill(2).

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

الأخطاء

EINVAL
    sig ليس رقم إشارة صالحًا.

EPERM
    لا تملك العملية الإذن لإرسال الإشارة إلى أي من العمليات المستهدفة. للأذونات المطلوبة، انظر kill(2).

ESRCH
    لا يمكن العثور على أي عملية في مجموعة العمليات المحددة بواسطة pgrp.

ESRCH
    أُعطيت مجموعة العمليات كـ 0 ولكن العملية المرسلة لا تملك مجموعة عمليات.

الإصدارات
توجد اختلافات متنوعة بين فحص الأذونات في أنظمة من نوع BSD وأنظمة من نوع System V. انظر الأساس المنطقي لـ POSIX لـ kill(3p). اختلاف لم يذكره POSIX يتعلق بقيمة الإرجاع EPERM: يوثق BSD أنه لا تُرسل إشارة ويُعاد EPERM عندما فشل فحص الإذن لعملية مستهدفة واحدة على الأقل، بينما يوثق POSIX EPERM فقط عندما فشل فحص الإذن لجميع العمليات المستهدفة.

  الاختلافات بين مكتبة C والنواة
على Linux، تُنفذ killpg() كدالة مكتبة تقوم باستدعاء kill(-pgrp, sig).

المعايير
POSIX.1-2008.

التاريخ
POSIX.1-2001, SVr4, 4.4BSD (ظهرت أولاً في 4BSD).

انظر أيضًا
getpgrp(2), kill(2), signal(2), capabilities(7), credentials(7)

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

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

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