.\" -*- 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 getpeername 2 "29 أكتوبر 2025" "صفحات دليل لينكس 6.18" .SH الاسم getpeername \- الحصول على اسم المقبس النظير المتصل .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBint getpeername(int \fP\fIsockfd\fP\fB, struct sockaddr *restrict \fP\fIaddr\fP\fB,\fP \fB socklen_t *restrict \fP\fIaddrlen\fP\fB);\fP .fi .SH الوصف ترجع \fBgetpeername\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 \fBENOTCONN\fP المقبس غير متصل. .TP \fBENOTSOCK\fP واصف الملف \fIsockfd\fP لا يشير إلى مقبس. .SH المعايير POSIX.1\-2024. .SH التاريخ POSIX.1\-2001, SVr4, 4.4BSD (ظهر أول مرة في 4.2BSD). .SH ملاحظات بالنسبة لمقابس التدفق، بمجرد تنفيذ \fBconnect\fP(2)، يمكن لأي من المقبسين استدعاء \fBgetpeername\fP() للحصول على عنوان مقبس النظير. من ناحية أخرى، مقابس البيانات (datagram) هي بدون اتصال. استدعاء \fBconnect\fP(2) على مقبس بيانات يضبط فقط عنوان النظير للبيانات الصادرة المُرسلة مع \fBwrite\fP(2) أو \fBrecv\fP(2). يمكن لمستدعي \fBconnect\fP(2) استخدام \fBgetpeername\fP() للحصول على عنوان النظير الذي عيّنه سابقًا للمقبس. ومع ذلك، فإن مقبس النظير غير مُطّلع على هذه المعلومات، ولن يُرجع استدعاء \fBgetpeername\fP() على مقبس النظير أي معلومات مفيدة (إلا إذا تم أيضًا تنفيذ استدعاء \fBconnect\fP(2) على النظير). لاحظ أيضًا أن مستقبل البيانات يمكنه الحصول على عنوان المُرسل عند استخدام \fBrecvfrom\fP(2). .SH "انظر أيضًا" \fBaccept\fP(2), \fBbind\fP(2), \fBgetsockname\fP(2), \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 .