1 /** @file 2 Implement the listen API. 3 4 Copyright (c) 2011 - 2014, Intel Corporation. All rights reserved.<BR> 5 This program and the accompanying materials are licensed and made available under 6 the terms and conditions of the BSD License that accompanies this distribution. 7 The full text of the license may be found at 8 http://opensource.org/licenses/bsd-license.php. 9 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. 12 **/ 13 #include <SocketInternals.h> 14 15 16 /** Establish the known port to listen for network connections. 17 18 The listen routine places the port into a state that enables connection 19 attempts. Connections are placed into FIFO order in a queue to be serviced 20 by the application. The application calls the ::accept routine to remove 21 the next connection from the queue and get the associated socket. 22 23 The 24 <a href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/listen.html">POSIX</a> 25 documentation is available online. 26 27 @param [in] s Socket file descriptor returned from ::socket. 28 29 @param [in] backlog backlog specifies the maximum FIFO depth for the connections 30 waiting for the application to call ::accept. Connection attempts 31 received while the queue is full are refused. 32 33 @return This routine returns zero (0) if successful or -1 when an error occurs. 34 In the case of an error, ::errno contains more details. 35 **/ 36 int 37 listen ( 38 IN int s, 39 IN int backlog 40 ) 41 { 42 int ListenStatus; 43 EFI_SOCKET_PROTOCOL * pSocketProtocol; 44 45 // Locate the context for this socket 46 pSocketProtocol = BslFdToSocketProtocol ( s, NULL, &errno ); 47 if ( NULL != pSocketProtocol ) { 48 // Enable connections on the known port 49 (void) pSocketProtocol->pfnListen ( pSocketProtocol, 50 backlog, 51 &errno ); 52 } 53 // Return the operation stauts 54 ListenStatus = ( 0 == errno ) ? 0 : -1; 55 return ListenStatus; 56 } 57