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
) {
1201 } else if (Tcp4State
> Tcp4StateEstablished
) {
1202 HttpCloseConnection(HttpInstance
);
1205 return HttpCreateConnection (HttpInstance
);
1209 Check existing TCP connection, if in error state, recover TCP6 connection.
1211 @param[in] HttpInstance The HTTP instance private data.
1213 @retval EFI_SUCCESS The TCP connection is established.
1214 @retval EFI_NOT_READY TCP6 protocol child is not created or configured.
1215 @retval Others Other error as indicated.
1220 IN HTTP_PROTOCOL
*HttpInstance
1224 EFI_TCP6_CONNECTION_STATE Tcp6State
;
1226 if (HttpInstance
->State
< HTTP_STATE_TCP_CONFIGED
|| HttpInstance
->Tcp6
== NULL
) {
1227 return EFI_NOT_READY
;
1230 Status
= HttpInstance
->Tcp6
->GetModeData (
1239 if (EFI_ERROR(Status
)){
1240 DEBUG ((EFI_D_ERROR
, "Tcp6 GetModeData fail - %x\n", Status
));
1244 if (Tcp6State
== Tcp6StateEstablished
) {
1246 } else if (Tcp6State
> Tcp6StateEstablished
) {
1247 HttpCloseConnection(HttpInstance
);
1250 return HttpCreateConnection (HttpInstance
);
1254 Initialize TCP related data.
1256 @param[in] HttpInstance The HTTP instance private data.
1257 @param[in] Wrap The HTTP token's wrap data.
1258 @param[in] Configure The Flag indicates whether the first time to initialize Tcp.
1260 @retval EFI_SUCCESS The initialization of TCP instance is done.
1261 @retval Others Other error as indicated.
1266 IN HTTP_PROTOCOL
*HttpInstance
,
1267 IN HTTP_TOKEN_WRAP
*Wrap
,
1268 IN BOOLEAN Configure
1272 ASSERT (HttpInstance
!= NULL
);
1274 if (!HttpInstance
->LocalAddressIsIPv6
) {
1276 // Configure TCP instance.
1279 Status
= HttpConfigureTcp4 (HttpInstance
, Wrap
);
1280 if (EFI_ERROR (Status
)) {
1288 Status
= HttpConnectTcp4 (HttpInstance
);
1289 if (EFI_ERROR (Status
)) {
1294 // Configure TCP instance.
1297 Status
= HttpConfigureTcp6 (HttpInstance
, Wrap
);
1298 if (EFI_ERROR (Status
)) {
1306 Status
= HttpConnectTcp6 (HttpInstance
);
1307 if (EFI_ERROR (Status
)) {
1317 Send the HTTP message through TCP4 or TCP6.
1319 @param[in] HttpInstance The HTTP instance private data.
1320 @param[in] Wrap The HTTP token's wrap data.
1321 @param[in] TxString Buffer containing the HTTP message string.
1322 @param[in] TxStringLen Length of the HTTP message string in bytes.
1324 @retval EFI_SUCCESS The HTTP message is queued into TCP transmit queue.
1325 @retval Others Other error as indicated.
1330 IN HTTP_PROTOCOL
*HttpInstance
,
1331 IN HTTP_TOKEN_WRAP
*Wrap
,
1333 IN UINTN TxStringLen
1337 EFI_TCP4_IO_TOKEN
*Tx4Token
;
1338 EFI_TCP4_PROTOCOL
*Tcp4
;
1339 EFI_TCP6_IO_TOKEN
*Tx6Token
;
1340 EFI_TCP6_PROTOCOL
*Tcp6
;
1342 if (!HttpInstance
->LocalAddressIsIPv6
) {
1343 Tcp4
= HttpInstance
->Tcp4
;
1344 Tx4Token
= &Wrap
->TcpWrap
.Tx4Token
;
1346 Tx4Token
->Packet
.TxData
->DataLength
= (UINT32
) TxStringLen
;
1347 Tx4Token
->Packet
.TxData
->FragmentTable
[0].FragmentLength
= (UINT32
) TxStringLen
;
1348 Tx4Token
->Packet
.TxData
->FragmentTable
[0].FragmentBuffer
= (VOID
*) TxString
;
1349 Tx4Token
->CompletionToken
.Status
= EFI_NOT_READY
;
1351 Wrap
->TcpWrap
.IsTxDone
= FALSE
;
1352 Status
= Tcp4
->Transmit (Tcp4
, Tx4Token
);
1353 if (EFI_ERROR (Status
)) {
1354 DEBUG ((EFI_D_ERROR
, "Transmit failed: %r\n", Status
));
1359 Tcp6
= HttpInstance
->Tcp6
;
1360 Tx6Token
= &Wrap
->TcpWrap
.Tx6Token
;
1362 Tx6Token
->Packet
.TxData
->DataLength
= (UINT32
) TxStringLen
;
1363 Tx6Token
->Packet
.TxData
->FragmentTable
[0].FragmentLength
= (UINT32
) TxStringLen
;
1364 Tx6Token
->Packet
.TxData
->FragmentTable
[0].FragmentBuffer
= (VOID
*) TxString
;
1365 Tx6Token
->CompletionToken
.Status
= EFI_NOT_READY
;
1367 Wrap
->TcpWrap
.IsTxDone
= FALSE
;
1368 Status
= Tcp6
->Transmit (Tcp6
, Tx6Token
);
1369 if (EFI_ERROR (Status
)) {
1370 DEBUG ((EFI_D_ERROR
, "Transmit failed: %r\n", Status
));
1380 Translate the status code in HTTP message to EFI_HTTP_STATUS_CODE defined
1381 in UEFI 2.5 specification.
1383 @param[in] StatusCode The status code value in HTTP message.
1385 @return Value defined in EFI_HTTP_STATUS_CODE .
1388 EFI_HTTP_STATUS_CODE
1389 HttpMappingToStatusCode (
1393 switch (StatusCode
) {
1395 return HTTP_STATUS_100_CONTINUE
;
1397 return HTTP_STATUS_101_SWITCHING_PROTOCOLS
;
1399 return HTTP_STATUS_200_OK
;
1401 return HTTP_STATUS_201_CREATED
;
1403 return HTTP_STATUS_202_ACCEPTED
;
1405 return HTTP_STATUS_203_NON_AUTHORITATIVE_INFORMATION
;
1407 return HTTP_STATUS_204_NO_CONTENT
;
1409 return HTTP_STATUS_205_RESET_CONTENT
;
1411 return HTTP_STATUS_206_PARTIAL_CONTENT
;
1413 return HTTP_STATUS_300_MULTIPLE_CHIOCES
;
1415 return HTTP_STATUS_301_MOVED_PERMANENTLY
;
1417 return HTTP_STATUS_302_FOUND
;
1419 return HTTP_STATUS_303_SEE_OTHER
;
1421 return HTTP_STATUS_304_NOT_MODIFIED
;
1423 return HTTP_STATUS_305_USE_PROXY
;
1425 return HTTP_STATUS_307_TEMPORARY_REDIRECT
;
1427 return HTTP_STATUS_400_BAD_REQUEST
;
1429 return HTTP_STATUS_401_UNAUTHORIZED
;
1431 return HTTP_STATUS_402_PAYMENT_REQUIRED
;
1433 return HTTP_STATUS_403_FORBIDDEN
;
1435 return HTTP_STATUS_404_NOT_FOUND
;
1437 return HTTP_STATUS_405_METHOD_NOT_ALLOWED
;
1439 return HTTP_STATUS_406_NOT_ACCEPTABLE
;
1441 return HTTP_STATUS_407_PROXY_AUTHENTICATION_REQUIRED
;
1443 return HTTP_STATUS_408_REQUEST_TIME_OUT
;
1445 return HTTP_STATUS_409_CONFLICT
;
1447 return HTTP_STATUS_410_GONE
;
1449 return HTTP_STATUS_411_LENGTH_REQUIRED
;
1451 return HTTP_STATUS_412_PRECONDITION_FAILED
;
1453 return HTTP_STATUS_413_REQUEST_ENTITY_TOO_LARGE
;
1455 return HTTP_STATUS_414_REQUEST_URI_TOO_LARGE
;
1457 return HTTP_STATUS_415_UNSUPPORTED_MEDIA_TYPE
;
1459 return HTTP_STATUS_416_REQUESTED_RANGE_NOT_SATISFIED
;
1461 return HTTP_STATUS_417_EXPECTATION_FAILED
;
1463 return HTTP_STATUS_500_INTERNAL_SERVER_ERROR
;
1465 return HTTP_STATUS_501_NOT_IMPLEMENTED
;
1467 return HTTP_STATUS_502_BAD_GATEWAY
;
1469 return HTTP_STATUS_503_SERVICE_UNAVAILABLE
;
1471 return HTTP_STATUS_504_GATEWAY_TIME_OUT
;
1473 return HTTP_STATUS_505_HTTP_VERSION_NOT_SUPPORTED
;
1476 return HTTP_STATUS_UNSUPPORTED_STATUS
;
1481 Check whether the user's token or event has already
1482 been enqueue on HTTP Tx or Rx Token list.
1484 @param[in] Map The container of either user's transmit or receive
1486 @param[in] Item Current item to check against.
1487 @param[in] Context The Token to check againist.
1489 @retval EFI_ACCESS_DENIED The token or event has already been enqueued in IP
1490 @retval EFI_SUCCESS The current item isn't the same token/event as the
1498 IN NET_MAP_ITEM
*Item
,
1502 EFI_HTTP_TOKEN
*Token
;
1503 EFI_HTTP_TOKEN
*TokenInItem
;
1505 Token
= (EFI_HTTP_TOKEN
*) Context
;
1506 TokenInItem
= (EFI_HTTP_TOKEN
*) Item
->Key
;
1508 if (Token
== TokenInItem
|| Token
->Event
== TokenInItem
->Event
) {
1509 return EFI_ACCESS_DENIED
;
1516 Check whether the HTTP message associated with Tx4Token or Tx6Token is already sent out.
1518 @param[in] Map The container of Tx4Token or Tx6Token.
1519 @param[in] Item Current item to check against.
1520 @param[in] Context The Token to check againist.
1522 @retval EFI_NOT_READY The HTTP message is still queued in the list.
1523 @retval EFI_SUCCESS The HTTP message has been sent out.
1530 IN NET_MAP_ITEM
*Item
,
1534 HTTP_TOKEN_WRAP
*ValueInItem
;
1536 ValueInItem
= (HTTP_TOKEN_WRAP
*) Item
->Value
;
1538 if (!ValueInItem
->TcpWrap
.IsTxDone
) {
1539 return EFI_NOT_READY
;
1546 Transmit the HTTP mssage by processing the associated HTTP token.
1548 @param[in] Map The container of Tx4Token or Tx6Token.
1549 @param[in] Item Current item to check against.
1550 @param[in] Context The Token to check againist.
1552 @retval EFI_OUT_OF_RESOURCES Failed to allocate resources.
1553 @retval EFI_SUCCESS The HTTP message is queued into TCP transmit
1561 IN NET_MAP_ITEM
*Item
,
1565 HTTP_TOKEN_WRAP
*ValueInItem
;
1570 ValueInItem
= (HTTP_TOKEN_WRAP
*) Item
->Value
;
1571 if (ValueInItem
->TcpWrap
.IsTxDone
) {
1576 // Parse the URI of the remote host.
1578 Url
= AllocatePool (StrLen (ValueInItem
->HttpToken
->Message
->Data
.Request
->Url
) + 1);
1580 return EFI_OUT_OF_RESOURCES
;
1583 UnicodeStrToAsciiStr (ValueInItem
->HttpToken
->Message
->Data
.Request
->Url
, Url
);
1586 // Create request message.
1588 RequestStr
= HttpGenRequestString (
1589 ValueInItem
->HttpInstance
,
1590 ValueInItem
->HttpToken
->Message
,
1594 if (RequestStr
== NULL
) {
1595 return EFI_OUT_OF_RESOURCES
;
1599 // Transmit the request message.
1601 Status
= HttpTransmitTcp (
1602 ValueInItem
->HttpInstance
,
1604 (UINT8
*) RequestStr
,
1605 AsciiStrLen (RequestStr
)
1607 FreePool (RequestStr
);
1612 Receive the HTTP response by processing the associated HTTP token.
1614 @param[in] Map The container of Rx4Token or Rx6Token.
1615 @param[in] Item Current item to check against.
1616 @param[in] Context The Token to check againist.
1618 @retval EFI_SUCCESS The HTTP response is queued into TCP receive
1620 @retval Others Other error as indicated.
1627 IN NET_MAP_ITEM
*Item
,
1632 // Process the queued HTTP response.
1634 return HttpResponseWorker ((HTTP_TOKEN_WRAP
*) Item
->Value
);
1638 Receive the HTTP header by processing the associated HTTP token.
1640 @param[in] HttpInstance The HTTP instance private data.
1641 @param[in, out] SizeofHeaders The HTTP header length.
1642 @param[in, out] BufferSize The size of buffer to cacahe the header message.
1644 @retval EFI_SUCCESS The HTTP header is received.
1645 @retval Others Other errors as indicated.
1649 HttpTcpReceiveHeader (
1650 IN HTTP_PROTOCOL
*HttpInstance
,
1651 IN OUT UINTN
*SizeofHeaders
,
1652 IN OUT UINTN
*BufferSize
1656 EFI_TCP4_IO_TOKEN
*Rx4Token
;
1657 EFI_TCP4_PROTOCOL
*Tcp4
;
1658 EFI_TCP6_IO_TOKEN
*Rx6Token
;
1659 EFI_TCP6_PROTOCOL
*Tcp6
;
1660 CHAR8
**EndofHeader
;
1661 CHAR8
**HttpHeaders
;
1664 ASSERT (HttpInstance
!= NULL
);
1666 EndofHeader
= HttpInstance
->EndofHeader
;
1667 HttpHeaders
= HttpInstance
->HttpHeaders
;
1668 Tcp4
= HttpInstance
->Tcp4
;
1669 Tcp6
= HttpInstance
->Tcp6
;
1674 if (HttpInstance
->LocalAddressIsIPv6
) {
1675 ASSERT (Tcp6
!= NULL
);
1677 ASSERT (Tcp4
!= NULL
);
1680 if (!HttpInstance
->LocalAddressIsIPv6
) {
1681 Rx4Token
= &HttpInstance
->Rx4Token
;
1682 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= AllocateZeroPool (DEF_BUF_LEN
);
1683 if (Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
== NULL
) {
1684 Status
= EFI_OUT_OF_RESOURCES
;
1689 // Receive the HTTP headers only when EFI_HTTP_RESPONSE_DATA is not NULL.
1691 while (*EndofHeader
== NULL
) {
1692 HttpInstance
->IsRxDone
= FALSE
;
1693 Rx4Token
->Packet
.RxData
->DataLength
= DEF_BUF_LEN
;
1694 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentLength
= DEF_BUF_LEN
;
1695 Status
= Tcp4
->Receive (Tcp4
, Rx4Token
);
1696 if (EFI_ERROR (Status
)) {
1697 DEBUG ((EFI_D_ERROR
, "Tcp4 receive failed: %r\n", Status
));
1701 while (!HttpInstance
->IsRxDone
) {
1705 Status
= Rx4Token
->CompletionToken
.Status
;
1706 if (EFI_ERROR (Status
)) {
1711 // Append the response string.
1713 *BufferSize
= (*SizeofHeaders
) + Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentLength
;
1714 Buffer
= AllocateZeroPool (*BufferSize
);
1715 if (Buffer
== NULL
) {
1716 Status
= EFI_OUT_OF_RESOURCES
;
1720 if (*HttpHeaders
!= NULL
) {
1721 CopyMem (Buffer
, *HttpHeaders
, (*SizeofHeaders
));
1722 FreePool (*HttpHeaders
);
1726 Buffer
+ (*SizeofHeaders
),
1727 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
,
1728 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentLength
1730 *HttpHeaders
= Buffer
;
1731 *SizeofHeaders
= *BufferSize
;
1734 // Check whether we received end of HTTP headers.
1736 *EndofHeader
= AsciiStrStr (*HttpHeaders
, HTTP_END_OF_HDR_STR
);
1738 FreePool (Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
);
1739 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= NULL
;
1742 Rx6Token
= &HttpInstance
->Rx6Token
;
1743 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= AllocateZeroPool (DEF_BUF_LEN
);
1744 if (Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
== NULL
) {
1745 Status
= EFI_OUT_OF_RESOURCES
;
1750 // Receive the HTTP headers only when EFI_HTTP_RESPONSE_DATA is not NULL.
1752 while (*EndofHeader
== NULL
) {
1753 HttpInstance
->IsRxDone
= FALSE
;
1754 Rx6Token
->Packet
.RxData
->DataLength
= DEF_BUF_LEN
;
1755 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentLength
= DEF_BUF_LEN
;
1756 Status
= Tcp6
->Receive (Tcp6
, Rx6Token
);
1757 if (EFI_ERROR (Status
)) {
1758 DEBUG ((EFI_D_ERROR
, "Tcp6 receive failed: %r\n", Status
));
1762 while (!HttpInstance
->IsRxDone
) {
1766 Status
= Rx6Token
->CompletionToken
.Status
;
1767 if (EFI_ERROR (Status
)) {
1772 // Append the response string.
1774 *BufferSize
= (*SizeofHeaders
) + Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentLength
;
1775 Buffer
= AllocateZeroPool (*BufferSize
);
1776 if (Buffer
== NULL
) {
1777 Status
= EFI_OUT_OF_RESOURCES
;
1781 if (*HttpHeaders
!= NULL
) {
1782 CopyMem (Buffer
, *HttpHeaders
, (*SizeofHeaders
));
1783 FreePool (*HttpHeaders
);
1787 Buffer
+ (*SizeofHeaders
),
1788 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
,
1789 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentLength
1791 *HttpHeaders
= Buffer
;
1792 *SizeofHeaders
= *BufferSize
;
1795 // Check whether we received end of HTTP headers.
1797 *EndofHeader
= AsciiStrStr (*HttpHeaders
, HTTP_END_OF_HDR_STR
);
1800 FreePool (Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
);
1801 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= NULL
;
1805 // Skip the CRLF after the HTTP headers.
1807 *EndofHeader
= *EndofHeader
+ AsciiStrLen (HTTP_END_OF_HDR_STR
);
1813 Receive the HTTP body by processing the associated HTTP token.
1815 @param[in] Wrap The HTTP token's wrap data.
1816 @param[in] HttpMsg The HTTP message data.
1818 @retval EFI_SUCCESS The HTTP body is received.
1819 @retval Others Other error as indicated.
1823 HttpTcpReceiveBody (
1824 IN HTTP_TOKEN_WRAP
*Wrap
,
1825 IN EFI_HTTP_MESSAGE
*HttpMsg
1829 HTTP_PROTOCOL
*HttpInstance
;
1830 EFI_TCP6_PROTOCOL
*Tcp6
;
1831 EFI_TCP6_IO_TOKEN
*Rx6Token
;
1832 EFI_TCP4_PROTOCOL
*Tcp4
;
1833 EFI_TCP4_IO_TOKEN
*Rx4Token
;
1835 HttpInstance
= Wrap
->HttpInstance
;
1836 Tcp4
= HttpInstance
->Tcp4
;
1837 Tcp6
= HttpInstance
->Tcp6
;
1842 if (HttpInstance
->LocalAddressIsIPv6
) {
1843 ASSERT (Tcp6
!= NULL
);
1845 ASSERT (Tcp4
!= NULL
);
1848 if (HttpInstance
->LocalAddressIsIPv6
) {
1849 Rx6Token
= &Wrap
->TcpWrap
.Rx6Token
;
1850 Rx6Token
->Packet
.RxData
->DataLength
= (UINT32
) HttpMsg
->BodyLength
;
1851 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentLength
= (UINT32
) HttpMsg
->BodyLength
;
1852 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= (VOID
*) HttpMsg
->Body
;
1853 Rx6Token
->CompletionToken
.Status
= EFI_NOT_READY
;
1855 Status
= Tcp6
->Receive (Tcp6
, Rx6Token
);
1856 if (EFI_ERROR (Status
)) {
1857 DEBUG ((EFI_D_ERROR
, "Tcp6 receive failed: %r\n", Status
));
1862 Rx4Token
= &Wrap
->TcpWrap
.Rx4Token
;
1863 Rx4Token
->Packet
.RxData
->DataLength
= (UINT32
) HttpMsg
->BodyLength
;
1864 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentLength
= (UINT32
) HttpMsg
->BodyLength
;
1865 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= (VOID
*) HttpMsg
->Body
;
1867 Rx4Token
->CompletionToken
.Status
= EFI_NOT_READY
;
1868 Status
= Tcp4
->Receive (Tcp4
, Rx4Token
);
1869 if (EFI_ERROR (Status
)) {
1870 DEBUG ((EFI_D_ERROR
, "Tcp4 receive failed: %r\n", Status
));
1880 Clean up Tcp Tokens while the Tcp transmission error occurs.
1882 @param[in] Wrap Pointer to HTTP token's wrap data.
1886 HttpTcpTokenCleanup (
1887 IN HTTP_TOKEN_WRAP
*Wrap
1890 HTTP_PROTOCOL
*HttpInstance
;
1891 EFI_TCP4_IO_TOKEN
*Rx4Token
;
1892 EFI_TCP6_IO_TOKEN
*Rx6Token
;
1894 HttpInstance
= Wrap
->HttpInstance
;
1898 if (HttpInstance
->LocalAddressIsIPv6
) {
1900 if (Wrap
->TcpWrap
.Rx6Token
.CompletionToken
.Event
!= NULL
) {
1901 gBS
->CloseEvent (Wrap
->TcpWrap
.Rx6Token
.CompletionToken
.Event
);
1904 Rx6Token
= &Wrap
->TcpWrap
.Rx6Token
;
1905 if (Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
!= NULL
) {
1906 FreePool (Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
);
1907 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= NULL
;
1912 if (HttpInstance
->Rx6Token
.CompletionToken
.Event
!= NULL
) {
1913 gBS
->CloseEvent (HttpInstance
->Rx6Token
.CompletionToken
.Event
);
1914 HttpInstance
->Rx6Token
.CompletionToken
.Event
= NULL
;
1917 Rx6Token
= &HttpInstance
->Rx6Token
;
1918 if (Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
!= NULL
) {
1919 FreePool (Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
);
1920 Rx6Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= NULL
;
1925 if (Wrap
->TcpWrap
.Rx4Token
.CompletionToken
.Event
!= NULL
) {
1926 gBS
->CloseEvent (Wrap
->TcpWrap
.Rx4Token
.CompletionToken
.Event
);
1928 Rx4Token
= &Wrap
->TcpWrap
.Rx4Token
;
1929 if (Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
!= NULL
) {
1930 FreePool (Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
);
1931 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= NULL
;
1936 if (HttpInstance
->Rx4Token
.CompletionToken
.Event
!= NULL
) {
1937 gBS
->CloseEvent (HttpInstance
->Rx4Token
.CompletionToken
.Event
);
1938 HttpInstance
->Rx4Token
.CompletionToken
.Event
= NULL
;
1941 Rx4Token
= &HttpInstance
->Rx4Token
;
1942 if (Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
!= NULL
) {
1943 FreePool (Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
);
1944 Rx4Token
->Packet
.RxData
->FragmentTable
[0].FragmentBuffer
= NULL
;
1951 Generate HTTP request string.
1953 @param[in] HttpInstance Pointer to HTTP_PROTOCOL structure.
1954 @param[in] Message Pointer to storage containing HTTP message data.
1955 @param[in] Url The URL of a remote host.
1957 @return Pointer to the created HTTP request string.
1958 @return NULL if any error occured.
1962 HttpGenRequestString (
1963 IN HTTP_PROTOCOL
*HttpInstance
,
1964 IN EFI_HTTP_MESSAGE
*Message
,
1976 EFI_HTTP_HEADER
**AppendList
;
1979 ASSERT (HttpInstance
!= NULL
);
1980 ASSERT (Message
!= NULL
);
1982 DEBUG ((EFI_D_ERROR
, "HttpMethod - %x\n", Message
->Data
.Request
->Method
));
1992 AppendList
= AllocateZeroPool (sizeof (EFI_HTTP_HEADER
*) * (Message
->HeaderCount
));
1993 if (AppendList
== NULL
) {
1997 for(Index
= 0; Index
< Message
->HeaderCount
; Index
++){
1998 AppendList
[Index
] = &Message
->Headers
[Index
];
2002 // Check whether the EFI_HTTP_UTILITIES_PROTOCOL is available.
2004 if (mHttpUtilities
== NULL
) {
2009 // Build raw unformatted HTTP headers.
2011 Status
= mHttpUtilities
->Build (
2017 Message
->HeaderCount
,
2022 FreePool (AppendList
);
2023 if (EFI_ERROR (Status
) || HttpHdr
== NULL
) {
2028 // Calculate HTTP message length.
2030 MsgSize
= Message
->BodyLength
+ HTTP_MAXIMUM_METHOD_LEN
+ AsciiStrLen (Url
) +
2031 AsciiStrLen (HTTP_VERSION_CRLF_STR
) + HttpHdrSize
;
2032 Request
= AllocateZeroPool (MsgSize
);
2033 if (Request
== NULL
) {
2037 RequestPtr
= Request
;
2039 // Construct header request
2041 switch (Message
->Data
.Request
->Method
) {
2043 StrLength
= sizeof (HTTP_GET_STR
) - 1;
2044 CopyMem (RequestPtr
, HTTP_GET_STR
, StrLength
);
2045 RequestPtr
+= StrLength
;
2047 case HttpMethodHead
:
2048 StrLength
= sizeof (HTTP_HEAD_STR
) - 1;
2049 CopyMem (RequestPtr
, HTTP_HEAD_STR
, StrLength
);
2050 RequestPtr
+= StrLength
;
2057 StrLength
= AsciiStrLen (Url
);
2058 CopyMem (RequestPtr
, Url
, StrLength
);
2059 RequestPtr
+= StrLength
;
2061 StrLength
= sizeof (HTTP_VERSION_CRLF_STR
) - 1;
2062 CopyMem (RequestPtr
, HTTP_VERSION_CRLF_STR
, StrLength
);
2063 RequestPtr
+= StrLength
;
2068 CopyMem (RequestPtr
, HttpHdr
, HttpHdrSize
);
2069 RequestPtr
+= HttpHdrSize
;
2074 if (Message
->Body
!= NULL
) {
2075 CopyMem (RequestPtr
, Message
->Body
, Message
->BodyLength
);
2076 RequestPtr
+= Message
->BodyLength
;
2088 if (Request
!= NULL
) {
2095 if (HttpHdr
!= NULL
) {
2099 return (CHAR8
*) Request
;