From d7ce700605e1af0e455e31ec11f19ff21d26b525 Mon Sep 17 00:00:00 2001
From: darylm503 <darylm503@6f19259b-4bc3-4df7-8a09-765794883524>
Date: Sat, 30 Jul 2011 00:30:44 +0000
Subject: Add Socket Libraries. Add Posix functions for porting compatibility.
 Fix compliance issues with ISO/IEC 9899:199409 New Functions:   setenv(),
 fparseln(), GetFileNameFromPath(), rename(),   realpath(), setprogname(),
 getprogname(), strlcat(), strlcpy(),   strsep(), setitimer(), getitimer(),
 timegm(), getopt(), basename(),   mkstemp(), ffs(), vsnprintf(), snprintf(),
 getpass(), usleep(), select(),   writev(), strcasecmp(), getcwd(), chdir(),
 tcgetpgrp(), getpgrp(), gettimeofday(),   bcopy(),

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@12061 6f19259b-4bc3-4df7-8a09-765794883524
---
 StdLib/BsdSocketLib/connect.c | 94 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 94 insertions(+)
 create mode 100644 StdLib/BsdSocketLib/connect.c

(limited to 'StdLib/BsdSocketLib/connect.c')

diff --git a/StdLib/BsdSocketLib/connect.c b/StdLib/BsdSocketLib/connect.c
new file mode 100644
index 0000000000..e02762efa3
--- /dev/null
+++ b/StdLib/BsdSocketLib/connect.c
@@ -0,0 +1,94 @@
+/** @file
+  Implement the connect API.
+
+  Copyright (c) 2011, Intel Corporation
+  All rights reserved. This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <SocketInternals.h>
+
+
+/**
+  Connect to a remote system via the network.
+
+  The ::connect routine attempts to establish a connection to a
+  socket on the local or remote system using the specified address.
+  The
+  <a href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/connect.html">POSIX</a>
+  documentation is available online.
+
+  There are three states associated with a connection:
+  <ul>
+    <li>Not connected</li>
+    <li>Connection in progress</li>
+    <li>Connected</li>
+  </ul>
+  In the "Not connected" state, calls to ::connect start the connection
+  processing and update the state to "Connection in progress".  During
+  the "Connection in progress" state, connect polls for connection completion
+  and moves the state to "Connected" after the connection is established.
+  Note that these states are only visible when the file descriptor is marked
+  with O_NONBLOCK.  Also, the POLL_WRITE bit is set when the connection
+  completes and may be used by poll or select as an indicator to call
+  connect again.
+
+  @param [in] s         Socket file descriptor returned from ::socket.
+
+  @param [in] address   Network address of the remote system
+  
+  @param [in] address_len Length of the remote network address
+
+  @returns    ::connect returns zero if successful and -1 when an error occurs.
+              In the case of an error, errno contains more details.
+
+ **/
+int
+connect (
+  int s,
+  const struct sockaddr * address,
+  socklen_t address_len
+  )
+{
+  BOOLEAN bBlocking;
+  int ConnectStatus;
+  struct __filedes * pDescriptor;
+  EFI_SOCKET_PROTOCOL * pSocketProtocol;
+  EFI_STATUS Status;
+  
+  //
+  //  Locate the context for this socket
+  //
+  pSocketProtocol = BslFdToSocketProtocol ( s,
+                                            &pDescriptor,
+                                            &errno );
+  if ( NULL != pSocketProtocol ) {
+    //
+    // TODO: Check for NON_BLOCKING
+    //
+    bBlocking = TRUE;
+
+    //
+    //  Attempt to connect to a remote system
+    //
+    do {
+      errno = 0;
+      Status = pSocketProtocol->pfnConnect ( pSocketProtocol,
+                                             address,
+                                             address_len,
+                                             &errno );
+    } while ( bBlocking && ( EFI_NOT_READY == Status ));
+  }
+  
+  //
+  //  Return the new socket file descriptor
+  //
+  ConnectStatus = (0 == errno) ? 0 : -1;
+  return ConnectStatus;
+}
-- 
cgit v1.2.3