2 Definitions for the Socket layer driver.
4 Copyright (c) 2011, Intel Corporation
5 All rights reserved. This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license
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.
17 #include <Efi/EfiSocketLib.h>
19 //------------------------------------------------------------------------------
21 //------------------------------------------------------------------------------
23 #define DEBUG_SOCKET 0x20000000 ///< Display Socket related messages
24 #define DEBUG_BIND 0x10000000 ///< Display bind related messages
25 #define DEBUG_LISTEN 0x08000000 ///< Display listen related messages
26 #define DEBUG_CONNECTION 0x04000000 ///< Display connection list related messages
27 #define DEBUG_POLL 0x02000000 ///< Display poll messages
28 #define DEBUG_ACCEPT 0x01000000 ///< Display accept related messages
29 #define DEBUG_RX 0x00800000 ///< Display receive messages
30 #define DEBUG_TX 0x00400000 ///< Display transmit messages
31 #define DEBUG_CLOSE 0x00200000 ///< Display close messages
32 #define DEBUG_CONNECT 0x00100000 ///< Display connect messages
33 #define DEBUG_OPTION 0x00080000 ///< Display option messages
35 #define MAX_PENDING_CONNECTIONS 1 ///< Maximum connection FIFO depth
36 #define MAX_RX_DATA 65536 ///< Maximum receive data size
37 #define MAX_TX_DATA ( MAX_RX_DATA * 2 ) ///< Maximum buffered transmit data in bytes
38 #define RX_PACKET_DATA 16384 ///< Maximum number of bytes in a RX packet
39 #define MAX_UDP_RETRANSMIT 16 ///< UDP retransmit attempts to handle address not mapped
41 #define ESL_STRUCTURE_ALIGNMENT_BYTES 15 ///< Number of bytes for structure alignment
42 #define ESL_STRUCTURE_ALIGNMENT_MASK ( ~ESL_STRUCTURE_ALIGNMENT_BYTES ) ///< Mask to align structures
44 #define LAYER_SIGNATURE SIGNATURE_32 ('S','k','t','L') ///< ESL_LAYER memory signature
45 #define SERVICE_SIGNATURE SIGNATURE_32 ('S','k','t','S') ///< ESL_SERVICE memory signature
46 #define SOCKET_SIGNATURE SIGNATURE_32 ('S','c','k','t') ///< ESL_SOCKET memory signature
47 #define PORT_SIGNATURE SIGNATURE_32 ('P','o','r','t') ///< ESL_PORT memory signature
55 SOCKET_STATE_NOT_CONFIGURED
= 0, ///< socket call was successful
56 SOCKET_STATE_BOUND
, ///< bind call was successful
57 SOCKET_STATE_LISTENING
, ///< listen call was successful
58 SOCKET_STATE_NO_PORTS
, ///< No ports available
59 SOCKET_STATE_IN_FIFO
, ///< Socket on FIFO
60 SOCKET_STATE_CONNECTING
, ///< Connecting to a remote system
61 SOCKET_STATE_CONNECTED
, ///< Accept or connect call was successful
64 // Close state must be the last in the list
66 SOCKET_STATE_CLOSED
///< Close call was successful
75 PORT_STATE_ALLOCATED
= 0, ///< Port allocated
76 PORT_STATE_OPEN
, ///< Port opened
77 PORT_STATE_RX_ERROR
, ///< Receive error detected
80 // Close state must be last in the list!
82 // Using < <= > >= in tests code to detect port close state
83 // machine has started
85 PORT_STATE_CLOSE_STARTED
, ///< Close started on port
86 PORT_STATE_CLOSE_TX_DONE
, ///< Transmits shutdown
87 PORT_STATE_CLOSE_DONE
, ///< Port close operation complete
88 PORT_STATE_CLOSE_RX_DONE
///< Receives shutdown
91 //------------------------------------------------------------------------------
93 //------------------------------------------------------------------------------
95 typedef struct _ESL_IO_MGMT ESL_IO_MGMT
;///< Forward declaration
96 typedef struct _ESL_PACKET ESL_PACKET
; ///< Forward declaration
97 typedef struct _ESL_PORT ESL_PORT
; ///< Forward declaration
98 typedef struct _ESL_SOCKET ESL_SOCKET
; ///< Forward declaration
101 Receive context for SOCK_RAW sockets using IPv4.
105 EFI_IP4_RECEIVE_DATA
* pRxData
; ///< Receive operation description
110 Transmit context for SOCK_RAW sockets using IPv4.
114 EFI_IP4_OVERRIDE_DATA Override
; ///< Override data
115 EFI_IP4_TRANSMIT_DATA TxData
; ///< Transmit operation description
116 UINT8 Buffer
[ 1 ]; ///< Data buffer
121 Receive context for SOCK_STREAM and SOCK_SEQPACKET sockets using TCPv4.
125 EFI_TCP4_RECEIVE_DATA RxData
; ///< Receive operation description
126 UINT8 Buffer
[ RX_PACKET_DATA
]; ///< Data buffer
131 Transmit context for SOCK_STREAM and SOCK_SEQPACKET sockets using TCPv4.
135 EFI_TCP4_TRANSMIT_DATA TxData
; ///< Transmit operation description
136 UINT8 Buffer
[ 1 ]; ///< Data buffer
141 Receive context for SOCK_STREAM and SOCK_SEQPACKET sockets using TCPv6.
145 EFI_TCP6_RECEIVE_DATA RxData
; ///< Receive operation description
146 UINT8 Buffer
[ RX_PACKET_DATA
]; ///< Data buffer
151 Transmit context for SOCK_STREAM and SOCK_SEQPACKET sockets using TCPv6.
155 EFI_TCP6_TRANSMIT_DATA TxData
; ///< Transmit operation description
156 UINT8 Buffer
[ 1 ]; ///< Data buffer
161 Receive context for SOCK_DGRAM sockets using UDPv4.
165 EFI_UDP4_SESSION_DATA Session
; ///< Remote network address
166 EFI_UDP4_RECEIVE_DATA
* pRxData
; ///< Receive operation description
171 Transmit context for SOCK_DGRAM sockets using UDPv4.
175 EFI_UDP4_SESSION_DATA Session
; ///< Remote network address
176 EFI_UDP4_TRANSMIT_DATA TxData
; ///< Transmit operation description
177 UINTN RetransmitCount
; ///< Retransmit to handle ARP negotiation
178 UINT8 Buffer
[ 1 ]; ///< Data buffer
183 Receive context for SOCK_DGRAM sockets using UDPv6.
187 EFI_UDP6_SESSION_DATA Session
; ///< Remote network address
188 EFI_UDP6_RECEIVE_DATA
* pRxData
; ///< Receive operation description
193 Transmit context for SOCK_DGRAM sockets using UDPv6.
197 EFI_UDP6_SESSION_DATA Session
; ///< Remote network address
198 EFI_UDP6_TRANSMIT_DATA TxData
; ///< Transmit operation description
199 UINTN RetransmitCount
; ///< Retransmit to handle ARP negotiation
200 UINT8 Buffer
[ 1 ]; ///< Data buffer
205 Network specific context for transmit and receive packets.
207 typedef struct _ESL_PACKET
{
208 ESL_PACKET
* pNext
; ///< Next packet in the receive list
209 size_t PacketSize
; ///< Size of this data structure
210 size_t ValidBytes
; ///< Length of valid data in bytes
211 UINT8
* pBuffer
; ///< Current data pointer
213 ESL_IP4_RX_DATA Ip4Rx
; ///< Receive operation description
214 ESL_IP4_TX_DATA Ip4Tx
; ///< Transmit operation description
215 ESL_TCP4_RX_DATA Tcp4Rx
; ///< Receive operation description
216 ESL_TCP4_TX_DATA Tcp4Tx
; ///< Transmit operation description
217 ESL_TCP6_RX_DATA Tcp6Rx
; ///< Receive operation description
218 ESL_TCP6_TX_DATA Tcp6Tx
; ///< Transmit operation description
219 ESL_UDP4_RX_DATA Udp4Rx
; ///< Receive operation description
220 ESL_UDP4_TX_DATA Udp4Tx
; ///< Transmit operation description
221 ESL_UDP6_RX_DATA Udp6Rx
; ///< Receive operation description
222 ESL_UDP6_TX_DATA Udp6Tx
; ///< Transmit operation description
223 } Op
; ///< Network specific context
227 Service control structure
229 The driver uses this structure to manage the network devices.
231 typedef struct _ESL_SERVICE
{
232 UINTN Signature
; ///< Structure identification
237 ESL_SERVICE
* pNext
; ///< Next service in the service list
242 CONST ESL_SOCKET_BINDING
* pSocketBinding
; ///< Name and shutdown routine
243 EFI_HANDLE Controller
; ///< Controller for the service
244 EFI_SERVICE_BINDING_PROTOCOL
* pServiceBinding
; ///< Network layer service binding interface
249 ESL_PORT
* pPortList
; ///< List of ports using this service
253 IO management structure
255 This structure manages a single operation with the network.
257 typedef struct _ESL_IO_MGMT
{
258 ESL_IO_MGMT
* pNext
; ///< Next TX management structure
259 ESL_PORT
* pPort
; ///< Port structure address
260 ESL_PACKET
* pPacket
; ///< Packet structure address
262 EFI_IP4_COMPLETION_TOKEN Ip4Rx
; ///< IP4 receive token
263 EFI_IP4_COMPLETION_TOKEN Ip4Tx
; ///< IP4 transmit token
264 EFI_TCP4_IO_TOKEN Tcp4Rx
; ///< TCP4 receive token
265 EFI_TCP4_IO_TOKEN Tcp4Tx
; ///< TCP4 transmit token
266 EFI_TCP6_IO_TOKEN Tcp6Rx
; ///< TCP6 receive token
267 EFI_TCP6_IO_TOKEN Tcp6Tx
; ///< TCP6 transmit token
268 EFI_UDP4_COMPLETION_TOKEN Udp4Rx
; ///< UDP4 receive token
269 EFI_UDP4_COMPLETION_TOKEN Udp4Tx
; ///< UDP4 transmit token
270 EFI_UDP6_COMPLETION_TOKEN Udp6Rx
; ///< UDP6 receive token
271 EFI_UDP6_COMPLETION_TOKEN Udp6Tx
; ///< UDP6 transmit token
272 } Token
; ///< Completion token for the network operation
276 IP4 context structure
278 The driver uses this structure to manage the IP4 connections.
284 EFI_IP4_MODE_DATA ModeData
; ///< IP4 mode data, includes configuration data
285 EFI_IPv4_ADDRESS DestinationAddress
; ///< Default destination address
290 TCP4 context structure
292 The driver uses this structure to manage the TCP4 connections.
298 EFI_TCP4_CONFIG_DATA ConfigData
; ///< TCP4 configuration data
299 EFI_TCP4_OPTION Option
; ///< TCP4 port options
304 EFI_TCP4_LISTEN_TOKEN ListenToken
; ///< Listen control
305 EFI_TCP4_CONNECTION_TOKEN ConnectToken
; ///< Connection control
306 EFI_TCP4_CLOSE_TOKEN CloseToken
; ///< Close control
310 TCP6 context structure
312 The driver uses this structure to manage the TCP6 connections.
318 EFI_TCP6_CONFIG_DATA ConfigData
; ///< TCP6 configuration data
319 EFI_TCP6_OPTION Option
; ///< TCP6 port options
324 EFI_TCP6_LISTEN_TOKEN ListenToken
; ///< Listen control
325 EFI_TCP6_CONNECTION_TOKEN ConnectToken
; ///< Connection control
326 EFI_TCP6_CLOSE_TOKEN CloseToken
; ///< Close control
330 UDP4 context structure
332 The driver uses this structure to manage the UDP4 connections.
338 EFI_UDP4_CONFIG_DATA ConfigData
; ///< UDP4 configuration data
342 UDP6 context structure
344 The driver uses this structure to manage the UDP6 connections.
350 EFI_UDP6_CONFIG_DATA ConfigData
; ///< UDP6 configuration data
355 Configure the network layer.
357 @param [in] pProtocol Protocol structure address
358 @param [in] pConfigData Address of the confiuration data
360 @return Returns EFI_SUCCESS if the operation is successfully
365 (* PFN_NET_CONFIGURE
) (
367 IN VOID
* pConfigData
371 Hand an I/O operation to the network layer.
373 @param [in] pProtocol Protocol structure address
374 @param [in] pToken Completion token address
376 @return Returns EFI_SUCCESS if the operation is successfully
381 (* PFN_NET_IO_START
) (
387 Poll the LAN adapter for receive packets.
389 @param [in] pProtocol Protocol structure address
390 @param [in] pToken Completion token address
392 @return Returns EFI_SUCCESS if the operation is successfully
402 Port control structure
404 The driver uses this structure to manager the socket's connection
405 with the network driver.
407 typedef struct _ESL_PORT
{
408 UINTN Signature
; ///< Structure identification
413 ESL_PORT
* pLinkService
; ///< Link in service port list
414 ESL_PORT
* pLinkSocket
; ///< Link in socket port list
419 ESL_SERVICE
* pService
; ///< Service for this port
420 ESL_SOCKET
* pSocket
; ///< Socket for this port
423 // Eliminate the pService references during port close
425 EFI_SERVICE_BINDING_PROTOCOL
* pServiceBinding
; ///< Service binding for network layer
426 CONST ESL_SOCKET_BINDING
* pSocketBinding
; ///< Socket binding for network layer
431 EFI_HANDLE Handle
; ///< Network port handle
432 PORT_STATE State
; ///< State of the port
433 UINTN DebugFlags
; ///< Debug flags used to close the port
434 BOOLEAN bCloseNow
; ///< TRUE = Close the port immediately
435 BOOLEAN bConfigured
; ///< TRUE = Configure call made to network layer
436 PFN_NET_CONFIGURE pfnConfigure
; ///< Configure the network layer
439 // Transmit data management
441 BOOLEAN bTxFlowControl
; ///< TX flow control applied
442 PFN_NET_IO_START pfnTxStart
; ///< Start a transmit on the network
443 ESL_IO_MGMT
* pTxActive
; ///< Normal data queue
444 ESL_IO_MGMT
* pTxFree
; ///< Normal free queue
446 ESL_IO_MGMT
* pTxOobActive
; ///< Urgent data queue
447 ESL_IO_MGMT
* pTxOobFree
; ///< Urgent free queue
450 // Receive data management
452 PFN_NET_IO_START pfnRxCancel
; ///< Cancel a receive on the network
453 PFN_NET_POLL pfnRxPoll
; ///< Poll the LAN adapter for receive packets
454 PFN_NET_IO_START pfnRxStart
; ///< Start a receive on the network
455 ESL_IO_MGMT
* pRxActive
; ///< Active receive operation queue
456 ESL_IO_MGMT
* pRxFree
; ///< Free structure queue
459 // Protocol specific management data
462 VOID
* v
; ///< VOID pointer
463 EFI_IP4_PROTOCOL
* IPv4
; ///< IP4 protocol pointer
464 EFI_TCP4_PROTOCOL
* TCPv4
; ///< TCP4 protocol pointer
465 EFI_TCP6_PROTOCOL
* TCPv6
; ///< TCP6 protocol pointer
466 EFI_UDP4_PROTOCOL
* UDPv4
; ///< UDP4 protocol pointer
467 EFI_UDP6_PROTOCOL
* UDPv6
; ///< UDP6 protocol pointer
468 } pProtocol
; ///< Protocol structure address
470 ESL_IP4_CONTEXT Ip4
; ///< IPv4 management data
471 ESL_TCP4_CONTEXT Tcp4
; ///< TCPv4 management data
472 ESL_TCP6_CONTEXT Tcp6
; ///< TCPv6 management data
473 ESL_UDP4_CONTEXT Udp4
; ///< UDPv4 management data
474 ESL_UDP6_CONTEXT Udp6
; ///< UDPv6 management data
475 } Context
; ///< Network specific context
479 Accept a network connection.
481 @param [in] pSocket Address of the socket structure.
483 @param [in] pSockAddr Address of a buffer to receive the remote
486 @param [in, out] pSockAddrLength Length in bytes of the address buffer.
487 On output specifies the length of the
488 remote network address.
490 @retval EFI_SUCCESS Remote address is available
491 @retval Others Remote address not available
497 IN ESL_SOCKET
* pSocket
,
498 IN
struct sockaddr
* pSockAddr
,
499 IN OUT socklen_t
* pSockAddrLength
503 Poll for completion of the connection attempt.
505 @param [in] pSocket Address of an ::ESL_SOCKET structure.
507 @retval EFI_SUCCESS The connection was successfully established.
508 @retval EFI_NOT_READY The connection is in progress, call this routine again.
509 @retval Others The connection attempt failed.
514 (* PFN_API_CONNECT_POLL
) (
515 IN ESL_SOCKET
* pSocket
519 Attempt to connect to a remote TCP port
521 This routine starts the connection processing for a SOCK_STREAM
522 or SOCK_SEQPAKCET socket using the TCP network layer.
524 This routine is called by ::EslSocketConnect to initiate the TCP
525 network specific connect operations.
527 @param [in] pSocket Address of an ::ESL_SOCKET structure.
529 @retval EFI_SUCCESS The connection was successfully established.
530 @retval EFI_NOT_READY The connection is in progress, call this routine again.
531 @retval Others The connection attempt failed.
536 (* PFN_API_CONNECT_START
) (
537 IN ESL_SOCKET
* pSocket
541 Get the local socket address
543 @param [in] pPort Address of an ::ESL_PORT structure.
545 @param [out] pAddress Network address to receive the local system address
550 (* PFN_API_LOCAL_ADDR_GET
) (
552 OUT
struct sockaddr
* pAddress
556 Set the local port address.
558 This routine sets the local port address.
560 This support routine is called by ::EslSocketPortAllocate.
562 @param [in] ppPort Address of an ESL_PORT structure
563 @param [in] pSockAddr Address of a sockaddr structure that contains the
564 connection point on the local machine. An IPv4 address
565 of INADDR_ANY specifies that the connection is made to
566 all of the network stacks on the platform. Specifying a
567 specific IPv4 address restricts the connection to the
568 network stack supporting that address. Specifying zero
569 for the port causes the network layer to assign a port
570 number from the dynamic range. Specifying a specific
571 port number causes the network layer to use that port.
572 @param [in] bBindTest TRUE = run bind testing
574 @retval EFI_SUCCESS The operation was successful
579 (* PFN_API_LOCAL_ADDR_SET
) (
581 IN CONST
struct sockaddr
* pSockAddr
,
586 Process the completion event
588 This routine handles the I/O completion event.
590 This routine is called by the low level network driver when
591 the operation is completed.
593 @param [in] Event The receive completion event
595 @param [in] pIo The address of an ::ESL_IO_MGMT structure
600 (* PFN_API_IO_COMPLETE
) (
606 Determine if the socket is configured.
609 @param [in] pSocket Address of a ESL_SOCKET structure
611 @retval EFI_SUCCESS - The port is connected
612 @retval EFI_NOT_STARTED - The port is not connected
617 (* PFN_API_IS_CONFIGURED
) (
618 IN ESL_SOCKET
* pSocket
622 Establish the known port to listen for network connections.
624 @param [in] pSocket Address of the socket structure.
626 @retval EFI_SUCCESS - Socket successfully created
627 @retval Other - Failed to enable the socket for listen
633 IN ESL_SOCKET
* pSocket
639 Retrieve the protocol options one at a time by name.
641 @param [in] pSocket Address of a ESL_SOCKET structure
642 @param [in] OptionName Name of the option
643 @param [out] ppOptionData Buffer to receive address of option value
644 @param [out] pOptionLength Buffer to receive the option length
646 @retval EFI_SUCCESS - Socket data successfully received
651 (* PFN_API_OPTION_GET
) (
652 IN ESL_SOCKET
* pSocket
,
654 OUT CONST
void ** __restrict ppOptionData
,
655 OUT socklen_t
* __restrict pOptionLength
661 Adjust the protocol options one at a time by name.
663 @param [in] pSocket Address of a ESL_SOCKET structure
664 @param [in] OptionName Name of the option
665 @param [in] pOptionValue Buffer containing the option value
666 @param [in] OptionLength Length of the buffer in bytes
668 @retval EFI_SUCCESS - Option successfully set
673 (* PFN_API_OPTION_SET
) (
674 IN ESL_SOCKET
* pSocket
,
676 IN CONST
void * pOptionValue
,
677 IN socklen_t OptionLength
681 Free a receive packet
683 This routine performs the network specific operations necessary
684 to free a receive packet.
686 This routine is called by ::EslSocketPortCloseTxDone to free a
689 @param [in] pPacket Address of an ::ESL_PACKET structure.
690 @param [in, out] pRxBytes Address of the count of RX bytes
695 (* PFN_API_PACKET_FREE
) (
696 IN ESL_PACKET
* pPacket
,
697 IN OUT
size_t * pRxBytes
701 Initialize the network specific portions of an ::ESL_PORT structure.
703 This routine initializes the network specific portions of an
704 ::ESL_PORT structure for use by the socket.
706 This support routine is called by ::EslSocketPortAllocate
707 to connect the socket with the underlying network adapter
708 running the IPv4 protocol.
710 @param [in] ppPort Address of an ESL_PORT structure
711 @param [in] DebugFlags Flags for debug messages
713 @retval EFI_SUCCESS - Socket successfully created
718 (* PFN_API_PORT_ALLOC
) (
724 Close a network specific port.
726 This routine releases the resources allocated by the
727 network specific PortAllocate routine.
729 This routine is called by ::EslSocketPortCloseRxDone as
730 the last step of closing processing.
731 See the \ref PortCloseStateMachine section.
733 @param [in] pPort Address of an ::ESL_PORT structure.
735 @retval EFI_SUCCESS The port is closed
736 @retval other Port close error
741 (* PFN_API_PORT_CLOSE
) (
746 Perform the network specific close operation on the port.
748 This routine performs the network specific operation to
749 shutdown receive operations on the port.
751 This routine is called by the ::EslSocketPortCloseTxDone
752 routine after the port completes all of the transmission.
754 @param [in] pPort Address of an ::ESL_PORT structure.
756 @retval EFI_SUCCESS The port is closed, not normally returned
757 @retval EFI_NOT_READY The port is still closing
758 @retval EFI_ALREADY_STARTED Error, the port is in the wrong state,
759 most likely the routine was called already.
764 (* PFN_API_PORT_CLOSE_OP
) (
769 Receive data from a network connection.
771 This routine attempts to return buffered data to the caller. The
772 data is removed from the urgent queue if the message flag MSG_OOB
773 is specified, otherwise data is removed from the normal queue.
774 See the \ref ReceiveEngine section.
776 This routine is called by ::EslSocketReceive to handle the network
777 specific receive operation.
779 @param [in] pPort Address of an ::ESL_PORT structure.
781 @param [in] pPacket Address of an ::ESL_PACKET structure.
783 @param [in] pbConsumePacket Address of a BOOLEAN indicating if the packet is to be consumed
785 @param [in] BufferLength Length of the the buffer
787 @param [in] pBuffer Address of a buffer to receive the data.
789 @param [in] pDataLength Number of received data bytes in the buffer.
791 @param [out] pAddress Network address to receive the remote system address
793 @param [out] pSkipBytes Address to receive the number of bytes skipped
795 @return Returns the address of the next free byte in the buffer.
800 (* PFN_API_RECEIVE
) (
802 IN ESL_PACKET
* pPacket
,
803 IN BOOLEAN
* pbConsumePacket
,
804 IN
size_t BufferLength
,
806 OUT
size_t * pDataLength
,
807 OUT
struct sockaddr
* pAddress
,
808 OUT
size_t * pSkipBytes
812 Get the remote socket address
814 @param [in] pPort Address of an ::ESL_PORT structure.
816 @param [out] pAddress Network address to receive the remote system address
821 (* PFN_API_REMOTE_ADDR_GET
) (
823 OUT
struct sockaddr
* pAddress
827 Set the remote address
829 This routine sets the remote address in the port.
831 This routine is called by ::EslSocketConnect to specify the
832 remote network address.
834 @param [in] pPort Address of an ::ESL_PORT structure.
836 @param [in] pSockAddr Network address of the remote system.
838 @param [in] SockAddrLength Length in bytes of the network address.
840 @retval EFI_SUCCESS The operation was successful
845 (* PFN_API_REMOTE_ADDR_SET
) (
847 IN CONST
struct sockaddr
* pSockAddr
,
848 IN socklen_t SockAddrLength
852 Start a receive operation
854 This routine prepares a packet for the receive operation.
855 See the \ref ReceiveEngine section.
857 This support routine is called by EslSocketRxStart.
859 @param [in] pPort Address of an ::ESL_PORT structure.
860 @param [in] pIo Address of an ::ESL_IO_MGMT structure.
865 (* PFN_API_RX_START
) (
871 Buffer data for transmission over a network connection.
873 @param [in] pSocket Address of a ESL_SOCKET structure
875 @param [in] Flags Message control flags
877 @param [in] BufferLength Length of the the buffer
879 @param [in] pBuffer Address of a buffer to receive the data.
881 @param [in] pDataLength Number of received data bytes in the buffer.
883 @param [in] pAddress Network address of the remote system address
885 @param [in] AddressLength Length of the remote network address structure
887 @retval EFI_SUCCESS - Socket data successfully buffered
892 (* PFN_API_TRANSMIT
) (
893 IN ESL_SOCKET
* pSocket
,
895 IN
size_t BufferLength
,
896 IN CONST UINT8
* pBuffer
,
897 OUT
size_t * pDataLength
,
898 IN
const struct sockaddr
* pAddress
,
899 IN socklen_t AddressLength
903 Process the transmit completion
905 This routine calls ::EslSocketTxComplete to handle the
908 This routine is called by the network layers upon the completion
909 of a transmit operation.
911 @param [in] Event The urgent transmit completion event
913 @param [in] pIo The ESL_IO_MGMT structure address
918 (* PFN_API_TX_COMPLETE
) (
924 Socket type control structure
926 This driver uses this structure to define the API for the socket type.
929 CONST CHAR8
* pName
; ///< Protocol name
930 int DefaultProtocol
; ///< Default protocol
931 UINTN ConfigDataOffset
; ///< Offset in ::ESL_PORT to the configuration data
932 UINTN ServiceListOffset
; ///< Offset in ::ESL_LAYER for the list of services
933 socklen_t MinimumAddressLength
; ///< Minimum address length in bytes
934 socklen_t AddressLength
; ///< Address length in bytes
935 sa_family_t AddressFamily
; ///< Address family
936 UINTN RxPacketBytes
; ///< Length of the RX packet allocation
937 UINTN RxZeroBytes
; ///< Number of bytes to zero in RX packet
938 UINTN RxBufferOffset
; ///< Offset of buffer address in ESL_IO_MGMT structure
939 BOOLEAN bOobSupported
; ///< TRUE if out-of-band messages are supported
940 int BindTestErrno
; ///< errno value if EslSocketBindTest fails
941 PFN_API_ACCEPT pfnAccept
; ///< Accept a network connection
942 PFN_API_CONNECT_POLL pfnConnectPoll
; ///< Poll for connection complete
943 PFN_API_CONNECT_START pfnConnectStart
; ///< Start the connection to a remote system
944 PFN_API_IS_CONFIGURED pfnIsConfigured
; ///< Determine if the socket is configured
945 PFN_API_LOCAL_ADDR_GET pfnLocalAddrGet
; ///< Get the local address
946 PFN_API_LOCAL_ADDR_SET pfnLocalAddrSet
; ///< Set the local address
947 PFN_API_LISTEN pfnListen
; ///< Listen for connections on known server port
948 PFN_API_OPTION_GET pfnOptionGet
; ///< Get the option value
949 PFN_API_OPTION_SET pfnOptionSet
; ///< Set the option value
950 PFN_API_PACKET_FREE pfnPacketFree
; ///< Free the receive packet
951 PFN_API_PORT_ALLOC pfnPortAllocate
; ///< Allocate the network specific resources for the port
952 PFN_API_PORT_CLOSE pfnPortClose
; ///< Close the network specific resources for the port
953 PFN_API_PORT_CLOSE_OP pfnPortCloseOp
; ///< Perform the close operation on the port
954 BOOLEAN bPortCloseComplete
; ///< TRUE = Close is complete after close operation
955 PFN_API_RECEIVE pfnReceive
; ///< Attempt to receive some data
956 PFN_API_REMOTE_ADDR_GET pfnRemoteAddrGet
; ///< Get remote address
957 PFN_API_REMOTE_ADDR_SET pfnRemoteAddrSet
; ///< Set the remote system address
958 PFN_API_IO_COMPLETE pfnRxComplete
; ///< RX completion
959 PFN_API_RX_START pfnRxStart
; ///< Start a network specific receive operation
960 PFN_API_TRANSMIT pfnTransmit
; ///< Attempt to buffer a packet for transmit
961 PFN_API_TX_COMPLETE pfnTxComplete
; ///< TX completion for normal data
962 PFN_API_TX_COMPLETE pfnTxOobComplete
; ///< TX completion for urgent data
967 Socket control structure
969 The driver uses this structure to manage the socket.
971 typedef struct _ESL_SOCKET
{
972 UINTN Signature
; ///< Structure identification
977 EFI_SOCKET_PROTOCOL SocketProtocol
; ///< Socket protocol declaration
978 CONST ESL_PROTOCOL_API
* pApi
; ///< API for the protocol
983 ESL_SOCKET
* pNext
; ///< Next socket in the list of sockets
984 int errno
; ///< Error information for this socket
985 EFI_STATUS Status
; ///< Asyncronous error information for this socket
986 SOCKET_STATE State
; ///< Socket state
987 UINT32 DebugFlags
; ///< Debug flags
992 BOOLEAN bListenCalled
; ///< TRUE if listen was successfully called
993 BOOLEAN bOobInLine
; ///< TRUE if out-of-band messages are to be received inline with normal data
994 BOOLEAN bIncludeHeader
; ///< TRUE if including the IP header
999 int Domain
; ///< Specifies family of protocols
1000 int Type
; ///< Specifies how to make network connection
1001 int Protocol
; ///< Specifies lower layer protocol to use
1002 BOOLEAN bConfigured
; ///< Set after the socket is configured
1004 BOOLEAN bRxDisable
; ///< Receive disabled via shutdown
1005 size_t RxBytes
; ///< Total Rx bytes
1006 size_t RxOobBytes
; ///< Urgent Rx bytes
1007 EFI_STATUS RxError
; ///< Error during receive
1009 BOOLEAN bTxDisable
; ///< Transmit disabled via shutdown
1010 size_t TxBytes
; ///< Normal Tx bytes
1011 size_t TxOobBytes
; ///< Urgent Tx bytes
1012 EFI_STATUS TxError
; ///< Error during transmit
1015 // Pending connection data
1017 BOOLEAN bConnected
; ///< Set when connected, cleared by poll
1018 EFI_STATUS ConnectStatus
; ///< Connection status
1019 UINTN MaxFifoDepth
; ///< Maximum FIFO depth
1020 UINTN FifoDepth
; ///< Number of sockets in the FIFO
1021 ESL_SOCKET
* pFifoHead
; ///< Head of the FIFO
1022 ESL_SOCKET
* pFifoTail
; ///< Tail of the FIFO
1023 ESL_SOCKET
* pNextConnection
; ///< Link in the FIFO
1028 ESL_PORT
* pPortList
; ///< List of ports managed by this socket
1029 EFI_EVENT WaitAccept
; ///< Wait for accept completion
1032 // Receive data management
1034 UINT32 MaxRxBuf
; ///< Maximum size of the receive buffer
1035 struct timeval RxTimeout
; ///< Receive timeout
1036 ESL_PACKET
* pRxFree
; ///< Free packet list
1037 ESL_PACKET
* pRxOobPacketListHead
;///< Urgent data list head
1038 ESL_PACKET
* pRxOobPacketListTail
;///< Urgent data list tail
1039 ESL_PACKET
* pRxPacketListHead
; ///< Normal data list head
1040 ESL_PACKET
* pRxPacketListTail
; ///< Normal data list tail
1043 // Transmit data management
1045 UINTN TxPacketOffset
; ///< Offset for data pointer in ::ESL_PACKET
1046 UINTN TxTokenEventOffset
; ///< Offset to the Event in the TX token
1047 UINTN TxTokenOffset
; ///< Offset for data pointer in TX token
1048 UINT32 MaxTxBuf
; ///< Maximum size of the transmit buffer
1049 ESL_PACKET
* pTxOobPacketListHead
;///< Urgent data list head
1050 ESL_PACKET
* pTxOobPacketListTail
;///< Urgent data list tail
1051 ESL_PACKET
* pTxPacketListHead
; ///< Normal data list head
1052 ESL_PACKET
* pTxPacketListTail
; ///< Normal data list tail
1055 #define SOCKET_FROM_PROTOCOL(a) CR (a, ESL_SOCKET, SocketProtocol, SOCKET_SIGNATURE) ///< Locate ESL_SOCKET from protocol
1058 Socket layer control structure
1060 The driver uses this structure to manage the driver.
1063 UINTN Signature
; ///< Structure identification
1066 // Service binding interface
1068 CONST EFI_SERVICE_BINDING_PROTOCOL
* pServiceBinding
; ///< Driver's binding
1073 EFI_HANDLE ImageHandle
; ///< Image handle
1078 ESL_SERVICE
* pIp4List
; ///< List of Ip4 services
1079 ESL_SERVICE
* pTcp4List
; ///< List of Tcp4 services
1080 ESL_SERVICE
* pTcp6List
; ///< List of Tcp6 services
1081 ESL_SERVICE
* pUdp4List
; ///< List of Udp4 services
1082 ESL_SERVICE
* pUdp6List
; ///< List of Udp6 services
1085 // Socket management
1087 ESL_SOCKET
* pSocketList
; ///< List of sockets
1090 #define LAYER_FROM_SERVICE(a) CR (a, ESL_LAYER, ServiceBinding, LAYER_SIGNATURE) ///< Locate ESL_LAYER from service binding
1092 //------------------------------------------------------------------------------
1094 //------------------------------------------------------------------------------
1096 extern ESL_LAYER mEslLayer
;
1098 extern CONST ESL_PROTOCOL_API cEslIp4Api
;
1099 extern CONST ESL_PROTOCOL_API cEslIp6Api
;
1100 extern CONST ESL_PROTOCOL_API cEslTcp4Api
;
1101 extern CONST ESL_PROTOCOL_API cEslTcp6Api
;
1102 extern CONST ESL_PROTOCOL_API cEslUdp4Api
;
1103 extern CONST ESL_PROTOCOL_API cEslUdp6Api
;
1105 extern CONST EFI_SERVICE_BINDING_PROTOCOL mEfiServiceBinding
;
1107 //------------------------------------------------------------------------------
1108 // Socket Support Routines
1109 //------------------------------------------------------------------------------
1112 Allocate and initialize a ESL_SOCKET structure.
1114 This support function allocates an ::ESL_SOCKET structure
1115 and installs a protocol on ChildHandle. If pChildHandle is a
1116 pointer to NULL, then a new handle is created and returned in
1117 pChildHandle. If pChildHandle is not a pointer to NULL, then
1118 the protocol installs on the existing pChildHandle.
1120 @param [in, out] pChildHandle Pointer to the handle of the child to create.
1121 If it is NULL, then a new handle is created.
1122 If it is a pointer to an existing UEFI handle,
1123 then the protocol is added to the existing UEFI
1125 @param [in] DebugFlags Flags for debug messages
1126 @param [in, out] ppSocket The buffer to receive an ::ESL_SOCKET structure address.
1128 @retval EFI_SUCCESS The protocol was added to ChildHandle.
1129 @retval EFI_INVALID_PARAMETER ChildHandle is NULL.
1130 @retval EFI_OUT_OF_RESOURCES There are not enough resources available to create
1132 @retval other The child handle was not created
1138 IN OUT EFI_HANDLE
* pChildHandle
,
1139 IN UINTN DebugFlags
,
1140 IN OUT ESL_SOCKET
** ppSocket
1144 Test the bind configuration.
1146 @param [in] pPort Address of the ::ESL_PORT structure.
1147 @param [in] ErrnoValue errno value if test fails
1149 @retval EFI_SUCCESS The connection was successfully established.
1150 @retval Others The connection attempt failed.
1155 IN ESL_PORT
* pPort
,
1160 Copy a fragmented buffer into a destination buffer.
1162 This support routine copies a fragmented buffer to the caller specified buffer.
1164 This routine is called by ::EslIp4Receive and ::EslUdp4Receive.
1166 @param [in] FragmentCount Number of fragments in the table
1168 @param [in] pFragmentTable Address of an EFI_IP4_FRAGMENT_DATA structure
1170 @param [in] BufferLength Length of the the buffer
1172 @param [in] pBuffer Address of a buffer to receive the data.
1174 @param [in] pDataLength Number of received data bytes in the buffer.
1176 @return Returns the address of the next free byte in the buffer.
1180 EslSocketCopyFragmentedBuffer (
1181 IN UINT32 FragmentCount
,
1182 IN EFI_IP4_FRAGMENT_DATA
* pFragmentTable
,
1183 IN
size_t BufferLength
,
1185 OUT
size_t * pDataLength
1189 Free the ESL_IO_MGMT event and structure
1191 This support routine walks the free list to close the event in
1192 the ESL_IO_MGMT structure and remove the structure from the free
1195 See the \ref TransmitEngine section.
1197 @param [in] pPort Address of an ::ESL_PORT structure
1198 @param [in] ppFreeQueue Address of the free queue head
1199 @param [in] DebugFlags Flags for debug messages
1200 @param [in] pEventName Zero terminated string containing the event name
1202 @retval EFI_SUCCESS - The structures were properly initialized
1207 IN ESL_PORT
* pPort
,
1208 IN ESL_IO_MGMT
** ppFreeQueue
,
1209 IN UINTN DebugFlags
,
1210 IN CHAR8
* pEventName
1214 Initialize the ESL_IO_MGMT structures
1216 This support routine initializes the ESL_IO_MGMT structure and
1217 places them on to a free list.
1219 This routine is called by the PortAllocate routines to prepare
1220 the transmit engines. See the \ref TransmitEngine section.
1222 @param [in] pPort Address of an ::ESL_PORT structure
1223 @param [in, out] ppIo Address containing the first structure address. Upon
1224 return this buffer contains the next structure address.
1225 @param [in] TokenCount Number of structures to initialize
1226 @param [in] ppFreeQueue Address of the free queue head
1227 @param [in] DebugFlags Flags for debug messages
1228 @param [in] pEventName Zero terminated string containing the event name
1229 @param [in] pfnCompletion Completion routine address
1231 @retval EFI_SUCCESS - The structures were properly initialized
1236 IN ESL_PORT
* pPort
,
1237 IN ESL_IO_MGMT
** ppIo
,
1238 IN UINTN TokenCount
,
1239 IN ESL_IO_MGMT
** ppFreeQueue
,
1240 IN UINTN DebugFlags
,
1241 IN CHAR8
* pEventName
,
1242 IN PFN_API_IO_COMPLETE pfnCompletion
1246 Determine if the socket is configured
1248 This support routine is called to determine if the socket if the
1249 configuration call was made to the network layer. The following
1250 routines call this routine to verify that they may be successful
1251 in their operations:
1253 <li>::EslSocketGetLocalAddress</li>
1254 <li>::EslSocketGetPeerAddress</li>
1255 <li>::EslSocketPoll</li>
1256 <li>::EslSocketReceive</li>
1257 <li>::EslSocketTransmit</li>
1260 @param [in] pSocket Address of an ::ESL_SOCKET structure
1262 @retval EFI_SUCCESS - The socket is configured
1266 EslSocketIsConfigured (
1267 IN ESL_SOCKET
* pSocket
1271 Allocate a packet for a receive or transmit operation
1273 This support routine is called by ::EslSocketRxStart and the
1274 network specific TxBuffer routines to get buffer space for the
1277 @param [in] ppPacket Address to receive the ::ESL_PACKET structure
1278 @param [in] LengthInBytes Length of the packet structure
1279 @param [in] ZeroBytes Length of packet to zero
1280 @param [in] DebugFlags Flags for debug messages
1282 @retval EFI_SUCCESS - The packet was allocated successfully
1286 EslSocketPacketAllocate (
1287 IN ESL_PACKET
** ppPacket
,
1288 IN
size_t LengthInBytes
,
1289 IN
size_t ZeroBytes
,
1294 Free a packet used for receive or transmit operation
1296 This support routine is called by the network specific Close
1297 and TxComplete routines and during error cases in RxComplete
1298 and TxBuffer. Note that the network layers typically place
1299 receive packets on the ESL_SOCKET::pRxFree list for reuse.
1301 @param [in] pPacket Address of an ::ESL_PACKET structure
1302 @param [in] DebugFlags Flags for debug messages
1304 @retval EFI_SUCCESS - The packet was allocated successfully
1308 EslSocketPacketFree (
1309 IN ESL_PACKET
* pPacket
,
1314 Allocate and initialize a ESL_PORT structure.
1316 This routine initializes an ::ESL_PORT structure for use by
1317 the socket. This routine calls a routine via
1318 ESL_PROTOCOL_API::pfnPortAllocate to initialize the network
1319 specific resources. The resources are released later by the
1320 \ref PortCloseStateMachine.
1322 This support routine is called by ::EslSocketBind and
1323 ::EslTcp4ListenComplete to connect the socket with the
1324 underlying network adapter to the socket.
1326 @param [in] pSocket Address of an ::ESL_SOCKET structure.
1327 @param [in] pService Address of an ::ESL_SERVICE structure.
1328 @param [in] ChildHandle TCP4 child handle
1329 @param [in] pSockAddr Address of a sockaddr structure that contains the
1330 connection point on the local machine. An IPv4 address
1331 of INADDR_ANY specifies that the connection is made to
1332 all of the network stacks on the platform. Specifying a
1333 specific IPv4 address restricts the connection to the
1334 network stack supporting that address. Specifying zero
1335 for the port causes the network layer to assign a port
1336 number from the dynamic range. Specifying a specific
1337 port number causes the network layer to use that port.
1338 @param [in] bBindTest TRUE if EslSocketBindTest should be called
1339 @param [in] DebugFlags Flags for debug messages
1340 @param [out] ppPort Buffer to receive new ::ESL_PORT structure address
1342 @retval EFI_SUCCESS - Socket successfully created
1346 EslSocketPortAllocate (
1347 IN ESL_SOCKET
* pSocket
,
1348 IN ESL_SERVICE
* pService
,
1349 IN EFI_HANDLE ChildHandle
,
1350 IN CONST
struct sockaddr
* pSockAddr
,
1351 IN BOOLEAN bBindTest
,
1352 IN UINTN DebugFlags
,
1353 OUT ESL_PORT
** ppPort
1359 This routine releases the resources allocated by ::EslSocketPortAllocate.
1360 This routine calls ESL_PROTOCOL_API::pfnPortClose to release the network
1363 This routine is called by:
1365 <li>::EslIp4PortAllocate - Port initialization failure</li>
1366 <li>::EslSocketPortCloseRxDone - Last step of close processing</li>
1367 <li>::EslTcp4ConnectComplete - Connection failure and reducint the port list to a single port</li>
1368 <li>::EslTcp4PortAllocate - Port initialization failure</li>
1369 <li>::EslUdp4PortAllocate - Port initialization failure</li>
1371 See the \ref PortCloseStateMachine section.
1373 @param [in] pPort Address of an ::ESL_PORT structure.
1375 @retval EFI_SUCCESS The port is closed
1376 @retval other Port close error
1380 EslSocketPortClose (
1385 Process the port close completion event
1387 This routine attempts to complete the port close operation.
1389 This routine is called by the TCP layer upon completion of
1390 the close operation.
1391 See the \ref PortCloseStateMachine section.
1393 @param [in] Event The close completion event
1395 @param [in] pPort Address of an ::ESL_PORT structure.
1399 EslSocketPortCloseComplete (
1407 This routine determines the state of the receive operations and
1408 continues the close operation after the pending receive operations
1411 This routine is called by
1413 <li>::EslIp4RxComplete</li>
1414 <li>::EslSocketPortCloseComplete</li>
1415 <li>::EslSocketPortCloseTxDone</li>
1416 <li>::EslUdp4RxComplete</li>
1418 to determine the state of the receive operations.
1419 See the \ref PortCloseStateMachine section.
1421 @param [in] pPort Address of an ::ESL_PORT structure.
1423 @retval EFI_SUCCESS The port is closed
1424 @retval EFI_NOT_READY The port is still closing
1425 @retval EFI_ALREADY_STARTED Error, the port is in the wrong state,
1426 most likely the routine was called already.
1430 EslSocketPortCloseRxDone (
1435 Start the close operation on a port, state 1.
1437 This routine marks the port as closed and initiates the \ref
1438 PortCloseStateMachine. The first step is to allow the \ref
1439 TransmitEngine to run down.
1441 This routine is called by ::EslSocketCloseStart to initiate the socket
1442 network specific close operation on the socket.
1444 @param [in] pPort Address of an ::ESL_PORT structure.
1445 @param [in] bCloseNow Set TRUE to abort active transfers
1446 @param [in] DebugFlags Flags for debug messages
1448 @retval EFI_SUCCESS The port is closed, not normally returned
1449 @retval EFI_NOT_READY The port has started the closing process
1450 @retval EFI_ALREADY_STARTED Error, the port is in the wrong state,
1451 most likely the routine was called already.
1455 EslSocketPortCloseStart (
1456 IN ESL_PORT
* pPort
,
1457 IN BOOLEAN bCloseNow
,
1464 This routine determines the state of the transmit engine and
1465 continue the close operation after the transmission is complete.
1466 The next step is to stop the \ref ReceiveEngine.
1467 See the \ref PortCloseStateMachine section.
1469 This routine is called by ::EslSocketPortCloseStart to determine
1470 if the transmission is complete.
1472 @param [in] pPort Address of an ::ESL_PORT structure.
1474 @retval EFI_SUCCESS The port is closed, not normally returned
1475 @retval EFI_NOT_READY The port is still closing
1476 @retval EFI_ALREADY_STARTED Error, the port is in the wrong state,
1477 most likely the routine was called already.
1481 EslSocketPortCloseTxDone (
1486 Cancel the receive operations
1488 This routine cancels a pending receive operation.
1489 See the \ref ReceiveEngine section.
1491 This routine is called by ::EslSocketShutdown when the socket
1492 layer is being shutdown.
1494 @param [in] pPort Address of an ::ESL_PORT structure
1495 @param [in] pIo Address of an ::ESL_IO_MGMT structure
1500 IN ESL_PORT
* pPort
,
1501 IN ESL_IO_MGMT
* pIo
1505 Process the receive completion
1507 This routine queues the data in FIFO order in either the urgent
1508 or normal data queues depending upon the type of data received.
1509 See the \ref ReceiveEngine section.
1511 This routine is called when some data is received by:
1513 <li>::EslIp4RxComplete</li>
1514 <li>::EslTcp4RxComplete</li>
1515 <li>::EslUdp4RxComplete</li>
1518 @param [in] pIo Address of an ::ESL_IO_MGMT structure
1519 @param [in] Status Receive status
1520 @param [in] LengthInBytes Length of the receive data
1521 @param [in] bUrgent TRUE if urgent data is received and FALSE
1526 EslSocketRxComplete (
1527 IN ESL_IO_MGMT
* pIo
,
1528 IN EFI_STATUS Status
,
1529 IN UINTN LengthInBytes
,
1534 Poll a socket for pending receive activity.
1536 This routine is called at elivated TPL and extends the idle
1537 loop which polls a socket down into the LAN driver layer to
1538 determine if there is any receive activity.
1540 The ::EslSocketPoll, ::EslSocketReceive and ::EslSocketTransmit
1541 routines call this routine when there is nothing to do.
1543 @param [in] pSocket Address of an ::EFI_SOCKET structure.
1548 IN ESL_SOCKET
* pSocket
1552 Start a receive operation
1554 This routine posts a receive buffer to the network adapter.
1555 See the \ref ReceiveEngine section.
1557 This support routine is called by:
1559 <li>::EslIp4Receive to restart the receive engine to release flow control.</li>
1560 <li>::EslIp4RxComplete to continue the operation of the receive engine if flow control is not being applied.</li>
1561 <li>::EslIp4SocketIsConfigured to start the recevie engine for the new socket.</li>
1562 <li>::EslTcp4ListenComplete to start the recevie engine for the new socket.</li>
1563 <li>::EslTcp4Receive to restart the receive engine to release flow control.</li>
1564 <li>::EslTcp4RxComplete to continue the operation of the receive engine if flow control is not being applied.</li>
1565 <li>::EslUdp4Receive to restart the receive engine to release flow control.</li>
1566 <li>::EslUdp4RxComplete to continue the operation of the receive engine if flow control is not being applied.</li>
1567 <li>::EslUdp4SocketIsConfigured to start the recevie engine for the new socket.</li>
1570 @param [in] pPort Address of an ::ESL_PORT structure.
1579 Complete the transmit operation
1581 This support routine handles the transmit completion processing for
1582 the various network layers. It frees the ::ESL_IO_MGMT structure
1583 and and frees packet resources by calling ::EslSocketPacketFree.
1584 Transmit errors are logged in ESL_SOCKET::TxError.
1585 See the \ref TransmitEngine section.
1587 This routine is called by:
1589 <li>::EslIp4TxComplete</li>
1590 <li>::EslTcp4TxComplete</li>
1591 <li>::EslTcp4TxOobComplete</li>
1592 <li>::EslUdp4TxComplete</li>
1595 @param [in] pIo Address of an ::ESL_IO_MGMT structure
1596 @param [in] LengthInBytes Length of the data in bytes
1597 @param [in] Status Transmit operation status
1598 @param [in] pQueueType Zero terminated string describing queue type
1599 @param [in] ppQueueHead Transmit queue head address
1600 @param [in] ppQueueTail Transmit queue tail address
1601 @param [in] ppActive Active transmit queue address
1602 @param [in] ppFree Free transmit queue address
1606 EslSocketTxComplete (
1607 IN ESL_IO_MGMT
* pIo
,
1608 IN UINT32 LengthInBytes
,
1609 IN EFI_STATUS Status
,
1610 IN CONST CHAR8
* pQueueType
,
1611 IN ESL_PACKET
** ppQueueHead
,
1612 IN ESL_PACKET
** ppQueueTail
,
1613 IN ESL_IO_MGMT
** ppActive
,
1614 IN ESL_IO_MGMT
** ppFree
1618 Transmit data using a network connection.
1620 This support routine starts a transmit operation on the
1621 underlying network layer.
1623 The network specific code calls this routine to start a
1624 transmit operation. See the \ref TransmitEngine section.
1626 @param [in] pPort Address of an ::ESL_PORT structure
1627 @param [in] ppQueueHead Transmit queue head address
1628 @param [in] ppQueueTail Transmit queue tail address
1629 @param [in] ppActive Active transmit queue address
1630 @param [in] ppFree Free transmit queue address
1635 IN ESL_PORT
* pPort
,
1636 IN ESL_PACKET
** ppQueueHead
,
1637 IN ESL_PACKET
** ppQueueTail
,
1638 IN ESL_IO_MGMT
** ppActive
,
1639 IN ESL_IO_MGMT
** ppFree
1642 //------------------------------------------------------------------------------
1644 #endif // _SOCKET_H_