socketpair(2)

الاسم
socketpair - إنشاء زوج من المقابس المتصلة

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

موجز
#include <sys/socket.h>

int socketpair(int domain, int type, int protocol, int sv[2]);

الوصف
استدعاء socketpair() ينشئ زوجًا غير مسمى من المقابس المتصلة في domain المحدد، من النوع type المحدد، وباستخدام protocol المحدد اختياريًا. لمزيد من التفاصيل حول هذه الوسائط، انظر socket(2).

يتم إرجاع واصفات الملفات المستخدمة في الإشارة إلى المقابس الجديدة في sv[0] و sv[1]. المقبسان غير قابلين للتمييز.

قيمة الإرجاع
عند النجاح، يتم إرجاع صفر. عند الخطأ، يتم إرجاع -1، ويتم تعيين errno للإشارة إلى الخطأ، ويُترك sv دون تغيير

في لينكس (وأنظمة أخرى)، لا يعدل socketpair() sv عند الفشل. تمت إضافة متطلب لتوحيد هذا السلوك في POSIX.1-2008 TC2.

الأخطاء

EAFNOSUPPORT
    عائلة العناوين المحددة غير مدعومة على هذا الجهاز.

EFAULT
    العنوان sv لا يحدد جزءًا صالحًا من مساحة عنوان العملية.

EMFILE
    وُصل إلى الحد الأقصى لواصفات الملفات المفتوحة لكل عملية.

ENFILE
    وُصل إلى الحد الأقصى لإجمالي عدد الملفات المفتوحة على مستوى النظام.

EOPNOTSUPP
    البروتوكول المحدد لا يدعم إنشاء أزواج المقابس.

EPROTONOSUPPORT
    البروتوكول المحدد غير مدعوم على هذا الجهاز.

الإصدارات
في لينكس، المجالات الوحيدة المدعومة لهذا الاستدعاء هي AF_UNIX (أو بشكل مترادف، AF_LOCAL) و AF_TIPC (منذ لينكس 4.12).

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

التاريخ
POSIX.1-2001،‏ 4.2BSD.

إنه قابل للنقل عموماً من/إلى الأنظمة غير التابعة لـ BSD التي تدعم نسخاً من طبقة مقابس BSD (بما في ذلك متغيرات System V).

SOCK_CLOEXEC
SOCK_NONBLOCK
    POSIX.1-2024; لينكس 2.6.27. (انظر socket(2).)

انظر أيضًا
pipe(2), read(2), socket(2), write(2), socket(7), unix(7)

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

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

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