mirror of https://github.com/acidanthera/audk.git
73 lines
2.5 KiB
C
73 lines
2.5 KiB
C
|
/** @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;
|
||
|
|
}
|