2 Miscellaneous routines for HttpDxe driver.
4 Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
5 (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
6 This program and the accompanying materials
7 are licensed and made available under the terms and conditions of the BSD License
8 which accompanies this distribution. The full text of the license may be found at
9 http://opensource.org/licenses/bsd-license.php
11 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
12 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
16 #include "HttpDriver.h"
19 The common notify function used in HTTP driver.
21 @param[in] Event The event signaled.
22 @param[in] Context The context.
32 if ((Event
== NULL
) || (Context
== NULL
)) {
36 *((BOOLEAN
*) Context
) = TRUE
;
40 The notify function associated with Tx4Token for Tcp4->Transmit() or Tx6Token for Tcp6->Transmit().
42 @param[in] Context The context.
47 HttpTcpTransmitNotifyDpc (
51 HTTP_TOKEN_WRAP
*Wrap
;
52 HTTP_PROTOCOL
*HttpInstance
;
54 if (Context
== NULL
) {
58 Wrap
= (HTTP_TOKEN_WRAP
*) Context
;
59 HttpInstance
= Wrap
->HttpInstance
;
61 if (!HttpInstance
->LocalAddressIsIPv6
) {
62 Wrap
->HttpToken
->Status
= Wrap
->TcpWrap
.Tx4Token
.CompletionToken
.Status
;
63 gBS
->SignalEvent (Wrap
->HttpToken
->Event
);
68 if (Wrap
->TcpWrap
.Tx4Token
.Packet
.TxData
->FragmentTable
[0].FragmentBuffer
!= NULL
) {
69 FreePool (Wrap
->TcpWrap
.Tx4Token
.Packet
.TxData
->FragmentTable
[0].FragmentBuffer
);
72 if (Wrap
->TcpWrap
.Tx4Token
.CompletionToken
.Event
!= NULL
) {
73 gBS
->CloseEvent (Wrap
->TcpWrap
.Tx4Token
.CompletionToken
.Event
);
77 Wrap
->HttpToken
->Status
= Wrap
->TcpWrap
.Tx6Token
.CompletionToken
.Status
;
78 gBS
->SignalEvent (Wrap
->HttpToken
->Event
);
83 if (Wrap
->TcpWrap
.Tx6Token
.Packet
.TxData
->FragmentTable
[0].FragmentBuffer
!= NULL
) {
84 FreePool (Wrap
->TcpWrap
.Tx6Token
.Packet
.TxData
->FragmentTable
[0].FragmentBuffer
);
87 if (Wrap
->TcpWrap
.Tx6Token
.CompletionToken
.Event
!= NULL
) {
88 gBS
->CloseEvent (Wrap
->TcpWrap
.Tx6Token
.CompletionToken
.Event
);
93 Wrap
->TcpWrap
.IsTxDone
= TRUE
;
96 // Check pending TxTokens and sent out.
98 NetMapIterate (&Wrap
->HttpInstance
->TxTokens
, HttpTcpTransmit
, NULL
);
103 Request HttpTcpTransmitNotifyDpc as a DPC at TPL_CALLBACK.
105 @param Event The receive event delivered to TCP for transmit.
106 @param Context Context for the callback.
111 HttpTcpTransmitNotify (
117 // Request HttpTcpTransmitNotifyDpc as a DPC at TPL_CALLBACK
119 QueueDpc (TPL_CALLBACK
, HttpTcpTransmitNotifyDpc
, Context
);
123 The notify function associated with Rx4Token for Tcp4->Receive () or Rx6Token for Tcp6->Receive().
125 @param[in] Context The context.
130 HttpTcpReceiveNotifyDpc (
134 HTTP_TOKEN_WRAP
*Wrap
;
138 HTTP_PROTOCOL
*HttpInstance
;
141 if (Context
== NULL
) {
145 Wrap
= (HTTP_TOKEN_WRAP
*) Context
;
146 HttpInstance
= Wrap
->HttpInstance
;
147 UsingIpv6
= HttpInstance
->LocalAddressIsIPv6
;
150 gBS
->CloseEvent (Wrap
->TcpWrap
.Rx6Token
.CompletionToken
.Event
);
152 if (EFI_ERROR (Wrap
->TcpWrap
.Rx6Token
.CompletionToken
.Status
)) {
157 gBS
->CloseEvent (Wrap
->TcpWrap
.Rx4Token
.CompletionToken
.Event
);
159 if (EFI_ERROR (Wrap
->TcpWrap
.Rx4Token
.CompletionToken
.Status
)) {
165 // Check whether we receive a complete HTTP message.
167 ASSERT (HttpInstance
->MsgParser
!= NULL
);
169 Length
= (UINTN
) Wrap
->TcpWrap
.Rx6Data
.FragmentTable
[0].FragmentLength
;
171 Length
= (UINTN
) Wrap
->TcpWrap
.Rx4Data
.FragmentTable
[0].FragmentLength
;
174 Status
= HttpParseMessageBody (
175 HttpInstance
->MsgParser
,
177 Wrap
->HttpToken
->Message
->Body
179 if (EFI_ERROR (Status
)) {
183 if (HttpIsMessageComplete (HttpInstance
->MsgParser
)) {
185 // Free the MsgParse since we already have a full HTTP message.
187 HttpFreeMsgParser (HttpInstance
->MsgParser
);
188 HttpInstance
->MsgParser
= NULL
;
191 Wrap
->HttpToken
->Message
->BodyLength
= Length
;
192 ASSERT (HttpInstance
->CacheBody
== NULL
);
194 // We receive part of header of next HTTP msg.
196 if (HttpInstance
->NextMsg
!= NULL
) {
197 Wrap
->HttpToken
->Message
->BodyLength
= HttpInstance
->NextMsg
-
198 (CHAR8
*) Wrap
->HttpToken
->Message
->Body
;
199 HttpInstance
->CacheLen
= Length
- Wrap
->HttpToken
->Message
->BodyLength
;
200 if (HttpInstance
->CacheLen
!= 0) {
201 HttpInstance
->CacheBody
= AllocateZeroPool (HttpInstance
->CacheLen
);
202 if (HttpInstance
->CacheBody
== NULL
) {
205 CopyMem (HttpInstance
->CacheBody
, HttpInstance
->NextMsg
, HttpInstance
->CacheLen
);
206 HttpInstance
->NextMsg
= HttpInstance
->CacheBody
;
207 HttpInstance
->CacheOffset
= 0;
211 Item
= NetMapFindKey (&Wrap
->HttpInstance
->RxTokens
, Wrap
->HttpToken
);
213 NetMapRemoveItem (&Wrap
->HttpInstance
->RxTokens
, Item
, NULL
);
217 Wrap
->TcpWrap
.IsRxDone
= TRUE
;
219 Wrap
->HttpToken
->Status
= Wrap
->TcpWrap
.Rx6Token
.CompletionToken
.Status
;
221 Wrap
->HttpToken
->Status
= Wrap
->TcpWrap
.Rx4Token
.CompletionToken
.Status
;
225 gBS
->SignalEvent (Wrap
->HttpToken
->Event
);
228 // Check pending RxTokens and receive the HTTP message.
230 NetMapIterate (&Wrap
->HttpInstance
->RxTokens
, HttpTcpReceive
, NULL
);
236 Request HttpTcpReceiveNotifyDpc as a DPC at TPL_CALLBACK.
238 @param Event The receive event delivered to TCP for receive.
239 @param Context Context for the callback.
244 HttpTcpReceiveNotify (
250 // Request HttpTcpTransmitNotifyDpc as a DPC at TPL_CALLBACK
252 QueueDpc (TPL_CALLBACK
, HttpTcpReceiveNotifyDpc
, Context
);
256 Create events for the TCP connection token and TCP close token.
258 @param[in] HttpInstance Pointer to HTTP_PROTOCOL structure.
260 @retval EFI_SUCCESS The events are created successfully.
261 @retval others Other error as indicated.
265 HttpCreateTcpConnCloseEvent (
266 IN HTTP_PROTOCOL
*HttpInstance
271 if (!HttpInstance
->LocalAddressIsIPv6
) {
273 // Create events for variuos asynchronous operations.
275 Status
= gBS
->CreateEvent (
279 &HttpInstance
->IsTcp4ConnDone
,
280 &HttpInstance
->Tcp4ConnToken
.CompletionToken
.Event
282 if (EFI_ERROR (Status
)) {
287 // Initialize Tcp4CloseToken
289 Status
= gBS
->CreateEvent (
293 &HttpInstance
->IsTcp4CloseDone
,
294 &HttpInstance
->Tcp4CloseToken
.CompletionToken
.Event
296 if (EFI_ERROR (Status
)) {
302 // Create events for variuos asynchronous operations.
304 Status
= gBS
->CreateEvent (
308 &HttpInstance
->IsTcp6ConnDone
,
309 &HttpInstance
->Tcp6ConnToken
.CompletionToken
.Event
311 if (EFI_ERROR (Status
)) {
316 // Initialize Tcp6CloseToken
318 Status
= gBS
->CreateEvent (
322 &HttpInstance
->IsTcp6CloseDone
,
323 &HttpInstance
->Tcp6CloseToken
.CompletionToken
.Event
325 if (EFI_ERROR (Status
)) {
336 HttpCloseTcpConnCloseEvent (HttpInstance
);
343 Close events in the TCP connection token and TCP close token.
345 @param[in] HttpInstance Pointer to HTTP_PROTOCOL structure.
349 HttpCloseTcpConnCloseEvent (
350 IN HTTP_PROTOCOL
*HttpInstance
353 ASSERT (HttpInstance
!= NULL
);
355 if (HttpInstance
->LocalAddressIsIPv6
) {
356 if (NULL
!= HttpInstance
->Tcp6ConnToken
.CompletionToken
.Event
) {
357 gBS
->CloseEvent (HttpInstance
->Tcp6ConnToken
.CompletionToken
.Event
);
358 HttpInstance
->Tcp6ConnToken
.CompletionToken
.Event
= NULL
;
361 if (NULL
!= HttpInstance
->Tcp6CloseToken
.CompletionToken
.Event
) {
362 gBS
->CloseEvent(HttpInstance
->Tcp6CloseToken
.CompletionToken
.Event
);
363 HttpInstance
->Tcp6CloseToken
.CompletionToken
.Event
= NULL
;
367 if (NULL
!= HttpInstance
->Tcp4ConnToken
.CompletionToken
.Event
) {
368 gBS
->CloseEvent (HttpInstance
->Tcp4ConnToken
.CompletionToken
.Event
);
369 HttpInstance
->Tcp4ConnToken
.CompletionToken
.Event
= NULL
;
372 if (NULL
!= HttpInstance
->Tcp4CloseToken
.CompletionToken
.Event
) {
373 gBS
->CloseEvent(HttpInstance
->Tcp4CloseToken
.CompletionToken
.Event
);
374 HttpInstance
->Tcp4CloseToken
.CompletionToken
.Event
= NULL
;
381 Create event for the TCP transmit token.
383 @param[in] Wrap Point to HTTP token's wrap data.
385 @retval EFI_SUCCESS The events is created successfully.
386 @retval others Other error as indicated.
390 HttpCreateTcpTxEvent (
391 IN HTTP_TOKEN_WRAP
*Wrap
395 HTTP_PROTOCOL
*HttpInstance
;
396 HTTP_TCP_TOKEN_WRAP
*TcpWrap
;
398 HttpInstance
= Wrap
->HttpInstance
;
399 TcpWrap
= &Wrap
->TcpWrap
;
401 if (!HttpInstance
->LocalAddressIsIPv6
) {
402 Status
= gBS
->CreateEvent (
405 HttpTcpTransmitNotify
,
407 &TcpWrap
->Tx4Token
.CompletionToken
.Event
409 if (EFI_ERROR (Status
)) {
413 TcpWrap
->Tx4Data
.Push
= TRUE
;
414 TcpWrap
->Tx4Data
.Urgent
= FALSE
;
415 TcpWrap
->Tx4Data
.FragmentCount
= 1;
416 TcpWrap
->Tx4Token
.Packet
.TxData
= &Wrap
->TcpWrap
.Tx4Data
;
417 TcpWrap
->Tx4Token
.CompletionToken
.Status
= EFI_NOT_READY
;
420 Status
= gBS
->CreateEvent (
423 HttpTcpTransmitNotify
,
425 &TcpWrap
->Tx6Token
.CompletionToken
.Event
427 if (EFI_ERROR (Status
)) {
431 TcpWrap
->Tx6Data
.Push
= TRUE
;
432 TcpWrap
->Tx6Data
.Urgent
= FALSE
;
433 TcpWrap
->Tx6Data
.FragmentCount
= 1;
434 TcpWrap
->Tx6Token
.Packet
.TxData
= &Wrap
->TcpWrap
.Tx6Data
;
435 TcpWrap
->Tx6Token
.CompletionToken
.Status
=EFI_NOT_READY
;
444 Create event for the TCP receive token which is used to receive HTTP header.
446 @param[in] HttpInstance Pointer to HTTP_PROTOCOL structure.
448 @retval EFI_SUCCESS The events is created successfully.
449 @retval others Other error as indicated.
453 HttpCreateTcpRxEventForHeader (
454 IN HTTP_PROTOCOL
*HttpInstance
459 if (!HttpInstance
->LocalAddressIsIPv6
) {
460 Status
= gBS
->CreateEvent (
464 &HttpInstance
->IsRxDone
,
465 &HttpInstance
->Rx4Token
.CompletionToken
.Event
467 if (EFI_ERROR (Status
)) {
471 HttpInstance
->Rx4Data
.FragmentCount
= 1;
472 HttpInstance
->Rx4Token
.Packet
.RxData
= &HttpInstance
->Rx4Data
;
473 HttpInstance
->Rx4Token
.CompletionToken
.Status
= EFI_NOT_READY
;
476 Status
= gBS
->CreateEvent (
480 &HttpInstance
->IsRxDone
,
481 &HttpInstance
->Rx6Token
.CompletionToken
.Event
483 if (EFI_ERROR (Status
)) {
487 HttpInstance
->Rx6Data
.FragmentCount
=1;
488 HttpInstance
->Rx6Token
.Packet
.RxData
= &HttpInstance
->Rx6Data
;
489 HttpInstance
->Rx6Token
.CompletionToken
.Status
= EFI_NOT_READY
;
498 Create event for the TCP receive token which is used to receive HTTP body.
500 @param[in] Wrap Point to HTTP token's wrap data.
502 @retval EFI_SUCCESS The events is created successfully.
503 @retval others Other error as indicated.
507 HttpCreateTcpRxEvent (
508 IN HTTP_TOKEN_WRAP
*Wrap
512 HTTP_PROTOCOL
*HttpInstance
;
513 HTTP_TCP_TOKEN_WRAP
*TcpWrap
;
515 HttpInstance
= Wrap
->HttpInstance
;
516 TcpWrap
= &Wrap
->TcpWrap
;
517 if (!HttpInstance
->LocalAddressIsIPv6
) {
518 Status
= gBS
->CreateEvent (
521 HttpTcpReceiveNotify
,
523 &TcpWrap
->Rx4Token
.CompletionToken
.Event
525 if (EFI_ERROR (Status
)) {
529 TcpWrap
->Rx4Data
.FragmentCount
= 1;
530 TcpWrap
->Rx4Token
.Packet
.RxData
= &Wrap
->TcpWrap
.Rx4Data
;
531 TcpWrap
->Rx4Token
.CompletionToken
.Status
= EFI_NOT_READY
;
534 Status
= gBS
->CreateEvent (
537 HttpTcpReceiveNotify
,
539 &TcpWrap
->Rx6Token
.CompletionToken
.Event
541 if (EFI_ERROR (Status
)) {
545 TcpWrap
->Rx6Data
.FragmentCount
= 1;
546 TcpWrap
->Rx6Token
.Packet
.RxData
= &Wrap
->TcpWrap
.Rx6Data
;
547 TcpWrap
->Rx6Token
.CompletionToken
.Status
= EFI_NOT_READY
;
554 Close Events for Tcp Receive Tokens for HTTP body and HTTP header.
556 @param[in] Wrap Pointer to HTTP token's wrap data.
560 HttpCloseTcpRxEvent (
561 IN HTTP_TOKEN_WRAP
*Wrap
564 HTTP_PROTOCOL
*HttpInstance
;
565 EFI_TCP4_IO_TOKEN
*Rx4Token
;
566 EFI_TCP6_IO_TOKEN
*Rx6Token
;
568 HttpInstance
= Wrap
->HttpInstance
;
572 if (HttpInstance
->LocalAddressIsIPv6
) {
574 if (Wrap
->TcpWrap
.Rx6Token
.CompletionToken
.Event
!= NULL
) {
575 gBS
->CloseEvent (Wrap
->TcpWrap
.Rx6Token
.CompletionToken
.Event
);
579 if (HttpInstance
->Rx6Token
.CompletionToken
.Event
!= NULL
) {
580 gBS
->CloseEvent (HttpInstance
->Rx6Token
.CompletionToken
.Event
);
581 HttpInstance
->Rx6Token
.CompletionToken
.Event
= NULL
;
585 if (Wrap
->TcpWrap
.Rx4Token
.CompletionToken
.Event
!= NULL
) {
586 gBS
->CloseEvent (Wrap
->TcpWrap
.Rx4Token
.CompletionToken
.Event
);
590 if (HttpInstance
->Rx4Token
.CompletionToken
.Event
!= NULL
) {
591 gBS
->CloseEvent (HttpInstance
->Rx4Token
.CompletionToken
.Event
);
592 HttpInstance
->Rx4Token
.CompletionToken
.Event
= NULL
;
598 Intiialize the HTTP_PROTOCOL structure to the unconfigured state.
600 @param[in, out] HttpInstance Pointer to HTTP_PROTOCOL structure.
601 @param[in] IpVersion Indicate us TCP4 protocol or TCP6 protocol.
603 @retval EFI_SUCCESS HTTP_PROTOCOL structure is initialized successfully.
604 @retval Others Other error as indicated.
609 IN OUT HTTP_PROTOCOL
*HttpInstance
,
617 ASSERT (HttpInstance
!= NULL
);
618 UsingIpv6
= IpVersion
;
622 // Create TCP4 child.
624 Status
= NetLibCreateServiceChild (
625 HttpInstance
->Service
->ControllerHandle
,
626 HttpInstance
->Service
->ImageHandle
,
627 &gEfiTcp4ServiceBindingProtocolGuid
,
628 &HttpInstance
->Tcp4ChildHandle
631 if (EFI_ERROR (Status
)) {
635 Status
= gBS
->OpenProtocol (
636 HttpInstance
->Tcp4ChildHandle
,
637 &gEfiTcp4ProtocolGuid
,
638 (VOID
**) &Interface
,
639 HttpInstance
->Service
->ImageHandle
,
640 HttpInstance
->Service
->ControllerHandle
,
641 EFI_OPEN_PROTOCOL_BY_DRIVER
644 if (EFI_ERROR (Status
)) {
648 Status
= gBS
->OpenProtocol (
649 HttpInstance
->Tcp4ChildHandle
,
650 &gEfiTcp4ProtocolGuid
,
651 (VOID
**) &HttpInstance
->Tcp4
,
652 HttpInstance
->Service
->ImageHandle
,
653 HttpInstance
->Handle
,
654 EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER
656 if (EFI_ERROR(Status
)) {
660 Status
= gBS
->OpenProtocol (
661 HttpInstance
->Service
->Tcp4ChildHandle
,
662 &gEfiTcp4ProtocolGuid
,
663 (VOID
**) &Interface
,
664 HttpInstance
->Service
->ImageHandle
,
665 HttpInstance
->Handle
,
666 EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER
668 if (EFI_ERROR(Status
)) {
673 // Create TCP6 Child.
675 Status
= NetLibCreateServiceChild (
676 HttpInstance
->Service
->ControllerHandle
,
677 HttpInstance
->Service
->ImageHandle
,
678 &gEfiTcp6ServiceBindingProtocolGuid
,
679 &HttpInstance
->Tcp6ChildHandle
682 if (EFI_ERROR (Status
)) {
686 Status
= gBS
->OpenProtocol (
687 HttpInstance
->Tcp6ChildHandle
,
688 &gEfiTcp6ProtocolGuid
,
689 (VOID
**) &Interface
,
690 HttpInstance
->Service
->ImageHandle
,
691 HttpInstance
->Service
->ControllerHandle
,
692 EFI_OPEN_PROTOCOL_BY_DRIVER
695 if (EFI_ERROR (Status
)) {
699 Status
= gBS
->OpenProtocol (
700 HttpInstance
->Tcp6ChildHandle
,
701 &gEfiTcp6ProtocolGuid
,
702 (VOID
**) &HttpInstance
->Tcp6
,
703 HttpInstance
->Service
->ImageHandle
,
704 HttpInstance
->Handle
,
705 EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER
708 if (EFI_ERROR(Status
)) {
712 Status
= gBS
->OpenProtocol (
713 HttpInstance
->Service
->Tcp6ChildHandle
,
714 &gEfiTcp6ProtocolGuid
,
715 (VOID
**) &Interface
,
716 HttpInstance
->Service
->ImageHandle
,
717 HttpInstance
->Handle
,
718 EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER
721 if (EFI_ERROR(Status
)) {
726 HttpInstance
->Url
= AllocateZeroPool (HTTP_URL_BUFFER_LEN
);
727 if (HttpInstance
->Url
== NULL
) {
728 Status
= EFI_OUT_OF_RESOURCES
;
736 if (HttpInstance
->Tcp4ChildHandle
!= NULL
) {
738 HttpInstance
->Tcp4ChildHandle
,
739 &gEfiTcp4ProtocolGuid
,
740 HttpInstance
->Service
->ImageHandle
,
741 HttpInstance
->Service
->ControllerHandle
745 HttpInstance
->Tcp4ChildHandle
,
746 &gEfiTcp4ProtocolGuid
,
747 HttpInstance
->Service
->ImageHandle
,
751 NetLibDestroyServiceChild (
752 HttpInstance
->Service
->ControllerHandle
,
753 HttpInstance
->Service
->ImageHandle
,
754 &gEfiTcp4ServiceBindingProtocolGuid
,
755 HttpInstance
->Tcp4ChildHandle
759 if (HttpInstance
->Service
->Tcp4ChildHandle
!= NULL
) {
761 HttpInstance
->Service
->Tcp4ChildHandle
,
762 &gEfiTcp4ProtocolGuid
,
763 HttpInstance
->Service
->ImageHandle
,
768 if (HttpInstance
->Tcp6ChildHandle
!= NULL
) {
770 HttpInstance
->Tcp6ChildHandle
,
771 &gEfiTcp6ProtocolGuid
,
772 HttpInstance
->Service
->ImageHandle
,
773 HttpInstance
->Service
->ControllerHandle
777 HttpInstance
->Tcp6ChildHandle
,
778 &gEfiTcp6ProtocolGuid
,
779 HttpInstance
->Service
->ImageHandle
,
783 NetLibDestroyServiceChild (
784 HttpInstance
->Service
->ControllerHandle
,
785 HttpInstance
->Service
->ImageHandle
,
786 &gEfiTcp6ServiceBindingProtocolGuid
,
787 HttpInstance
->Tcp6ChildHandle
791 if (HttpInstance
->Service
->Tcp6ChildHandle
!= NULL
) {
793 HttpInstance
->Service
->Tcp6ChildHandle
,
794 &gEfiTcp6ProtocolGuid
,
795 HttpInstance
->Service
->ImageHandle
,
800 return EFI_UNSUPPORTED
;
805 Clean up the HTTP child, release all the resources used by it.
807 @param[in] HttpInstance The HTTP child to clean up.
812 IN HTTP_PROTOCOL
*HttpInstance
815 HttpCloseConnection (HttpInstance
);
817 HttpCloseTcpConnCloseEvent (HttpInstance
);
819 if (HttpInstance
->CacheBody
!= NULL
) {
820 FreePool (HttpInstance
->CacheBody
);
821 HttpInstance
->CacheBody
= NULL
;
822 HttpInstance
->NextMsg
= NULL
;
825 if (HttpInstance
->RemoteHost
!= NULL
) {
826 FreePool (HttpInstance
->RemoteHost
);
827 HttpInstance
->RemoteHost
= NULL
;
830 if (HttpInstance
->MsgParser
!= NULL
) {
831 HttpFreeMsgParser (HttpInstance
->MsgParser
);
832 HttpInstance
->MsgParser
= NULL
;
835 if (HttpInstance
->Url
!= NULL
) {
836 FreePool (HttpInstance
->Url
);
837 HttpInstance
->Url
= NULL
;
840 NetMapClean (&HttpInstance
->TxTokens
);
841 NetMapClean (&HttpInstance
->RxTokens
);
843 if (HttpInstance
->Tcp4ChildHandle
!= NULL
) {
845 HttpInstance
->Tcp4ChildHandle
,
846 &gEfiTcp4ProtocolGuid
,
847 HttpInstance
->Service
->ImageHandle
,
848 HttpInstance
->Service
->ControllerHandle
852 HttpInstance
->Tcp4ChildHandle
,
853 &gEfiTcp4ProtocolGuid
,
854 HttpInstance
->Service
->ImageHandle
,
858 NetLibDestroyServiceChild (
859 HttpInstance
->Service
->ControllerHandle
,
860 HttpInstance
->Service
->ImageHandle
,
861 &gEfiTcp4ServiceBindingProtocolGuid
,
862 HttpInstance
->Tcp4ChildHandle
866 if (HttpInstance
->Service
->Tcp4ChildHandle
!= NULL
) {
868 HttpInstance
->Service
->Tcp4ChildHandle
,
869 &gEfiTcp4ProtocolGuid
,
870 HttpInstance
->Service
->ImageHandle
,
875 if (HttpInstance
->Tcp6ChildHandle
!= NULL
) {
877 HttpInstance
->Tcp6ChildHandle
,
878 &gEfiTcp6ProtocolGuid
,
879 HttpInstance
->Service
->ImageHandle
,
880 HttpInstance
->Service
->ControllerHandle
884 HttpInstance
->Tcp6ChildHandle
,
885 &gEfiTcp6ProtocolGuid
,
886 HttpInstance
->Service
->ImageHandle
,
890 NetLibDestroyServiceChild (
891 HttpInstance
->Service
->ControllerHandle
,
892 HttpInstance
->Service
->ImageHandle
,
893 &gEfiTcp6ServiceBindingProtocolGuid
,
894 HttpInstance
->Tcp6ChildHandle
898 if (HttpInstance
->Service
->Tcp6ChildHandle
!= NULL
) {
900 HttpInstance
->Service
->Tcp6ChildHandle
,
901 &gEfiTcp6ProtocolGuid
,
902 HttpInstance
->Service
->ImageHandle
,
910 Establish TCP connection with HTTP server.
912 @param[in] HttpInstance The HTTP instance private data.
914 @retval EFI_SUCCESS The TCP connection is established.
915 @retval Others Other error as indicated.
919 HttpCreateConnection (
920 IN HTTP_PROTOCOL
*HttpInstance
926 // Connect to Http server
928 if (!HttpInstance
->LocalAddressIsIPv6
) {
929 HttpInstance
->IsTcp4ConnDone
= FALSE
;
930 HttpInstance
->Tcp4ConnToken
.CompletionToken
.Status
= EFI_NOT_READY
;
931 Status
= HttpInstance
->Tcp4
->Connect (HttpInstance
->Tcp4
, &HttpInstance
->Tcp4ConnToken
);
932 if (EFI_ERROR (Status
)) {
933 DEBUG ((EFI_D_ERROR
, "HttpCreateConnection: Tcp4->Connect() = %r\n", Status
));
937 while (!HttpInstance
->IsTcp4ConnDone
) {
938 HttpInstance
->Tcp4
->Poll (HttpInstance
->Tcp4
);
941 Status
= HttpInstance
->Tcp4ConnToken
.CompletionToken
.Status
;
944 HttpInstance
->IsTcp6ConnDone
= FALSE
;
945 HttpInstance
->Tcp6ConnToken
.CompletionToken
.Status
= EFI_NOT_READY
;
946 Status
= HttpInstance
->Tcp6
->Connect (HttpInstance
->Tcp6
, &HttpInstance
->Tcp6ConnToken
);
947 if (EFI_ERROR (Status
)) {
948 DEBUG ((EFI_D_ERROR
, "HttpCreateConnection: Tcp6->Connect() = %r\n", Status
));
952 while(!HttpInstance
->IsTcp6ConnDone
) {
953 HttpInstance
->Tcp6
->Poll (HttpInstance
->Tcp6
);
956 Status
= HttpInstance
->Tcp6ConnToken
.CompletionToken
.Status
;
959 if (!EFI_ERROR (Status
)) {
960 HttpInstance
->State
= HTTP_STATE_TCP_CONNECTED
;
967 Close existing TCP connection.
969 @param[in] HttpInstance The HTTP instance private data.
971 @retval EFI_SUCCESS The TCP connection is closed.
972 @retval Others Other error as indicated.
976 HttpCloseConnection (
977 IN HTTP_PROTOCOL
*HttpInstance
982 if (HttpInstance
->State
== HTTP_STATE_TCP_CONNECTED
) {
984 if (HttpInstance
->LocalAddressIsIPv6
) {
985 HttpInstance
->Tcp6CloseToken
.AbortOnClose
= TRUE
;
986 HttpInstance
->IsTcp6CloseDone
= FALSE
;
987 Status
= HttpInstance
->Tcp6
->Close (HttpInstance
->Tcp6
, &HttpInstance
->Tcp6CloseToken
);
988 if (EFI_ERROR (Status
)) {
992 while (!HttpInstance
->IsTcp6CloseDone
) {
993 HttpInstance
->Tcp6
->Poll (HttpInstance
->Tcp6
);
997 HttpInstance
->Tcp4CloseToken
.AbortOnClose
= TRUE
;
998 HttpInstance
->IsTcp4CloseDone
= FALSE
;
999 Status
= HttpInstance
->Tcp4
->Close (HttpInstance
->Tcp4
, &HttpInstance
->Tcp4CloseToken
);
1000 if (EFI_ERROR (Status
)) {
1004 while (!HttpInstance
->IsTcp4CloseDone
) {
1005 HttpInstance
->Tcp4
->Poll (HttpInstance
->Tcp4
);
1011 HttpInstance
->State
= HTTP_STATE_TCP_CLOSED
;
1016 Configure TCP4 protocol child.
1018 @param[in] HttpInstance The HTTP instance private data.
1019 @param[in] Wrap The HTTP token's wrap data.
1021 @retval EFI_SUCCESS The TCP4 protocol child is configured.
1022 @retval Others Other error as indicated.
1027 IN HTTP_PROTOCOL
*HttpInstance
,
1028 IN HTTP_TOKEN_WRAP
*Wrap
1032 EFI_TCP4_CONFIG_DATA
*Tcp4CfgData
;
1033 EFI_TCP4_ACCESS_POINT
*Tcp4AP
;
1034 EFI_TCP4_OPTION
*Tcp4Option
;
1036 ASSERT (HttpInstance
!= NULL
);
1039 Tcp4CfgData
= &HttpInstance
->Tcp4CfgData
;
1040 ZeroMem (Tcp4CfgData
, sizeof (EFI_TCP4_CONFIG_DATA
));
1042 Tcp4CfgData
->TypeOfService
= HTTP_TOS_DEAULT
;
1043 Tcp4CfgData
->TimeToLive
= HTTP_TTL_DEAULT
;
1044 Tcp4CfgData
->ControlOption
= &HttpInstance
->Tcp4Option
;
1046 Tcp4AP
= &Tcp4CfgData
->AccessPoint
;
1047 Tcp4AP
->UseDefaultAddress
= HttpInstance
->IPv4Node
.UseDefaultAddress
;
1048 if (!Tcp4AP
->UseDefaultAddress
) {
1049 IP4_COPY_ADDRESS (&Tcp4AP
->StationAddress
, &HttpInstance
->IPv4Node
.LocalAddress
);
1050 IP4_COPY_ADDRESS (&Tcp4AP
->SubnetMask
, &HttpInstance
->IPv4Node
.LocalSubnet
);
1053 Tcp4AP
->StationPort
= HttpInstance
->IPv4Node
.LocalPort
;
1054 Tcp4AP
->RemotePort
= HttpInstance
->RemotePort
;
1055 Tcp4AP
->ActiveFlag
= TRUE
;
1056 IP4_COPY_ADDRESS (&Tcp4AP
->RemoteAddress
, &HttpInstance
->RemoteAddr
);
1058 Tcp4Option
= Tcp4CfgData
->ControlOption
;
1059 Tcp4Option
->ReceiveBufferSize
= HTTP_BUFFER_SIZE_DEAULT
;
1060 Tcp4Option
->SendBufferSize
= HTTP_BUFFER_SIZE_DEAULT
;
1061 Tcp4Option
->MaxSynBackLog
= HTTP_MAX_SYN_BACK_LOG
;
1062 Tcp4Option
->ConnectionTimeout
= HTTP_CONNECTION_TIMEOUT
;
1063 Tcp4Option
->DataRetries
= HTTP_DATA_RETRIES
;
1064 Tcp4Option
->FinTimeout
= HTTP_FIN_TIMEOUT
;
1065 Tcp4Option
->KeepAliveProbes
= HTTP_KEEP_ALIVE_PROBES
;
1066 Tcp4Option
->KeepAliveTime
= HTTP_KEEP_ALIVE_TIME
;
1067 Tcp4Option
->KeepAliveInterval
= HTTP_KEEP_ALIVE_INTERVAL
;
1068 Tcp4Option
->EnableNagle
= TRUE
;
1069 Tcp4CfgData
->ControlOption
= Tcp4Option
;
1071 Status
= HttpInstance
->Tcp4
->Configure (HttpInstance
->Tcp4
, Tcp4CfgData
);
1072 if (EFI_ERROR (Status
)) {
1073 DEBUG ((EFI_D_ERROR
, "HttpConfigureTcp4 - %r\n", Status
));
1077 Status
= HttpCreateTcpConnCloseEvent (HttpInstance
);
1078 if (EFI_ERROR (Status
)) {
1082 Status
= HttpCreateTcpTxEvent (Wrap
);
1083 if (EFI_ERROR (Status
)) {
1087 HttpInstance
->State
= HTTP_STATE_TCP_CONFIGED
;
1093 Configure TCP6 protocol child.
1095 @param[in] HttpInstance The HTTP instance private data.
1096 @param[in] Wrap The HTTP token's wrap data.
1098 @retval EFI_SUCCESS The TCP6 protocol child is configured.
1099 @retval Others Other error as indicated.
1104 IN HTTP_PROTOCOL
*HttpInstance
,
1105 IN HTTP_TOKEN_WRAP
*Wrap
1109 EFI_TCP6_CONFIG_DATA
*Tcp6CfgData
;
1110 EFI_TCP6_ACCESS_POINT
*Tcp6Ap
;
1111 EFI_TCP6_OPTION
*Tcp6Option
;
1113 ASSERT (HttpInstance
!= NULL
);
1115 Tcp6CfgData
= &HttpInstance
->Tcp6CfgData
;
1116 ZeroMem (Tcp6CfgData
, sizeof (EFI_TCP6_CONFIG_DATA
));
1118 Tcp6CfgData
->TrafficClass
= 0;
1119 Tcp6CfgData
->HopLimit
= 255;
1120 Tcp6CfgData
->ControlOption
= &HttpInstance
->Tcp6Option
;
1122 Tcp6Ap
= &Tcp6CfgData
->AccessPoint
;
1123 Tcp6Ap
->ActiveFlag
= TRUE
;
1124 Tcp6Ap
->StationPort
= HttpInstance
->Ipv6Node
.LocalPort
;
1125 Tcp6Ap
->RemotePort
= HttpInstance
->RemotePort
;
1126 IP6_COPY_ADDRESS (&Tcp6Ap
->StationAddress
, &HttpInstance
->Ipv6Node
.LocalAddress
);
1127 IP6_COPY_ADDRESS (&Tcp6Ap
->RemoteAddress
, &HttpInstance
->RemoteIpv6Addr
);
1129 Tcp6Option
= Tcp6CfgData
->ControlOption
;
1130 Tcp6Option
->ReceiveBufferSize
= HTTP_BUFFER_SIZE_DEAULT
;
1131 Tcp6Option
->SendBufferSize
= HTTP_BUFFER_SIZE_DEAULT
;
1132 Tcp6Option
->MaxSynBackLog
= HTTP_MAX_SYN_BACK_LOG
;
1133 Tcp6Option
->ConnectionTimeout
= HTTP_CONNECTION_TIMEOUT
;
1134 Tcp6Option
->DataRetries
= HTTP_DATA_RETRIES
;
1135 Tcp6Option
->FinTimeout
= HTTP_FIN_TIMEOUT
;
1136 Tcp6Option
->KeepAliveProbes
= HTTP_KEEP_ALIVE_PROBES
;
1137 Tcp6Option
->KeepAliveTime
= HTTP_KEEP_ALIVE_TIME
;
1138 Tcp6Option
->KeepAliveInterval
= HTTP_KEEP_ALIVE_INTERVAL
;
1139 Tcp6Option
->EnableNagle
= TRUE
;
1141 Status
= HttpInstance
->Tcp6
->Configure (HttpInstance
->Tcp6
, Tcp6CfgData
);
1142 if (EFI_ERROR (Status
)) {
1143 DEBUG ((EFI_D_ERROR
, "HttpConfigureTcp6 - %r\n", Status
));
1147 Status
= HttpCreateTcpConnCloseEvent (HttpInstance
);
1148 if (EFI_ERROR (Status
)) {
1152 Status
= HttpCreateTcpTxEvent (Wrap
);
1153 if (EFI_ERROR (Status
)) {
1157 HttpInstance
->State
= HTTP_STATE_TCP_CONFIGED
;
1164 Check existing TCP connection, if in error state, recover TCP4 connection.
1166 @param[in] HttpInstance The HTTP instance private data.
1168 @retval EFI_SUCCESS The TCP connection is established.
1169 @retval EFI_NOT_READY TCP4 protocol child is not created or configured.
1170 @retval Others Other error as indicated.
1175 IN HTTP_PROTOCOL
*HttpInstance
1179 EFI_TCP4_CONNECTION_STATE Tcp4State
;
1182 if (HttpInstance
->State
!= HTTP_STATE_TCP_CONFIGED
|| HttpInstance
->Tcp4
== NULL
) {
1183 return EFI_NOT_READY
;
1186 Status
= HttpInstance
->Tcp4
->GetModeData(
1194 if (EFI_ERROR(Status
)){
1195 DEBUG ((EFI_D_ERROR
, "Tcp4 GetModeData fail - %x\n", Status
));
1199 if (Tcp4State
> Tcp4StateEstablished
) {
1200 HttpCloseConnection(HttpInstance
);
1203 return HttpCreateConnection (HttpInstance
);
1207 Check existing TCP connection, if in error state, recover TCP6 connection.
1209 @param[in] HttpInstance The HTTP instance private data.
1211 @retval EFI_SUCCESS The TCP connection is established.
1212 @retval EFI_NOT_READY TCP6 protocol child is not created or configured.
1213 @retval Others Other error as indicated.
1218 IN HTTP_PROTOCOL
*HttpInstance
1222 EFI_TCP6_CONNECTION_STATE Tcp6State
;
1224 if (HttpInstance
->State
!= HTTP_STATE_TCP_CONFIGED
|| HttpInstance
->Tcp6
== NULL
) {
1225 return EFI_NOT_READY
;
1228 Status
= HttpInstance
->Tcp6
->GetModeData (
1237 if (EFI_ERROR(Status
)){
1238 DEBUG ((EFI_D_ERROR
, "Tcp6 GetModeData fail - %x\n", Status
));
1242 if (Tcp6State
> Tcp6StateEstablished
) {
1243 HttpCloseConnection (HttpInstance
);
1246 return HttpCreateConnection (HttpInstance
);
1250 Initialize TCP related data.
1252 @param[in] HttpInstance The HTTP instance private data.
1253 @param[in] Wrap The HTTP token's wrap data.
1255 @retval EFI_SUCCESS The initialization of TCP instance is done.
1256 @retval Others Other error as indicated.
1261 IN HTTP_PROTOCOL
*HttpInstance
,
1262 IN HTTP_TOKEN_WRAP
*Wrap
1266 ASSERT (HttpInstance
!= NULL
);
1268 if (!HttpInstance
->LocalAddressIsIPv6
) {
1270 // Configure TCP instance.
1272 Status
= HttpConfigureTcp4 (HttpInstance
, Wrap
);
1273 if (EFI_ERROR (Status
)) {
1279 Status
= HttpConnectTcp4 (HttpInstance
);
1280 if (EFI_ERROR (Status
)) {
1285 // Configure TCP instance.
1287 Status
= HttpConfigureTcp6 (HttpInstance
, Wrap
);
1288 if (EFI_ERROR (Status
)) {
1294 Status
= HttpConnectTcp6 (HttpInstance
);
1295 if (EFI_ERROR (Status
)) {
1305 Send the HTTP message through TCP4 or TCP6.
1307 @param[in] HttpInstance The HTTP instance private data.
1308 @param[in] Wrap The HTTP token's wrap data.
1309 @param[in] TxString Buffer containing the HTTP message string.
1310 @param[in] TxStringLen Length of the HTTP message string in bytes.
1312 @retval EFI_SUCCESS The HTTP message is queued into TCP transmit queue.
1313 @retval Others Other error as indicated.
1318 IN HTTP_PROTOCOL
*HttpInstance
,
1319 IN HTTP_TOKEN_WRAP
*Wrap
,
1321 IN UINTN TxStringLen
1325 EFI_TCP4_IO_TOKEN
*Tx4Token
;
1326 EFI_TCP4_PROTOCOL
*Tcp4
;
1327 EFI_TCP6_IO_TOKEN
*Tx6Token
;
1328 EFI_TCP6_PROTOCOL
*Tcp6
;
1330 if (!HttpInstance
->LocalAddressIsIPv6
) {
1331 Tcp4
= HttpInstance
->Tcp4
;
1332 Tx4Token
= &Wrap
->TcpWrap
.Tx4Token
;
1334 Tx4Token
->Packet
.TxData
->DataLength
= (UINT32
) TxStringLen
;
1335 Tx4Token
->Packet
.TxData
->FragmentTable
[0].FragmentLength
= (UINT32
) TxStringLen
;
1336 Tx4Token
->Packet
.TxData
->FragmentTable
[0].FragmentBuffer
= (VOID
*) TxString
;
1337 Tx4Token
->CompletionToken
.Status
= EFI_NOT_READY
;
1339 Wrap
->TcpWrap
.IsTxDone
= FALSE
;
1340 Status
= Tcp4
->Transmit (Tcp4
, Tx4Token
);
1341 if (EFI_ERROR (Status
)) {
1342 DEBUG ((EFI_D_ERROR
, "Transmit failed: %r\n", Status
));
1347 Tcp6
= HttpInstance
->Tcp6
;
1348 Tx6Token
= &Wrap
->TcpWrap
.Tx6Token
;
1350 Tx6Token
->Packet
.TxData
->DataLength
= (UINT32
) TxStringLen
;
1351 Tx6Token
->Packet
.TxData
->FragmentTable
[0].FragmentLength
= (UINT32
) TxStringLen
;
1352 Tx6Token
->Packet
.TxData
->FragmentTable
[0].FragmentBuffer
= (VOID
*) TxString
;
1353 Tx6Token
->CompletionToken
.Status
= EFI_NOT_READY
;
1355 Wrap
->TcpWrap
.IsTxDone
= FALSE
;
1356 Status
= Tcp6
->Transmit (Tcp6
, Tx6Token
);
1357 if (EFI_ERROR (Status
)) {
1358 DEBUG ((EFI_D_ERROR
, "Transmit failed: %r\n", Status
));
1368 Translate the status code in HTTP message to EFI_HTTP_STATUS_CODE defined
1369 in UEFI 2.5 specification.
1371 @param[in] StatusCode The status code value in HTTP message.
1373 @return Value defined in EFI_HTTP_STATUS_CODE .
1376 EFI_HTTP_STATUS_CODE
1377 HttpMappingToStatusCode (
1381 switch (StatusCode
) {
1383 return HTTP_STATUS_100_CONTINUE
;
1385 return HTTP_STATUS_101_SWITCHING_PROTOCOLS
;
1387 return HTTP_STATUS_200_OK
;
1389 return HTTP_STATUS_201_CREATED
;
1391 return HTTP_STATUS_202_ACCEPTED
;
1393 return HTTP_STATUS_203_NON_AUTHORITATIVE_INFORMATION
;
1395 return HTTP_STATUS_204_NO_CONTENT
;
1397 return HTTP_STATUS_205_RESET_CONTENT
;
1399 return HTTP_STATUS_206_PARTIAL_CONTENT
;
1401 return HTTP_STATUS_300_MULTIPLE_CHIOCES
;
1403 return HTTP_STATUS_301_MOVED_PERMANENTLY
;
1405 return HTTP_STATUS_302_FOUND
;
1407 return HTTP_STATUS_303_SEE_OTHER
;
1409 return HTTP_STATUS_304_NOT_MODIFIED
;
1411 return HTTP_STATUS_305_USE_PROXY
;
1413 return HTTP_STATUS_307_TEMPORARY_REDIRECT
;
1415 return HTTP_STATUS_400_BAD_REQUEST
;
1417 return HTTP_STATUS_401_UNAUTHORIZED
;
1419 return HTTP_STATUS_402_PAYMENT_REQUIRED
;
1421 return HTTP_STATUS_403_FORBIDDEN
;
1423 return HTTP_STATUS_404_NOT_FOUND
;
1425 return HTTP_STATUS_405_METHOD_NOT_ALLOWED
;
1427 return HTTP_STATUS_406_NOT_ACCEPTABLE
;
1429 return HTTP_STATUS_407_PROXY_AUTHENTICATION_REQUIRED
;
1431 return HTTP_STATUS_408_REQUEST_TIME_OUT
;
1433 return HTTP_STATUS_409_CONFLICT
;
1435 return HTTP_STATUS_410_GONE
;
1437 return HTTP_STATUS_411_LENGTH_REQUIRED
;
1439 return HTTP_STATUS_412_PRECONDITION_FAILED
;
1441 return HTTP_STATUS_413_REQUEST_ENTITY_TOO_LARGE
;
1443 return HTTP_STATUS_414_REQUEST_URI_TOO_LARGE
;
1445 return HTTP_STATUS_415_UNSUPPORTED_MEDIA_TYPE
;
1447 return HTTP_STATUS_416_REQUESTED_RANGE_NOT_SATISFIED
;
1449 return HTTP_STATUS_417_EXPECTATION_FAILED
;
1451 return HTTP_STATUS_500_INTERNAL_SERVER_ERROR
;
1453 return HTTP_STATUS_501_NOT_IMPLEMENTED
;
1455 return HTTP_STATUS_502_BAD_GATEWAY
;
1457 return HTTP_STATUS_503_SERVICE_UNAVAILABLE
;
1459 return HTTP_STATUS_504_GATEWAY_TIME_OUT
;
1461 return HTTP_STATUS_505_HTTP_VERSION_NOT_SUPPORTED
;
1464 return HTTP_STATUS_UNSUPPORTED_STATUS
;
1469 Check whether the user's token or event has already
1470 been enqueue on HTTP Tx or Rx Token list.
1472 @param[in] Map The container of either user's transmit or receive
1474 @param[in] Item Current item to check against.
1475 @param[in] Context The Token to check againist.
1477 @retval EFI_ACCESS_DENIED The token or event has already been enqueued in IP
1478 @retval EFI_SUCCESS The current item isn't the same token/event as the
1486 IN NET_MAP_ITEM
*Item
,
1490 EFI_HTTP_TOKEN
*Token
;
1491 EFI_HTTP_TOKEN
*TokenInItem
;
1493 Token
= (EFI_HTTP_TOKEN
*) Context
;
1494 TokenInItem
= (EFI_HTTP_TOKEN
*) Item
->Key
;
1496 if (Token
== TokenInItem
|| Token
->Event
== TokenInItem
->Event
) {
1497 return EFI_ACCESS_DENIED
;
1504 Check whether the HTTP message associated with Tx4Token or Tx6Token is already sent out.
1506 @param[in] Map The container of Tx4Token or Tx6Token.
1507 @param[in] Item Current item to check against.
1508 @param[in] Context The Token to check againist.
1510 @retval EFI_NOT_READY The HTTP message is still queued in the list.
1511 @retval EFI_SUCCESS The HTTP message has been sent out.
1518 IN NET_MAP_ITEM
*Item
,
1522 HTTP_TOKEN_WRAP
*ValueInItem
;
1524 ValueInItem
= (HTTP_TOKEN_WRAP
*) Item
->Value
;
1526 if (!ValueInItem
->TcpWrap
.IsTxDone
) {
1527 return EFI_NOT_READY
;
1534 Transmit the HTTP mssage by processing the associated HTTP token.
1536 @param[in] Map The container of Tx4Token or Tx6Token.
1537 @param[in] Item Current item to check against.
1538 @param[in] Context The Token to check againist.
1540 @retval EFI_OUT_OF_RESOURCES Failed to allocate resources.
1541 @retval EFI_SUCCESS The HTTP message is queued into TCP transmit
1549 IN NET_MAP_ITEM
*Item
,
1553 HTTP_TOKEN_WRAP
*ValueInItem
;
1558 ValueInItem
= (HTTP_TOKEN_WRAP
*) Item
->Value
;
1559 if (ValueInItem
->TcpWrap
.IsTxDone
) {
1564 // Parse the URI of the remote host.
1566 Url
= AllocatePool (StrLen (ValueInItem
->HttpToken
->Message
->Data
.Request
->Url
) + 1);
1568 return EFI_OUT_OF_RESOURCES
;
1571 UnicodeStrToAsciiStr (ValueInItem
->HttpToken
->Message
->Data
.Request
->Url
, Url
);
1574 // Create request message.
1576 RequestStr
= HttpGenRequestString (
1577 ValueInItem
->HttpInstance
,
1578 ValueInItem
->HttpToken
->Message
,
1582 if (RequestStr
== NULL
) {
1583 return EFI_OUT_OF_RESOURCES
;
1587 // Transmit the request message.
1589 Status
= HttpTransmitTcp (
1590 ValueInItem
->HttpInstance
,
1592 (UINT8
*) RequestStr
,
1593 AsciiStrLen (RequestStr
)
1595 FreePool (RequestStr
);
1600 Receive the HTTP response by processing the associated HTTP token.
1602 @param[in] Map The container of Rx4Token or Rx6Token.
1603 @param[in] Item Current item to check against.
1604 @param[in] Context The Token to check againist.
1606 @retval EFI_SUCCESS The HTTP response is queued into TCP receive
1608 @retval Others Other error as indicated.
1615 IN NET_MAP_ITEM
*Item
,
1620 // Process the queued HTTP response.
1622 return HttpResponseWorker ((HTTP_TOKEN_WRAP
*) Item
->Value
);
1626 Receive the HTTP header by processing the associated HTTP token.
1628 @param[in] HttpInstance The HTTP instance private data.
1629 @param[in, out] SizeofHeaders The HTTP header length.
1630 @param[in, out] BufferSize The size of buffer to cacahe the header message.
1632 @retval EFI_SUCCESS The HTTP header is received.
1633 @retval Others Other errors as indicated.
1637 HttpTcpReceiveHeader (
1638 IN HTTP_PROTOCOL
*HttpInstance
,
1639 IN OUT UINTN
*SizeofHeaders
,
1640 IN OUT UINTN
*BufferSize
1644 EFI_TCP4_IO_TOKEN
*Rx4Token
;
1645 EFI_TCP4_PROTOCOL
*Tcp4
;
1646 EFI_TCP6_IO_TOKEN
*Rx6Token
;
1647 EFI_TCP6_PROTOCOL
*Tcp6
;
1648 CHAR8
**EndofHeader
;
1649 CHAR8
**HttpHeaders
;
1652 ASSERT (HttpInstance
!= NULL
);
1654 EndofHeader
= HttpInstance
->EndofHeader
;
1655 HttpHeaders
= HttpInstance
->HttpHeaders
;
1656 Tcp4
= HttpInstance
->Tcp4
;
1657 Tcp6
= HttpInstance
->Tcp6
;
1662 if (HttpInstance
->LocalAddressIsIPv6
) {
1663 ASSERT (Tcp6
!= NULL
);
1665 ASSERT (Tcp4
!= NULL
);
1668 if (!HttpInstance
->LocalAddressIsIPv6
) {
1669 Rx4Token
= &HttpInstance
->Rx4Token
;
1670 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= AllocateZeroPool (DEF_BUF_LEN
);
1671 if (Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
== NULL
) {
1672 Status
= EFI_OUT_OF_RESOURCES
;
1677 // Receive the HTTP headers only when EFI_HTTP_RESPONSE_DATA is not NULL.
1679 while (*EndofHeader
== NULL
) {
1680 HttpInstance
->IsRxDone
= FALSE
;
1681 Rx4Token
->Packet
.RxData
->DataLength
= DEF_BUF_LEN
;
1682 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentLength
= DEF_BUF_LEN
;
1683 Status
= Tcp4
->Receive (Tcp4
, Rx4Token
);
1684 if (EFI_ERROR (Status
)) {
1685 DEBUG ((EFI_D_ERROR
, "Tcp4 receive failed: %r\n", Status
));
1689 while (!HttpInstance
->IsRxDone
) {
1693 Status
= Rx4Token
->CompletionToken
.Status
;
1694 if (EFI_ERROR (Status
)) {
1699 // Append the response string.
1701 *BufferSize
= (*SizeofHeaders
) + Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentLength
;
1702 Buffer
= AllocateZeroPool (*BufferSize
);
1703 if (Buffer
== NULL
) {
1704 Status
= EFI_OUT_OF_RESOURCES
;
1708 if (*HttpHeaders
!= NULL
) {
1709 CopyMem (Buffer
, *HttpHeaders
, (*SizeofHeaders
));
1710 FreePool (*HttpHeaders
);
1714 Buffer
+ (*SizeofHeaders
),
1715 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
,
1716 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentLength
1718 *HttpHeaders
= Buffer
;
1719 *SizeofHeaders
= *BufferSize
;
1722 // Check whether we received end of HTTP headers.
1724 *EndofHeader
= AsciiStrStr (*HttpHeaders
, HTTP_END_OF_HDR_STR
);
1726 FreePool (Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
);
1727 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= NULL
;
1730 Rx6Token
= &HttpInstance
->Rx6Token
;
1731 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= AllocateZeroPool (DEF_BUF_LEN
);
1732 if (Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
== NULL
) {
1733 Status
= EFI_OUT_OF_RESOURCES
;
1738 // Receive the HTTP headers only when EFI_HTTP_RESPONSE_DATA is not NULL.
1740 while (*EndofHeader
== NULL
) {
1741 HttpInstance
->IsRxDone
= FALSE
;
1742 Rx6Token
->Packet
.RxData
->DataLength
= DEF_BUF_LEN
;
1743 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentLength
= DEF_BUF_LEN
;
1744 Status
= Tcp6
->Receive (Tcp6
, Rx6Token
);
1745 if (EFI_ERROR (Status
)) {
1746 DEBUG ((EFI_D_ERROR
, "Tcp6 receive failed: %r\n", Status
));
1750 while (!HttpInstance
->IsRxDone
) {
1754 Status
= Rx6Token
->CompletionToken
.Status
;
1755 if (EFI_ERROR (Status
)) {
1760 // Append the response string.
1762 *BufferSize
= (*SizeofHeaders
) + Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentLength
;
1763 Buffer
= AllocateZeroPool (*BufferSize
);
1764 if (Buffer
== NULL
) {
1765 Status
= EFI_OUT_OF_RESOURCES
;
1769 if (*HttpHeaders
!= NULL
) {
1770 CopyMem (Buffer
, *HttpHeaders
, (*SizeofHeaders
));
1771 FreePool (*HttpHeaders
);
1775 Buffer
+ (*SizeofHeaders
),
1776 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
,
1777 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentLength
1779 *HttpHeaders
= Buffer
;
1780 *SizeofHeaders
= *BufferSize
;
1783 // Check whether we received end of HTTP headers.
1785 *EndofHeader
= AsciiStrStr (*HttpHeaders
, HTTP_END_OF_HDR_STR
);
1788 FreePool (Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
);
1789 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= NULL
;
1793 // Skip the CRLF after the HTTP headers.
1795 *EndofHeader
= *EndofHeader
+ AsciiStrLen (HTTP_END_OF_HDR_STR
);
1801 Receive the HTTP body by processing the associated HTTP token.
1803 @param[in] Wrap The HTTP token's wrap data.
1804 @param[in] HttpMsg The HTTP message data.
1806 @retval EFI_SUCCESS The HTTP body is received.
1807 @retval Others Other error as indicated.
1811 HttpTcpReceiveBody (
1812 IN HTTP_TOKEN_WRAP
*Wrap
,
1813 IN EFI_HTTP_MESSAGE
*HttpMsg
1817 HTTP_PROTOCOL
*HttpInstance
;
1818 EFI_TCP6_PROTOCOL
*Tcp6
;
1819 EFI_TCP6_IO_TOKEN
*Rx6Token
;
1820 EFI_TCP4_PROTOCOL
*Tcp4
;
1821 EFI_TCP4_IO_TOKEN
*Rx4Token
;
1823 HttpInstance
= Wrap
->HttpInstance
;
1824 Tcp4
= HttpInstance
->Tcp4
;
1825 Tcp6
= HttpInstance
->Tcp6
;
1830 if (HttpInstance
->LocalAddressIsIPv6
) {
1831 ASSERT (Tcp6
!= NULL
);
1833 ASSERT (Tcp4
!= NULL
);
1836 if (HttpInstance
->LocalAddressIsIPv6
) {
1837 Rx6Token
= &Wrap
->TcpWrap
.Rx6Token
;
1838 Rx6Token
->Packet
.RxData
->DataLength
= (UINT32
) HttpMsg
->BodyLength
;
1839 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentLength
= (UINT32
) HttpMsg
->BodyLength
;
1840 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= (VOID
*) HttpMsg
->Body
;
1841 Rx6Token
->CompletionToken
.Status
= EFI_NOT_READY
;
1843 Status
= Tcp6
->Receive (Tcp6
, Rx6Token
);
1844 if (EFI_ERROR (Status
)) {
1845 DEBUG ((EFI_D_ERROR
, "Tcp6 receive failed: %r\n", Status
));
1850 Rx4Token
= &Wrap
->TcpWrap
.Rx4Token
;
1851 Rx4Token
->Packet
.RxData
->DataLength
= (UINT32
) HttpMsg
->BodyLength
;
1852 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentLength
= (UINT32
) HttpMsg
->BodyLength
;
1853 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= (VOID
*) HttpMsg
->Body
;
1855 Rx4Token
->CompletionToken
.Status
= EFI_NOT_READY
;
1856 Status
= Tcp4
->Receive (Tcp4
, Rx4Token
);
1857 if (EFI_ERROR (Status
)) {
1858 DEBUG ((EFI_D_ERROR
, "Tcp4 receive failed: %r\n", Status
));
1868 Clean up Tcp Tokens while the Tcp transmission error occurs.
1870 @param[in] Wrap Pointer to HTTP token's wrap data.
1874 HttpTcpTokenCleanup (
1875 IN HTTP_TOKEN_WRAP
*Wrap
1878 HTTP_PROTOCOL
*HttpInstance
;
1879 EFI_TCP4_IO_TOKEN
*Rx4Token
;
1880 EFI_TCP6_IO_TOKEN
*Rx6Token
;
1882 HttpInstance
= Wrap
->HttpInstance
;
1886 if (HttpInstance
->LocalAddressIsIPv6
) {
1888 if (Wrap
->TcpWrap
.Rx6Token
.CompletionToken
.Event
!= NULL
) {
1889 gBS
->CloseEvent (Wrap
->TcpWrap
.Rx6Token
.CompletionToken
.Event
);
1892 Rx6Token
= &Wrap
->TcpWrap
.Rx6Token
;
1893 if (Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
!= NULL
) {
1894 FreePool (Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
);
1895 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= NULL
;
1900 if (HttpInstance
->Rx6Token
.CompletionToken
.Event
!= NULL
) {
1901 gBS
->CloseEvent (HttpInstance
->Rx6Token
.CompletionToken
.Event
);
1902 HttpInstance
->Rx6Token
.CompletionToken
.Event
= NULL
;
1905 Rx6Token
= &HttpInstance
->Rx6Token
;
1906 if (Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
!= NULL
) {
1907 FreePool (Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
);
1908 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= NULL
;
1913 if (Wrap
->TcpWrap
.Rx4Token
.CompletionToken
.Event
!= NULL
) {
1914 gBS
->CloseEvent (Wrap
->TcpWrap
.Rx4Token
.CompletionToken
.Event
);
1916 Rx4Token
= &Wrap
->TcpWrap
.Rx4Token
;
1917 if (Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
!= NULL
) {
1918 FreePool (Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
);
1919 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= NULL
;
1924 if (HttpInstance
->Rx4Token
.CompletionToken
.Event
!= NULL
) {
1925 gBS
->CloseEvent (HttpInstance
->Rx4Token
.CompletionToken
.Event
);
1926 HttpInstance
->Rx4Token
.CompletionToken
.Event
= NULL
;
1929 Rx4Token
= &HttpInstance
->Rx4Token
;
1930 if (Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
!= NULL
) {
1931 FreePool (Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
);
1932 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= NULL
;
1939 Generate HTTP request string.
1941 @param[in] HttpInstance Pointer to HTTP_PROTOCOL structure.
1942 @param[in] Message Pointer to storage containing HTTP message data.
1943 @param[in] Url The URL of a remote host.
1945 @return Pointer to the created HTTP request string.
1946 @return NULL if any error occured.
1950 HttpGenRequestString (
1951 IN HTTP_PROTOCOL
*HttpInstance
,
1952 IN EFI_HTTP_MESSAGE
*Message
,
1964 EFI_HTTP_HEADER
**AppendList
;
1967 ASSERT (HttpInstance
!= NULL
);
1968 ASSERT (Message
!= NULL
);
1970 DEBUG ((EFI_D_ERROR
, "HttpMethod - %x\n", Message
->Data
.Request
->Method
));
1980 AppendList
= AllocateZeroPool (sizeof (EFI_HTTP_HEADER
*) * (Message
->HeaderCount
));
1981 if (AppendList
== NULL
) {
1985 for(Index
= 0; Index
< Message
->HeaderCount
; Index
++){
1986 AppendList
[Index
] = &Message
->Headers
[Index
];
1990 // Check whether the EFI_HTTP_UTILITIES_PROTOCOL is available.
1992 if (mHttpUtilities
== NULL
) {
1997 // Build raw unformatted HTTP headers.
1999 Status
= mHttpUtilities
->Build (
2005 Message
->HeaderCount
,
2010 FreePool (AppendList
);
2011 if (EFI_ERROR (Status
) || HttpHdr
== NULL
) {
2016 // Calculate HTTP message length.
2018 MsgSize
= Message
->BodyLength
+ HTTP_MAXIMUM_METHOD_LEN
+ AsciiStrLen (Url
) +
2019 AsciiStrLen (HTTP_VERSION_CRLF_STR
) + HttpHdrSize
;
2020 Request
= AllocateZeroPool (MsgSize
);
2021 if (Request
== NULL
) {
2025 RequestPtr
= Request
;
2027 // Construct header request
2029 switch (Message
->Data
.Request
->Method
) {
2031 StrLength
= sizeof (HTTP_GET_STR
) - 1;
2032 CopyMem (RequestPtr
, HTTP_GET_STR
, StrLength
);
2033 RequestPtr
+= StrLength
;
2035 case HttpMethodHead
:
2036 StrLength
= sizeof (HTTP_HEAD_STR
) - 1;
2037 CopyMem (RequestPtr
, HTTP_HEAD_STR
, StrLength
);
2038 RequestPtr
+= StrLength
;
2045 StrLength
= AsciiStrLen (Url
);
2046 CopyMem (RequestPtr
, Url
, StrLength
);
2047 RequestPtr
+= StrLength
;
2049 StrLength
= sizeof (HTTP_VERSION_CRLF_STR
) - 1;
2050 CopyMem (RequestPtr
, HTTP_VERSION_CRLF_STR
, StrLength
);
2051 RequestPtr
+= StrLength
;
2056 CopyMem (RequestPtr
, HttpHdr
, HttpHdrSize
);
2057 RequestPtr
+= HttpHdrSize
;
2062 if (Message
->Body
!= NULL
) {
2063 CopyMem (RequestPtr
, Message
->Body
, Message
->BodyLength
);
2064 RequestPtr
+= Message
->BodyLength
;
2076 if (Request
!= NULL
) {
2083 if (HttpHdr
!= NULL
) {
2087 return (CHAR8
*) Request
;