.\" -*- coding: UTF-8 -*- .\" Copyright 1983-1991, The Regents of the University of California. .\" Copyright 2007, Michael Kerrisk .\" 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 listen 2 "11 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم listen \- الاستماع للاتصالات على مقبس .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBint listen(int \fP\fIsockfd\fP\fB, int \fP\fIbacklog\fP\fB);\fP .fi .SH الوصف \fBlisten\fP() يعلّم المقبس المشار إليه بـ \fIsockfd\fP كمقبس سلبي، أي كمقبس سيُستخدم لقبول طلبات الاتصال الواردة باستخدام \fBaccept\fP(2). .P الوسيط \fIsockfd\fP هو واصف ملف يشير إلى مقبس من النوع \fBSOCK_STREAM\fP أو \fBSOCK_SEQPACKET\fP. .P الوسيط \fIbacklog\fP يُعرّف الطول الأقصى الذي قد يصل إليه طابور الاتصالات المعلقة لـ \fIsockfd\fP. إذا وصل طلب اتصال عندما يكون الطابور ممتلئًا، فقد يتلقى العميل خطأً مع إشارة \fBECONNREFUSED\fP، أو إذا كان البروتوكول الأساسي يدعم إعادة الإرسال، فقد يُتجاهل الطلب بحيث تنجح محاولة اتصال لاحقة. .SH "قيمة الإرجاع" عند النجاح، يُعاد الصفر. وعند حدوث خطأ، يُعاد الرقم \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء .TP \fBEADDRINUSE\fP مقبس آخر يستمع بالفعل على نفس المنفذ. .TP \fBEADDRINUSE\fP (مقابس نطاق الإنترنت) لم يسبق ربط المقبس المشار إليه بـ \fIsockfd\fP بعنوان، وعند محاولة ربطه بمنفذ مؤقت (ephemeral)، تبيّن أن جميع أرقام المنافذ في نطاق المنافذ المؤقتة قيد الاستخدام حالياً. راجع النقاش حول \fI/proc/sys/net/ipv4/ip_local_port_range\fP في \fBip\fP(7). .TP \fBEBADF\fP المعامل \fIsockfd\fP ليس واصف ملف صالح. .TP \fBENOTSOCK\fP واصف الملف \fIsockfd\fP لا يشير إلى مقبس. .TP \fBEOPNOTSUPP\fP المقبس ليس من نوع يدعم عملية \fBlisten\fP(). .SH المعايير POSIX.1\-2024. .SH التاريخ 4.2BSD, POSIX.1\-2001. .SH ملاحظات لقبول الاتصالات، تُنفّذ الخطوات التالية: .RS 4 .IP (1) 5 يُنشأ مقبس باستخدام \fBsocket\fP(2). .IP (2) يُربط المقبس بعنوان محلي باستخدام \fBbind\fP(2)، بحيث يمكن للمقابس الأخرى أن تتصل به باستخدام \fBconnect\fP(2). .IP (3) يُحدد الاستعداد لقبول الاتصالات الواردة وحد الطابور للاتصالات الواردة باستخدام \fBlisten\fP(). .IP (4) تُقبل الاتصالات باستخدام \fBaccept\fP(2). .RE .P تغير سلوك الوسيط \fIbacklog\fP على مقابس TCP مع Linux 2.2. الآن يُحدد طول الطابور للمقابس \fIالمؤسسة بالكامل\fP المنتظرة للقبول، بدلاً من عدد طلبات الاتصال غير المكتملة. يمكن ضبط الطول الأقصى للطابور للمقابس غير المكتملة باستخدام \fI/proc/sys/net/ipv4/tcp_max_syn_backlog\fP. عند تمكين ملفات تعريف الارتباط المتزامنة، لا يوجد حد أقصى منطقي ويُتجاهل هذا الإعداد. انظر \fBtcp\fP(7) لمزيد من المعلومات. .P .\" The following is now rather historic information (MTK, Jun 05) .\" Don't rely on this value in portable applications since BSD .\" (and some BSD-derived systems) limit the backlog to 5. إذا كان الوسيط \fIbacklog\fP أكبر من القيمة في \fI/proc/sys/net/core/somaxconn\fP، فسيُحدد إلى تلك القيمة بصمت. منذ Linux 5.4، المبدئي في هذا الملف هو 4096؛ في النوى الأقدم، القيمة المبدئية هي 128. قبل Linux 2.4.25، كان هذا الحد قيمة مشفرة بشكل ثابت، \fBSOMAXCONN\fP، بقيمة 128. .SH أمثلة انظر \fBbind\fP(2). .SH "انظر أيضًا" \fBaccept\fP(2), \fBbind\fP(2), \fBconnect\fP(2), \fBsocket\fP(2), \fBsocket\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 .