| 1 | /** @file
|
|---|
| 2 | Implement the bind 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 | /** Bind a name to a socket.
|
|---|
| 17 |
|
|---|
| 18 | The bind routine connects a name (network address) to a socket on the local machine.
|
|---|
| 19 |
|
|---|
| 20 | The
|
|---|
| 21 | <a href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/bind.html">POSIX</a>
|
|---|
| 22 | documentation is available online.
|
|---|
| 23 |
|
|---|
| 24 | @param[in] s Socket file descriptor returned from ::socket.
|
|---|
| 25 |
|
|---|
| 26 | @param[in] name Address of a sockaddr structure that contains the
|
|---|
| 27 | connection point on the local machine. An IPv4 address
|
|---|
| 28 | of INADDR_ANY specifies that the connection is made to
|
|---|
| 29 | all of the network stacks on the platform. Specifying a
|
|---|
| 30 | specific IPv4 address restricts the connection to the
|
|---|
| 31 | network stack supporting that address. Specifying zero
|
|---|
| 32 | for the port causes the network layer to assign a port
|
|---|
| 33 | number from the dynamic range. Specifying a specific
|
|---|
| 34 | port number causes the network layer to use that port.
|
|---|
| 35 |
|
|---|
| 36 | @param[in] namelen Specifies the length in bytes of the sockaddr structure.
|
|---|
| 37 |
|
|---|
| 38 | @return The bind routine returns zero (0) if successful and -1 upon failure.
|
|---|
| 39 | In the case of an error, ::errno contains more information.
|
|---|
| 40 | **/
|
|---|
| 41 | int
|
|---|
| 42 | bind (
|
|---|
| 43 | IN int s,
|
|---|
| 44 | IN const struct sockaddr * name,
|
|---|
| 45 | IN socklen_t namelen
|
|---|
| 46 | )
|
|---|
| 47 | {
|
|---|
| 48 | int BindStatus;
|
|---|
| 49 | EFI_SOCKET_PROTOCOL * pSocketProtocol;
|
|---|
| 50 |
|
|---|
| 51 | // Locate the context for this socket
|
|---|
| 52 | pSocketProtocol = BslFdToSocketProtocol ( s, NULL, &errno );
|
|---|
| 53 | if ( NULL != pSocketProtocol ) {
|
|---|
| 54 |
|
|---|
| 55 | // Bind the socket
|
|---|
| 56 | (void) pSocketProtocol->pfnBind ( pSocketProtocol,
|
|---|
| 57 | name,
|
|---|
| 58 | namelen,
|
|---|
| 59 | &errno );
|
|---|
| 60 | }
|
|---|
| 61 |
|
|---|
| 62 | // Return the operation stauts
|
|---|
| 63 | BindStatus = ( 0 == errno ) ? 0 : -1;
|
|---|
| 64 | return BindStatus;
|
|---|
| 65 | }
|
|---|
