3 Copyright (c) 2005 - 2006, Intel Corporation
4 All rights reserved. This program and the accompanying materials
5 are licensed and made available under the terms and conditions of the BSD License
6 which accompanies this distribution. The full text of the license may be found at
7 http://opensource.org/licenses/bsd-license.php
9 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
10 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
18 Misc support routines for tcp.
26 #include <Library/DevicePathLib.h>
28 NET_LIST_ENTRY mTcpRunQue
= {
33 NET_LIST_ENTRY mTcpListenQue
= {
38 TCP_SEQNO mTcpGlobalIss
= 0x4d7e980b;
40 CHAR16
*mTcpStateName
[] = {
56 Initialize the Tcb local related members.
58 @param Tcb Pointer to the TCP_CB of this TCP instance.
69 // Compute the checksum of the fixed parts of pseudo header
71 Tcb
->HeadSum
= NetPseudoHeadChecksum (
78 Tcb
->Iss
= TcpGetIss ();
79 Tcb
->SndUna
= Tcb
->Iss
;
80 Tcb
->SndNxt
= Tcb
->Iss
;
82 Tcb
->SndWl2
= Tcb
->Iss
;
85 Tcb
->RcvWnd
= GET_RCV_BUFFSIZE (Tcb
->Sk
);
88 // Fisrt window size is never scaled
95 Initialize the peer related members.
97 @param Tcb Pointer to the TCP_CB of this TCP instance.
98 @param Seg Pointer to the segment that contains the peer's
100 @param Opt Pointer to the options announced by the peer.
114 ASSERT (Tcb
&& Seg
&& Opt
);
115 ASSERT (TCP_FLG_ON (Seg
->Flag
, TCP_FLG_SYN
));
117 Tcb
->SndWnd
= Seg
->Wnd
;
118 Tcb
->SndWndMax
= Tcb
->SndWnd
;
119 Tcb
->SndWl1
= Seg
->Seq
;
121 if (TCP_FLG_ON (Seg
->Flag
, TCP_FLG_ACK
)) {
122 Tcb
->SndWl2
= Seg
->Ack
;
124 Tcb
->SndWl2
= Tcb
->Iss
+ 1;
127 if (TCP_FLG_ON (Opt
->Flag
, TCP_OPTION_RCVD_MSS
)) {
128 Tcb
->SndMss
= (UINT16
) MAX (64, Opt
->Mss
);
130 RcvMss
= TcpGetRcvMss (Tcb
->Sk
);
131 if (Tcb
->SndMss
> RcvMss
) {
132 Tcb
->SndMss
= RcvMss
;
137 // One end doesn't support MSS option, use default.
142 Tcb
->CWnd
= Tcb
->SndMss
;
145 Tcb
->RcvNxt
= Tcb
->Irs
+ 1;
147 Tcb
->RcvWl2
= Tcb
->RcvNxt
;
149 if (TCP_FLG_ON (Opt
->Flag
, TCP_OPTION_RCVD_WS
) &&
150 !TCP_FLG_ON (Tcb
->CtrlFlag
, TCP_CTRL_NO_WS
)) {
152 Tcb
->SndWndScale
= Opt
->WndScale
;
154 Tcb
->RcvWndScale
= TcpComputeScale (Tcb
);
155 TCP_SET_FLG (Tcb
->CtrlFlag
, TCP_CTRL_RCVD_WS
);
159 // One end doesn't support window scale option. use zero.
161 Tcb
->RcvWndScale
= 0;
164 if (TCP_FLG_ON (Opt
->Flag
, TCP_OPTION_RCVD_TS
) &&
165 !TCP_FLG_ON (Tcb
->CtrlFlag
, TCP_CTRL_NO_TS
)) {
167 TCP_SET_FLG (Tcb
->CtrlFlag
, TCP_CTRL_SND_TS
);
168 TCP_SET_FLG (Tcb
->CtrlFlag
, TCP_CTRL_RCVD_TS
);
171 // Compute the effective SndMss per RFC1122
172 // section 4.2.2.6. If timestamp option is
173 // enabled, it will always occupy 12 bytes.
175 Tcb
->SndMss
-= TCP_OPTION_TS_ALIGNED_LEN
;
181 Locate a listen TCB that matchs the Local and Remote.
183 @param Local Pointer to the local (IP, Port).
184 @param Remote Pointer to the remote (IP, Port).
186 @return Pointer to the TCP_CB with the least number of wildcard, if NULL no match is found.
196 NET_LIST_ENTRY
*Entry
;
205 NET_LIST_FOR_EACH (Entry
, &mTcpListenQue
) {
206 Node
= NET_LIST_USER_STRUCT (Entry
, TCP_CB
, List
);
208 if ((Local
->Port
!= Node
->LocalEnd
.Port
) ||
209 !TCP_PEER_MATCH (Remote
, &Node
->RemoteEnd
) ||
210 !TCP_PEER_MATCH (Local
, &Node
->LocalEnd
)
217 // Compute the number of wildcard
220 if (Node
->RemoteEnd
.Ip
== 0) {
224 if (Node
->RemoteEnd
.Port
== 0) {
228 if (Node
->LocalEnd
.Ip
== 0) {
247 Try to find one Tcb whose <Ip, Port> equals to <IN Addr, IN Port>.
249 @param Addr Pointer to the IP address needs to match.
250 @param Port The port number needs to match.
252 @return The Tcb which matches the <Addr Port> paire exists or not.
257 IN EFI_IPv4_ADDRESS
*Addr
,
261 TCP_PORTNO LocalPort
;
262 NET_LIST_ENTRY
*Entry
;
265 ASSERT ((Addr
!= NULL
) && (Port
!= 0));
267 LocalPort
= HTONS (Port
);
269 NET_LIST_FOR_EACH (Entry
, &mTcpListenQue
) {
270 Tcb
= NET_LIST_USER_STRUCT (Entry
, TCP_CB
, List
);
272 if (EFI_IP4_EQUAL (Addr
, &Tcb
->LocalEnd
.Ip
) &&
273 (LocalPort
== Tcb
->LocalEnd
.Port
)) {
279 NET_LIST_FOR_EACH (Entry
, &mTcpRunQue
) {
280 Tcb
= NET_LIST_USER_STRUCT (Entry
, TCP_CB
, List
);
282 if (EFI_IP4_EQUAL (Addr
, &Tcb
->LocalEnd
.Ip
) &&
283 (LocalPort
== Tcb
->LocalEnd
.Port
)) {
294 Locate the TCP_CB related to the socket pair.
296 @param LocalPort The local port number.
297 @param LocalIp The local IP address.
298 @param RemotePort The remote port number.
299 @param RemoteIp The remote IP address.
300 @param Syn Whether to search the listen sockets, if TRUE, the
301 listen sockets are searched.
303 @return Pointer to the related TCP_CB, if NULL no match is found.
308 IN TCP_PORTNO LocalPort
,
310 IN TCP_PORTNO RemotePort
,
317 NET_LIST_ENTRY
*Entry
;
320 Local
.Port
= LocalPort
;
323 Remote
.Port
= RemotePort
;
324 Remote
.Ip
= RemoteIp
;
327 // First check for exact match.
329 NET_LIST_FOR_EACH (Entry
, &mTcpRunQue
) {
330 Tcb
= NET_LIST_USER_STRUCT (Entry
, TCP_CB
, List
);
332 if (TCP_PEER_EQUAL (&Remote
, &Tcb
->RemoteEnd
) &&
333 TCP_PEER_EQUAL (&Local
, &Tcb
->LocalEnd
)) {
335 NetListRemoveEntry (&Tcb
->List
);
336 NetListInsertHead (&mTcpRunQue
, &Tcb
->List
);
343 // Only check listen queue when SYN flag is on
346 return TcpLocateListenTcb (&Local
, &Remote
);
354 Insert a Tcb into the proper queue.
356 @param Tcb Pointer to the TCP_CB to be inserted.
358 @retval 0 The Tcb is inserted successfully.
359 @retval -1 Error condition occurred.
367 NET_LIST_ENTRY
*Entry
;
368 NET_LIST_ENTRY
*Head
;
370 TCP4_PROTO_DATA
*TcpProto
;
375 (Tcb
->State
== TCP_LISTEN
) ||
376 (Tcb
->State
== TCP_SYN_SENT
) ||
377 (Tcb
->State
== TCP_SYN_RCVD
) ||
378 (Tcb
->State
== TCP_CLOSED
)
382 if (Tcb
->LocalEnd
.Port
== 0) {
388 if (Tcb
->State
== TCP_LISTEN
) {
389 Head
= &mTcpListenQue
;
393 // Check that Tcb isn't already on the list.
395 NET_LIST_FOR_EACH (Entry
, Head
) {
396 Node
= NET_LIST_USER_STRUCT (Entry
, TCP_CB
, List
);
398 if (TCP_PEER_EQUAL (&Tcb
->LocalEnd
, &Node
->LocalEnd
) &&
399 TCP_PEER_EQUAL (&Tcb
->RemoteEnd
, &Node
->RemoteEnd
)) {
405 NetListInsertHead (Head
, &Tcb
->List
);
407 TcpProto
= (TCP4_PROTO_DATA
*) Tcb
->Sk
->ProtoReserved
;
408 TcpSetVariableData (TcpProto
->TcpService
);
415 Clone a TCP_CB from Tcb.
417 @param Tcb Pointer to the TCP_CB to be cloned.
419 @return Pointer to the new cloned TCP_CB, if NULL error condition occurred.
428 TCP4_SERVICE_DATA
*TcpService
;
429 EFI_IP4_PROTOCOL
*Ip4
;
431 Clone
= NetAllocatePool (sizeof (TCP_CB
));
438 NetCopyMem (Clone
, Tcb
, sizeof (TCP_CB
));
441 // Increate the reference count of the shared IpInfo.
443 NET_GET_REF (Tcb
->IpInfo
);
445 NetListInit (&Clone
->List
);
446 NetListInit (&Clone
->SndQue
);
447 NetListInit (&Clone
->RcvQue
);
449 Clone
->Sk
= SockClone (Tcb
->Sk
);
450 if (Clone
->Sk
== NULL
) {
451 TCP4_DEBUG_ERROR (("TcpCloneTcb: failed to clone a sock\n"));
456 ((TCP4_PROTO_DATA
*) (Clone
->Sk
->ProtoReserved
))->TcpPcb
= Clone
;
458 TcpService
= ((TCP4_PROTO_DATA
*) (Clone
->Sk
->ProtoReserved
))->TcpService
;
460 NetListInsertTail (&TcpService
->SocketList
, &Clone
->Sk
->Link
);
463 // Open the device path on the handle where service binding resides on.
466 TcpService
->ControllerHandle
,
467 &gEfiDevicePathProtocolGuid
,
468 (VOID
**) &Clone
->Sk
->ParentDevicePath
,
469 TcpService
->DriverBindingHandle
,
470 Clone
->Sk
->SockHandle
,
471 EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER
475 // Open the ip protocol by child controller.
478 TcpService
->IpIo
->ChildHandle
,
479 &gEfiIp4ProtocolGuid
,
481 TcpService
->DriverBindingHandle
,
482 Clone
->Sk
->SockHandle
,
483 EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER
491 Compute an ISS to be used by a new connection.
495 @return The result ISS.
503 mTcpGlobalIss
+= 2048;
504 return mTcpGlobalIss
;
513 @return The mss size.
521 EFI_SIMPLE_NETWORK_MODE SnpMode
;
522 TCP4_PROTO_DATA
*TcpProto
;
523 EFI_IP4_PROTOCOL
*Ip
;
527 TcpProto
= (TCP4_PROTO_DATA
*) Sock
->ProtoReserved
;
528 Ip
= TcpProto
->TcpService
->IpIo
->Ip
;
531 Ip
->GetModeData (Ip
, NULL
, NULL
, &SnpMode
);
533 return (UINT16
) (SnpMode
.MaxPacketSize
- 40);
540 @param Tcb Pointer to the TCP_CB of this TCP instance.
541 @param State The state to be set.
553 ("Tcb (%x) state %s --> %s\n",
555 mTcpStateName
[Tcb
->State
],
556 mTcpStateName
[State
])
562 case TCP_ESTABLISHED
:
564 SockConnEstablished (Tcb
->Sk
);
566 if (Tcb
->Parent
!= NULL
) {
568 // A new connection is accepted by a listening socket, install
571 TcpInstallDevicePath (Tcb
->Sk
);
578 SockConnClosed (Tcb
->Sk
);
586 Compute the TCP segment's checksum.
588 @param Nbuf Pointer to the buffer that contains the TCP
590 @param HeadSum The checksum value of the fixed part of pseudo
593 @return The checksum value.
604 Checksum
= NetbufChecksum (Nbuf
);
605 Checksum
= NetAddChecksum (Checksum
, HeadSum
);
607 Checksum
= NetAddChecksum (
609 HTONS ((UINT16
) Nbuf
->TotalSize
)
612 return (UINT16
) ~Checksum
;
617 Translate the information from the head of the received TCP
618 segment Nbuf contains and fill it into a TCP_SEG structure.
620 @param Tcb Pointer to the TCP_CB of this TCP instance.
621 @param Nbuf Pointer to the buffer contains the TCP segment.
623 @return Pointer to the TCP_SEG that contains the translated TCP head information.
635 Seg
= TCPSEG_NETBUF (Nbuf
);
636 Head
= (TCP_HEAD
*) NetbufGetByte (Nbuf
, 0, NULL
);
639 Seg
->Seq
= NTOHL (Head
->Seq
);
640 Seg
->Ack
= NTOHL (Head
->Ack
);
641 Seg
->End
= Seg
->Seq
+ (Nbuf
->TotalSize
- (Head
->HeadLen
<< 2));
643 Seg
->Urg
= NTOHS (Head
->Urg
);
644 Seg
->Wnd
= (NTOHS (Head
->Wnd
) << Tcb
->SndWndScale
);
645 Seg
->Flag
= Head
->Flag
;
648 // SYN and FIN flag occupy one sequence space each.
650 if (TCP_FLG_ON (Seg
->Flag
, TCP_FLG_SYN
)) {
652 // RFC requires that initial window not be scaled
654 Seg
->Wnd
= NTOHS (Head
->Wnd
);
658 if (TCP_FLG_ON (Seg
->Flag
, TCP_FLG_FIN
)) {
667 Reset the connection related with Tcb.
669 @param Tcb Pointer to the TCP_CB of the connection to be
683 Nbuf
= NetbufAlloc (TCP_MAX_HEAD
);
689 Nhead
= (TCP_HEAD
*) NetbufAllocSpace (
695 ASSERT (Nhead
!= NULL
);
699 Nhead
->Flag
= TCP_FLG_RST
;
700 Nhead
->Seq
= HTONL (Tcb
->SndNxt
);
701 Nhead
->Ack
= HTONL (Tcb
->RcvNxt
);
702 Nhead
->SrcPort
= Tcb
->LocalEnd
.Port
;
703 Nhead
->DstPort
= Tcb
->RemoteEnd
.Port
;
704 Nhead
->HeadLen
= (sizeof (TCP_HEAD
) >> 2);
706 Nhead
->Wnd
= HTONS (0xFFFF);
709 Nhead
->Checksum
= TcpChecksum (Nbuf
, Tcb
->HeadSum
);
711 TcpSendIpPacket (Tcb
, Nbuf
, Tcb
->LocalEnd
.Ip
, Tcb
->RemoteEnd
.Ip
);
718 Initialize an active connection,
720 @param Tcb Pointer to the TCP_CB that wants to initiate a
731 TcpInitTcbLocal (Tcb
);
732 TcpSetState (Tcb
, TCP_SYN_SENT
);
734 TcpSetTimer (Tcb
, TCP_TIMER_CONNECT
, Tcb
->ConnectTimeout
);
735 TcpToSendData (Tcb
, 1);
740 Initiate the connection close procedure, called when
741 applications want to close the connection.
743 @param Tcb Pointer to the TCP_CB of this TCP instance.
755 if (!NetListIsEmpty (&Tcb
->RcvQue
) || GET_RCV_DATASIZE (Tcb
->Sk
)) {
757 TCP4_DEBUG_WARN (("TcpOnAppClose: connection reset "
758 "because data is lost for TCB %x\n", Tcb
));
760 TcpResetConnection (Tcb
);
765 switch (Tcb
->State
) {
769 TcpSetState (Tcb
, TCP_CLOSED
);
773 case TCP_ESTABLISHED
:
774 TcpSetState (Tcb
, TCP_FIN_WAIT_1
);
778 TcpSetState (Tcb
, TCP_LAST_ACK
);
782 TcpToSendData (Tcb
, 1);
787 Check whether the application's newly delivered data
790 @param Tcb Pointer to the TCP_CB of this TCP instance.
792 @retval 0 Whether the data is sent out or is buffered for
794 @retval -1 The Tcb is not in a state that data is permitted to
804 switch (Tcb
->State
) {
818 case TCP_ESTABLISHED
:
820 TcpToSendData (Tcb
, 0);
838 Application has consumed some data, check whether
839 to send a window updata ack or a delayed ack.
841 @param Tcb Pointer to the TCP_CB of this TCP instance.
852 switch (Tcb
->State
) {
866 case TCP_ESTABLISHED
:
867 TcpOld
= TcpRcvWinOld (Tcb
);
868 if (TcpRcvWinNow (Tcb
) > TcpOld
) {
870 if (TcpOld
< Tcb
->RcvMss
) {
872 TCP4_DEBUG_TRACE (("TcpOnAppConsume: send a window"
873 " update for a window closed Tcb(%x)\n", Tcb
));
876 } else if (Tcb
->DelayedAck
== 0) {
878 TCP4_DEBUG_TRACE (("TcpOnAppConsume: scheduled a delayed"
879 " ACK to update window for Tcb(%x)\n", Tcb
));
905 Abort the connection by sending a reset segment, called
906 when the application wants to abort the connection.
908 @param Tcb Pointer to the TCP_CB of the TCP instance.
918 TCP4_DEBUG_WARN (("TcpOnAppAbort: connection reset "
919 "issued by application for TCB %x\n", Tcb
));
921 switch (Tcb
->State
) {
923 case TCP_ESTABLISHED
:
927 TcpResetConnection (Tcb
);
931 TcpSetState (Tcb
, TCP_CLOSED
);
936 Set the Tdp4 variable data.
938 @param Tcp4Service Tcp4 service data.
940 @retval EFI_OUT_OF_RESOURCES There are not enough resources to set the variable.
941 @retval other Set variable failed.
946 IN TCP4_SERVICE_DATA
*Tcp4Service
949 UINT32 NumConfiguredInstance
;
950 NET_LIST_ENTRY
*Entry
;
952 TCP4_PROTO_DATA
*TcpProto
;
953 UINTN VariableDataSize
;
954 EFI_TCP4_VARIABLE_DATA
*Tcp4VariableData
;
955 EFI_TCP4_SERVICE_POINT
*Tcp4ServicePoint
;
956 CHAR16
*NewMacString
;
959 NumConfiguredInstance
= 0;
962 // Go through the running queue to count the instances.
964 NET_LIST_FOR_EACH (Entry
, &mTcpRunQue
) {
965 TcpPcb
= NET_LIST_USER_STRUCT (Entry
, TCP_CB
, List
);
967 TcpProto
= (TCP4_PROTO_DATA
*) TcpPcb
->Sk
->ProtoReserved
;
969 if (TcpProto
->TcpService
== Tcp4Service
) {
971 // This tcp instance belongs to the Tcp4Service.
973 NumConfiguredInstance
++;
978 // Go through the listening queue to count the instances.
980 NET_LIST_FOR_EACH (Entry
, &mTcpListenQue
) {
981 TcpPcb
= NET_LIST_USER_STRUCT (Entry
, TCP_CB
, List
);
983 TcpProto
= (TCP4_PROTO_DATA
*) TcpPcb
->Sk
->ProtoReserved
;
985 if (TcpProto
->TcpService
== Tcp4Service
) {
987 // This tcp instance belongs to the Tcp4Service.
989 NumConfiguredInstance
++;
994 // Calculate the size of the Tcp4VariableData. As there may be no Tcp4 child,
995 // we should add extra buffer for the service points only if the number of configured
996 // children is more than 1.
998 VariableDataSize
= sizeof (EFI_TCP4_VARIABLE_DATA
);
1000 if (NumConfiguredInstance
> 1) {
1001 VariableDataSize
+= sizeof (EFI_TCP4_SERVICE_POINT
) * (NumConfiguredInstance
- 1);
1004 Tcp4VariableData
= NetAllocatePool (VariableDataSize
);
1005 if (Tcp4VariableData
== NULL
) {
1006 return EFI_OUT_OF_RESOURCES
;
1009 Tcp4VariableData
->DriverHandle
= Tcp4Service
->DriverBindingHandle
;
1010 Tcp4VariableData
->ServiceCount
= NumConfiguredInstance
;
1012 Tcp4ServicePoint
= &Tcp4VariableData
->Services
[0];
1015 // Go through the running queue to fill the service points.
1017 NET_LIST_FOR_EACH (Entry
, &mTcpRunQue
) {
1018 TcpPcb
= NET_LIST_USER_STRUCT (Entry
, TCP_CB
, List
);
1020 TcpProto
= (TCP4_PROTO_DATA
*) TcpPcb
->Sk
->ProtoReserved
;
1022 if (TcpProto
->TcpService
== Tcp4Service
) {
1024 // This tcp instance belongs to the Tcp4Service.
1026 Tcp4ServicePoint
->InstanceHandle
= TcpPcb
->Sk
->SockHandle
;
1027 NetCopyMem (&Tcp4ServicePoint
->LocalAddress
, &TcpPcb
->LocalEnd
.Ip
, sizeof (EFI_IPv4_ADDRESS
));
1028 Tcp4ServicePoint
->LocalPort
= NTOHS (TcpPcb
->LocalEnd
.Port
);
1029 NetCopyMem (&Tcp4ServicePoint
->RemoteAddress
, &TcpPcb
->RemoteEnd
.Ip
, sizeof (EFI_IPv4_ADDRESS
));
1030 Tcp4ServicePoint
->RemotePort
= NTOHS (TcpPcb
->RemoteEnd
.Port
);
1037 // Go through the listening queue to fill the service points.
1039 NET_LIST_FOR_EACH (Entry
, &mTcpListenQue
) {
1040 TcpPcb
= NET_LIST_USER_STRUCT (Entry
, TCP_CB
, List
);
1042 TcpProto
= (TCP4_PROTO_DATA
*) TcpPcb
->Sk
->ProtoReserved
;
1044 if (TcpProto
->TcpService
== Tcp4Service
) {
1046 // This tcp instance belongs to the Tcp4Service.
1048 Tcp4ServicePoint
->InstanceHandle
= TcpPcb
->Sk
->SockHandle
;
1049 NetCopyMem (&Tcp4ServicePoint
->LocalAddress
, &TcpPcb
->LocalEnd
.Ip
, sizeof (EFI_IPv4_ADDRESS
));
1050 Tcp4ServicePoint
->LocalPort
= NTOHS (TcpPcb
->LocalEnd
.Port
);
1051 NetCopyMem (&Tcp4ServicePoint
->RemoteAddress
, &TcpPcb
->RemoteEnd
.Ip
, sizeof (EFI_IPv4_ADDRESS
));
1052 Tcp4ServicePoint
->RemotePort
= NTOHS (TcpPcb
->RemoteEnd
.Port
);
1059 // Get the mac string.
1061 Status
= NetLibGetMacString (
1062 Tcp4Service
->ControllerHandle
,
1063 Tcp4Service
->DriverBindingHandle
,
1066 if (EFI_ERROR (Status
)) {
1070 if (Tcp4Service
->MacString
!= NULL
) {
1072 // The variable is set already, we're going to update it.
1074 if (StrCmp (Tcp4Service
->MacString
, NewMacString
) != 0) {
1076 // The mac address is changed, delete the previous variable first.
1079 Tcp4Service
->MacString
,
1080 &gEfiTcp4ServiceBindingProtocolGuid
,
1081 EFI_VARIABLE_BOOTSERVICE_ACCESS
,
1087 NetFreePool (Tcp4Service
->MacString
);
1090 Tcp4Service
->MacString
= NewMacString
;
1092 Status
= gRT
->SetVariable (
1093 Tcp4Service
->MacString
,
1094 &gEfiTcp4ServiceBindingProtocolGuid
,
1095 EFI_VARIABLE_BOOTSERVICE_ACCESS
,
1097 (VOID
*) Tcp4VariableData
1102 NetFreePool (Tcp4VariableData
);
1109 Clear the variable and free the resource.
1111 @param Tcp4Service Tcp4 service data.
1117 TcpClearVariableData (
1118 IN TCP4_SERVICE_DATA
*Tcp4Service
1121 ASSERT (Tcp4Service
->MacString
!= NULL
);
1124 Tcp4Service
->MacString
,
1125 &gEfiTcp4ServiceBindingProtocolGuid
,
1126 EFI_VARIABLE_BOOTSERVICE_ACCESS
,
1131 NetFreePool (Tcp4Service
->MacString
);
1132 Tcp4Service
->MacString
= NULL
;
1136 TcpInstallDevicePath (
1141 Routine Description:
1143 Install the device path protocol on the TCP instance.
1147 Sock - Pointer to the socket representing the TCP instance.
1151 EFI_SUCCESS - The device path protocol is installed.
1152 other - Failed to install the device path protocol.
1156 TCP4_PROTO_DATA
*TcpProto
;
1157 TCP4_SERVICE_DATA
*TcpService
;
1159 IPv4_DEVICE_PATH Ip4DPathNode
;
1162 TcpProto
= (TCP4_PROTO_DATA
*) Sock
->ProtoReserved
;
1163 TcpService
= TcpProto
->TcpService
;
1164 Tcb
= TcpProto
->TcpPcb
;
1166 NetLibCreateIPv4DPathNode (
1168 TcpService
->ControllerHandle
,
1170 NTOHS (Tcb
->LocalEnd
.Port
),
1172 NTOHS (Tcb
->RemoteEnd
.Port
),
1177 Sock
->DevicePath
= AppendDevicePathNode (
1178 Sock
->ParentDevicePath
,
1179 (EFI_DEVICE_PATH_PROTOCOL
*) &Ip4DPathNode
1181 if (Sock
->DevicePath
== NULL
) {
1182 return EFI_OUT_OF_RESOURCES
;
1185 Status
= gBS
->InstallProtocolInterface (
1187 &gEfiDevicePathProtocolGuid
,
1188 EFI_NATIVE_INTERFACE
,
1191 if (EFI_ERROR (Status
)) {
1192 NetFreePool (Sock
->DevicePath
);