.\" -*- coding: UTF-8 -*- .\" Copyright 1983-1991, The Regents of the University of California. .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: BSD-4-Clause-UC .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getsockname 2 "29 أكتوبر 2025" "صفحات دليل لينكس 6.18" .SH الاسم getsockname \- الحصول على اسم المقبس .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBint getsockname(int \fP\fIsockfd\fP\fB, struct sockaddr *restrict \fP\fIaddr\fP\fB,\fP \fB socklen_t *restrict \fP\fIaddrlen\fP\fB);\fP .fi .SH الوصف تُرجع الدالة \fBgetsockname\fP() العنوان الحالي الذي يرتبط به المقبس \fIsockfd\fP، في المخزن المؤقت الذي يشير إليه \fIaddr\fP. يجب تهيئة المتغير \fIaddrlen\fP ليشير إلى حجم المساحة (بالبايت) التي يشير إليها \fIaddr\fP. وعند العودة، يحتوي هذا المتغير على الحجم الفعلي لعنوان المقبس. .P يُبتر العنوان المُعاد إذا كان المخزن المؤقت المقدم صغيرًا جدًا؛ وفي هذه الحالة، سيعيد \fIaddrlen\fP قيمة أكبر مما تم تمريره للاستدعاء. .SH "قيمة الإرجاع" عند النجاح، يُعاد الصفر. وعند حدوث خطأ، يُعاد الرقم \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء .TP \fBEBADF\fP المعامل \fIsockfd\fP ليس واصف ملف صالح. .TP \fBEFAULT\fP يُشير المعامل \fIaddr\fP إلى ذاكرة ليست في جزء صالح من مساحة عناوين العملية. .TP \fBEINVAL\fP \fIaddrlen\fP غير صالح (مثلاً، قيمته سالبة). .TP \fBENOBUFS\fP الموارد المتوفرة في النظام غير كافية لإجراء العملية. .TP \fBENOTSOCK\fP واصف الملف \fIsockfd\fP لا يشير إلى مقبس. .SH المعايير POSIX.1\-2024. .SH التاريخ .\" SVr4 documents additional ENOMEM .\" and ENOSR error codes. POSIX.1\-2001،‏ SVr4،‏ 4.2BSD. .SH "انظر أيضًا" \fBbind\fP(2), \fBsocket\fP(2), \fBgetifaddrs\fP(3), \fBip\fP(7), \fBsocket\fP(7), \fBunix\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 .