Scroll to navigation

socketpair(2) System Calls Manual 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.

الأخطاء

عائلة العناوين المحددة غير مدعومة على هذا الجهاز.
العنوان sv لا يحدد جزءًا صالحًا من مساحة عنوان العملية.
وُصل إلى الحد الأقصى لواصفات الملفات المفتوحة لكل عملية.
وُصل إلى الحد الأقصى لإجمالي عدد الملفات المفتوحة على مستوى النظام.
البروتوكول المحدد لا يدعم إنشاء أزواج المقابس.
البروتوكول المحدد غير مدعوم على هذا الجهاز.

الإصدارات

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

المعايير

POSIX.1-2024.

التاريخ

POSIX.1-2001،‏ 4.2BSD.

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

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 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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

29 أكتوبر 2025 صفحات دليل لينكس 6.18