]>
git.proxmox.com Git - mirror_edk2.git/blob - StdLib/BsdSocketLib/listen.c
2 Implement the listen API.
4 Copyright (c) 2011, Intel Corporation
5 All rights reserved. This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
15 #include <SocketInternals.h>
19 Establish the known port to listen for network connections.
21 The listen routine places the port into a state that enables connection
22 attempts. Connections are placed into FIFO order in a queue to be serviced
23 by the application. The application calls the ::accept routine to remove
24 the next connection from the queue and get the associated socket.
27 <a href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/listen.html">POSIX</a>
28 documentation is available online.
30 @param [in] s Socket file descriptor returned from ::socket.
32 @param [in] backlog backlog specifies the maximum FIFO depth for the connections
33 waiting for the application to call ::accept. Connection attempts
34 received while the queue is full are refused.
36 @return This routine returns zero (0) if successful or -1 when an error occurs.
37 In the case of an error, ::errno contains more details.
47 EFI_SOCKET_PROTOCOL
* pSocketProtocol
;
51 // Locate the context for this socket
53 pSocketProtocol
= BslFdToSocketProtocol ( s
, NULL
, &errno
);
54 if ( NULL
!= pSocketProtocol
) {
56 // Enable connections on the known port
58 Status
= pSocketProtocol
->pfnListen ( pSocketProtocol
,
64 // Return the operation stauts
66 ListenStatus
= ( 0 == errno
) ? 0 : -1;