getsockname(2)

الاسم
getsockname - الحصول على اسم المقبس

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

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

int getsockname(int sockfd, struct sockaddr *restrict addr,
                socklen_t *restrict addrlen);

الوصف
تُرجع الدالة getsockname() العنوان الحالي الذي يرتبط به المقبس sockfd، في المخزن المؤقت الذي يشير إليه addr. يجب تهيئة المتغير addrlen ليشير إلى حجم المساحة (بالبايت) التي يشير إليها addr. وعند العودة، يحتوي هذا المتغير على الحجم الفعلي لعنوان المقبس.

يُبتر العنوان المُعاد إذا كان المخزن المؤقت المقدم صغيرًا جدًا؛ وفي هذه الحالة، سيعيد addrlen قيمة أكبر مما تم تمريره للاستدعاء.

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

الأخطاء

EBADF
    المعامل sockfd ليس واصف ملف صالح.

EFAULT
    يُشير المعامل addr إلى ذاكرة ليست في جزء صالح من مساحة عناوين العملية.

EINVAL
    addrlen غير صالح (مثلاً، قيمته سالبة).

ENOBUFS
    الموارد المتوفرة في النظام غير كافية لإجراء العملية.

ENOTSOCK
    واصف الملف sockfd لا يشير إلى مقبس.

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

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

انظر أيضًا
bind(2), socket(2), getifaddrs(3), ip(7), socket(7), unix(7)

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

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

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