summaryrefslogtreecommitdiff
path: root/StdLib/BsdSocketLib/bind.c
diff options
context:
space:
mode:
Diffstat (limited to 'StdLib/BsdSocketLib/bind.c')
-rw-r--r--StdLib/BsdSocketLib/bind.c72
1 files changed, 72 insertions, 0 deletions
diff --git a/StdLib/BsdSocketLib/bind.c b/StdLib/BsdSocketLib/bind.c
new file mode 100644
index 0000000000..fc24ea420a
--- /dev/null
+++ b/StdLib/BsdSocketLib/bind.c
@@ -0,0 +1,72 @@
+/** @file
+ Implement the bind 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>
+
+
+/**
+ Bind a name to a socket.
+
+ The ::bind routine connects a name to a socket on the local machine. The
+ <a href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/bind.html">POSIX</a>
+ documentation for the bind routine is available online for reference.
+
+ @param [in] s Socket file descriptor returned from ::socket.
+
+ @param [in] name Address of a sockaddr structure that contains the
+ connection point on the local machine. An IPv4 address
+ of INADDR_ANY specifies that the connection is made to
+ all of the network stacks on the platform. Specifying a
+ specific IPv4 address restricts the connection to the
+ network stack supporting that address. Specifying zero
+ for the port causes the network layer to assign a port
+ number from the dynamic range. Specifying a specific
+ port number causes the network layer to use that port.
+
+ @param [in] namelen Specifies the length in bytes of the sockaddr structure.
+
+ @returns The bind routine returns zero (0) if successful and -1 upon failure.
+
+ **/
+int
+bind (
+ IN int s,
+ IN const struct sockaddr * name,
+ IN socklen_t namelen
+ )
+{
+ int BindStatus;
+ EFI_SOCKET_PROTOCOL * pSocketProtocol;
+ EFI_STATUS Status;
+
+ //
+ // Locate the context for this socket
+ //
+ pSocketProtocol = BslFdToSocketProtocol ( s, NULL, &errno );
+ if ( NULL != pSocketProtocol ) {
+ //
+ // Bind the socket
+ //
+ Status = pSocketProtocol->pfnBind ( pSocketProtocol,
+ name,
+ namelen,
+ &errno );
+ }
+
+ //
+ // Return the operation stauts
+ //
+ BindStatus = ( 0 == errno ) ? 0 : -1;
+ return BindStatus;
+}