2 Support for PxeBc dhcp functions.
4 Copyright (c) 2007 - 2009, Intel Corporation.<BR>
5 All rights reserved. This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
16 #include "PxeBcImpl.h"
19 // This is a map from the interested DHCP4 option tags' index to the tag value.
21 UINT8 mInterestedDhcp4Tags
[PXEBC_DHCP4_TAG_INDEX_MAX
] = {
22 PXEBC_DHCP4_TAG_BOOTFILE_LEN
,
23 PXEBC_DHCP4_TAG_VENDOR
,
24 PXEBC_DHCP4_TAG_OVERLOAD
,
25 PXEBC_DHCP4_TAG_MSG_TYPE
,
26 PXEBC_DHCP4_TAG_SERVER_ID
,
27 PXEBC_DHCP4_TAG_CLASS_ID
,
28 PXEBC_DHCP4_TAG_BOOTFILE
33 This function initialize the DHCP4 message instance.
35 This function will pad each item of dhcp4 message packet.
37 @param Seed Pointer to the message instance of the DHCP4 packet.
38 @param Udp4 Pointer to the EFI_UDP4_PROTOCOL instance.
45 IN EFI_DHCP4_PACKET
*Seed
,
46 IN EFI_UDP4_PROTOCOL
*Udp4
49 EFI_SIMPLE_NETWORK_MODE Mode
;
50 EFI_DHCP4_HEADER
*Header
;
52 Udp4
->GetModeData (Udp4
, NULL
, NULL
, NULL
, &Mode
);
54 Seed
->Size
= sizeof (EFI_DHCP4_PACKET
);
55 Seed
->Length
= sizeof (Seed
->Dhcp4
);
57 Header
= &Seed
->Dhcp4
.Header
;
59 ZeroMem (Header
, sizeof (EFI_DHCP4_HEADER
));
60 Header
->OpCode
= PXEBC_DHCP4_OPCODE_REQUEST
;
61 Header
->HwType
= Mode
.IfType
;
62 Header
->HwAddrLen
= (UINT8
) Mode
.HwAddressSize
;
63 CopyMem (Header
->ClientHwAddr
, &Mode
.CurrentAddress
, Header
->HwAddrLen
);
65 Seed
->Dhcp4
.Magik
= PXEBC_DHCP4_MAGIC
;
66 Seed
->Dhcp4
.Option
[0] = PXEBC_DHCP4_TAG_EOP
;
71 Copy the DCHP4 packet from srouce to destination.
73 @param Dst Pointer to the EFI_DHCP4_PROTOCOL instance.
74 @param Src Pointer to the EFI_DHCP4_PROTOCOL instance.
80 PxeBcCopyEfiDhcp4Packet (
81 IN EFI_DHCP4_PACKET
*Dst
,
82 IN EFI_DHCP4_PACKET
*Src
85 ASSERT (Dst
->Size
>= Src
->Length
);
87 CopyMem (&Dst
->Dhcp4
, &Src
->Dhcp4
, Src
->Length
);
88 Dst
->Length
= Src
->Length
;
93 Copy the dhcp4 packet to the PxeBc private data and parse the dhcp4 packet.
95 @param Private Pointer to PxeBc private data.
96 @param OfferIndex Index of cached packets as complements of pxe mode data,
97 the index is maximum offer number.
103 PxeBcCopyProxyOffer (
104 IN PXEBC_PRIVATE_DATA
*Private
,
108 EFI_PXE_BASE_CODE_MODE
*Mode
;
109 EFI_DHCP4_PACKET
*Offer
;
111 ASSERT (OfferIndex
< Private
->NumOffers
);
113 Mode
= Private
->PxeBc
.Mode
;
114 Offer
= &Private
->Dhcp4Offers
[OfferIndex
].Packet
.Offer
;
116 PxeBcCopyEfiDhcp4Packet (&Private
->ProxyOffer
.Packet
.Offer
, Offer
);
117 CopyMem (&Mode
->ProxyOffer
, &Offer
->Dhcp4
, Offer
->Length
);
118 Mode
->ProxyOfferReceived
= TRUE
;
120 PxeBcParseCachedDhcpPacket (&Private
->ProxyOffer
);
125 Parse the cached dhcp packet.
127 @param CachedPacket Pointer to cached dhcp packet.
129 @retval TRUE Succeed to parse and validation.
130 @retval FALSE Fail to parse or validation.
134 PxeBcParseCachedDhcpPacket (
135 IN PXEBC_CACHED_DHCP4_PACKET
*CachedPacket
138 EFI_DHCP4_PACKET
*Offer
;
139 EFI_DHCP4_PACKET_OPTION
**Options
;
140 EFI_DHCP4_PACKET_OPTION
*Option
;
144 CachedPacket
->IsPxeOffer
= FALSE
;
145 ZeroMem (CachedPacket
->Dhcp4Option
, sizeof (CachedPacket
->Dhcp4Option
));
146 ZeroMem (&CachedPacket
->PxeVendorOption
, sizeof (CachedPacket
->PxeVendorOption
));
148 Offer
= &CachedPacket
->Packet
.Offer
;
149 Options
= CachedPacket
->Dhcp4Option
;
152 // Parse interested dhcp options and store their pointers in CachedPacket->Dhcp4Option.
154 for (Index
= 0; Index
< PXEBC_DHCP4_TAG_INDEX_MAX
; Index
++) {
155 Options
[Index
] = PxeBcParseExtendOptions (
157 GET_OPTION_BUFFER_LEN (Offer
),
158 mInterestedDhcp4Tags
[Index
]
163 // Check whether is an offer with PXEClient or not.
165 Option
= Options
[PXEBC_DHCP4_TAG_INDEX_CLASS_ID
];
166 if ((Option
!= NULL
) && (Option
->Length
>= 9) &&
167 (CompareMem (Option
->Data
, DEFAULT_CLASS_ID_DATA
, 9) == 0)) {
169 CachedPacket
->IsPxeOffer
= TRUE
;
173 // Parse pxe vendor options and store their content/pointers in CachedPacket->PxeVendorOption.
175 Option
= Options
[PXEBC_DHCP4_TAG_INDEX_VENDOR
];
176 if (CachedPacket
->IsPxeOffer
&& (Option
!= NULL
)) {
178 if (!PxeBcParseVendorOptions (Option
, &CachedPacket
->PxeVendorOption
)) {
184 // Check whether bootfilename/serverhostname overloaded (See details in dhcp spec).
185 // If overloaded, parse this buffer as nested dhcp options, or just parse bootfilename/
186 // serverhostname option.
188 Option
= Options
[PXEBC_DHCP4_TAG_INDEX_OVERLOAD
];
189 if ((Option
!= NULL
) && (Option
->Data
[0] & PXEBC_DHCP4_OVERLOAD_FILE
)) {
191 Options
[PXEBC_DHCP4_TAG_INDEX_BOOTFILE
] = PxeBcParseExtendOptions (
192 (UINT8
*) Offer
->Dhcp4
.Header
.BootFileName
,
193 sizeof (Offer
->Dhcp4
.Header
.BootFileName
),
194 PXEBC_DHCP4_TAG_BOOTFILE
197 } else if ((Options
[PXEBC_DHCP4_TAG_INDEX_BOOTFILE
] == NULL
) &&
198 (Offer
->Dhcp4
.Header
.BootFileName
[0] != 0)) {
200 // If the bootfile is not present and bootfilename is present in dhcp packet, just parse it.
201 // And do not count dhcp option header, or else will destory the serverhostname.
203 Options
[PXEBC_DHCP4_TAG_INDEX_BOOTFILE
] = (EFI_DHCP4_PACKET_OPTION
*) (&Offer
->Dhcp4
.Header
.BootFileName
[0] -
204 OFFSET_OF (EFI_DHCP4_PACKET_OPTION
, Data
[0]));
209 // Determine offer type of the dhcp packet.
211 Option
= Options
[PXEBC_DHCP4_TAG_INDEX_MSG_TYPE
];
212 if ((Option
== NULL
) || (Option
->Data
[0] == 0)) {
214 // It's a bootp offer
216 Option
= CachedPacket
->Dhcp4Option
[PXEBC_DHCP4_TAG_INDEX_BOOTFILE
];
217 if (Option
== NULL
) {
219 // bootp offer without bootfilename, discard it.
224 OfferType
= DHCP4_PACKET_TYPE_BOOTP
;
228 if (IS_VALID_DISCOVER_VENDOR_OPTION (CachedPacket
->PxeVendorOption
.BitMap
)) {
230 // It's a pxe10 offer with PXEClient and discover vendor option.
232 OfferType
= DHCP4_PACKET_TYPE_PXE10
;
233 } else if (IS_VALID_MTFTP_VENDOR_OPTION (CachedPacket
->PxeVendorOption
.BitMap
)) {
235 // It's a wfm11a offer with PXEClient and mtftp vendor option, and
236 // return false since mtftp not supported currently.
241 // If the binl offer with only PXEClient.
243 OfferType
= (UINT8
) ((CachedPacket
->IsPxeOffer
) ? DHCP4_PACKET_TYPE_BINL
: DHCP4_PACKET_TYPE_DHCP_ONLY
);
247 CachedPacket
->OfferType
= OfferType
;
254 Offer dhcp service with a BINL dhcp offer.
256 @param Private Pointer to PxeBc private data.
257 @param Index Index of cached packets as complements of pxe mode data,
258 the index is maximum offer number.
260 @retval TRUE Offer the service successfully under priority BINL.
261 @retval FALSE Boot Service failed, parse cached dhcp packet failed or this
262 BINL ack cannot find options set or bootfile name specified.
267 IN PXEBC_PRIVATE_DATA
*Private
,
271 EFI_DHCP4_PACKET
*Offer
;
272 EFI_IP_ADDRESS ServerIp
;
274 PXEBC_CACHED_DHCP4_PACKET
*CachedPacket
;
275 EFI_DHCP4_PACKET
*Reply
;
277 ASSERT (Index
< PXEBC_MAX_OFFER_NUM
);
278 ASSERT (Private
->Dhcp4Offers
[Index
].OfferType
== DHCP4_PACKET_TYPE_BINL
);
280 Offer
= &Private
->Dhcp4Offers
[Index
].Packet
.Offer
;
283 // use option 54, if zero, use siaddr in header
285 ZeroMem (&ServerIp
, sizeof(EFI_IP_ADDRESS
));
286 if (Private
->Dhcp4Offers
[Index
].Dhcp4Option
[PXEBC_DHCP4_TAG_INDEX_SERVER_ID
] != NULL
) {
289 Private
->Dhcp4Offers
[Index
].Dhcp4Option
[PXEBC_DHCP4_TAG_INDEX_SERVER_ID
]->Data
,
290 sizeof (EFI_IPv4_ADDRESS
)
295 &Offer
->Dhcp4
.Header
.ServerAddr
,
296 sizeof (EFI_IPv4_ADDRESS
)
299 if (ServerIp
.Addr
[0] == 0) {
303 CachedPacket
= &Private
->ProxyOffer
;
304 Reply
= &CachedPacket
->Packet
.Offer
;
306 Status
= PxeBcDiscvBootService (
317 if (EFI_ERROR (Status
)) {
321 if (!PxeBcParseCachedDhcpPacket (CachedPacket
)) {
325 if ((CachedPacket
->OfferType
!= DHCP4_PACKET_TYPE_PXE10
) &&
326 (CachedPacket
->Dhcp4Option
[PXEBC_DHCP4_TAG_INDEX_BOOTFILE
] == NULL
)) {
328 // This BINL ack doesn't have discovery options set or bootfile name
334 Private
->PxeBc
.Mode
->ProxyOfferReceived
= TRUE
;
335 CopyMem (&Private
->PxeBc
.Mode
->ProxyOffer
, &Reply
->Dhcp4
, Reply
->Length
);
342 Offer dhcp service for each proxy with a BINL dhcp offer.
344 @param Private Pointer to PxeBc private data
345 @param OfferIndex Pointer to the index of cached packets as complements of
346 pxe mode data, the index is maximum offer number.
348 @return If there is no service needed offer return FALSE, otherwise TRUE.
353 IN PXEBC_PRIVATE_DATA
*Private
,
354 OUT UINT32
*OfferIndex
359 for (Index
= 0; Index
< Private
->ProxyIndex
[DHCP4_PACKET_TYPE_BINL
]; Index
++) {
361 *OfferIndex
= Private
->BinlIndex
[Index
];
363 // Try this BINL proxy offer
365 if (PxeBcTryBinl (Private
, *OfferIndex
)) {
375 This function is to check the selected proxy offer (include BINL dhcp offer and
376 DHCP_ONLY offer ) and set the flag and copy the DHCP packets to the Pxe base code
379 @param Private Pointer to PxeBc private data.
381 @retval EFI_SUCCESS Operational successful.
382 @retval EFI_NO_RESPONSE Offer dhcp service failed.
386 PxeBcCheckSelectedOffer (
387 IN PXEBC_PRIVATE_DATA
*Private
390 PXEBC_CACHED_DHCP4_PACKET
*SelectedOffer
;
391 EFI_DHCP4_PACKET_OPTION
**Options
;
393 EFI_DHCP4_PACKET
*Offer
;
394 UINT32 ProxyOfferIndex
;
396 EFI_PXE_BASE_CODE_MODE
*Mode
;
397 EFI_DHCP4_PACKET
*Ack
;
399 ASSERT (Private
->SelectedOffer
!= 0);
401 Status
= EFI_SUCCESS
;
402 SelectedOffer
= &Private
->Dhcp4Offers
[Private
->SelectedOffer
- 1];
403 Options
= SelectedOffer
->Dhcp4Option
;
405 if (SelectedOffer
->OfferType
== DHCP4_PACKET_TYPE_BINL
) {
407 // The addresses are acquired from a BINL dhcp offer, try BINL to get
410 if (!PxeBcTryBinl (Private
, Private
->SelectedOffer
- 1)) {
411 Status
= EFI_NO_RESPONSE
;
413 } else if (SelectedOffer
->OfferType
== DHCP4_PACKET_TYPE_DHCP_ONLY
) {
415 // The selected offer to finish the D.O.R.A. is a DHCP only offer, we need
416 // try proxy offers if there are some, othewise the bootfile name must be
417 // set in this DHCP only offer.
419 if (Private
->GotProxyOffer
) {
421 // Get rid of the compiler warning.
424 if (Private
->SortOffers
) {
426 // The offers are sorted before selecting, the proxy offer type must be
427 // already determined.
429 ASSERT (Private
->ProxyIndex
[Private
->ProxyOfferType
] > 0);
431 if (Private
->ProxyOfferType
== DHCP4_PACKET_TYPE_BINL
) {
433 // We buffer all received BINL proxy offers, try them all one by one
435 if (!PxeBcTryBinlProxy (Private
, &ProxyOfferIndex
)) {
436 Status
= EFI_NO_RESPONSE
;
440 // For other types, only one proxy offer is buffered.
442 ProxyOfferIndex
= Private
->ProxyIndex
[Private
->ProxyOfferType
] - 1;
446 // The proxy offer type is not determined, choose proxy offer in the
449 Status
= EFI_NO_RESPONSE
;
451 for (Index
= 0; Index
< Private
->NumOffers
; Index
++) {
453 Offer
= &Private
->Dhcp4Offers
[Index
].Packet
.Offer
;
454 if (!IS_PROXY_DHCP_OFFER (Offer
)) {
456 // Skip non proxy dhcp offers.
461 if (Private
->Dhcp4Offers
[Index
].OfferType
== DHCP4_PACKET_TYPE_BINL
) {
465 if (!PxeBcTryBinl (Private
, Index
)) {
467 // Failed, skip to the next offer
473 Private
->ProxyOfferType
= Private
->Dhcp4Offers
[Index
].OfferType
;
474 ProxyOfferIndex
= Index
;
475 Status
= EFI_SUCCESS
;
480 if (!EFI_ERROR (Status
) && (Private
->ProxyOfferType
!= DHCP4_PACKET_TYPE_BINL
)) {
482 // Copy the proxy offer to Mode and set the flag
484 PxeBcCopyProxyOffer (Private
, ProxyOfferIndex
);
488 // No proxy offer is received, the bootfile name MUST be set.
490 ASSERT (Options
[PXEBC_DHCP4_TAG_INDEX_BOOTFILE
] != NULL
);
494 if (!EFI_ERROR (Status
)) {
496 // Everything is OK, set the flag and copy the DHCP packets.
498 Mode
= Private
->PxeBc
.Mode
;
499 Offer
= &SelectedOffer
->Packet
.Offer
;
502 // The discover packet is already copied, just set flag here.
504 Mode
->DhcpDiscoverValid
= TRUE
;
506 Ack
= &Private
->Dhcp4Ack
.Packet
.Ack
;
507 if (SelectedOffer
->OfferType
== DHCP4_PACKET_TYPE_BOOTP
) {
509 // Other type of ACK is already cached. Bootp is special that we should
510 // use the bootp reply as the ACK and put it into the DHCP_ONLY buffer.
512 PxeBcCopyEfiDhcp4Packet (&Private
->Dhcp4Ack
.Packet
.Ack
, Offer
);
515 PxeBcParseCachedDhcpPacket (&Private
->Dhcp4Ack
);
517 Mode
->DhcpAckReceived
= TRUE
;
520 // Copy the dhcp ack.
522 CopyMem (&Mode
->DhcpAck
, &Ack
->Dhcp4
, Ack
->Length
);
530 Cache the Dhcp4 packet offer, Parse and validate each option of the packet.
532 @param Private Pointer to PxeBc private data.
533 @param RcvdOffer Pointer to the received Dhcp proxy offer packet.
539 PxeBcCacheDhcpOffer (
540 IN PXEBC_PRIVATE_DATA
*Private
,
541 IN EFI_DHCP4_PACKET
*RcvdOffer
544 PXEBC_CACHED_DHCP4_PACKET
*CachedOffer
;
545 EFI_DHCP4_PACKET
*Offer
;
548 CachedOffer
= &Private
->Dhcp4Offers
[Private
->NumOffers
];
549 Offer
= &CachedOffer
->Packet
.Offer
;
552 // Cache the orignal dhcp packet
554 PxeBcCopyEfiDhcp4Packet (Offer
, RcvdOffer
);
557 // Parse and validate the options (including dhcp option and vendor option)
559 if (!PxeBcParseCachedDhcpPacket (CachedOffer
)) {
563 OfferType
= CachedOffer
->OfferType
;
564 ASSERT (OfferType
< DHCP4_PACKET_TYPE_MAX
);
566 if (OfferType
== DHCP4_PACKET_TYPE_BOOTP
) {
568 if (Private
->BootpIndex
!= 0) {
570 // Only cache the first bootp offer, discard others.
575 // Take as a dhcp only offer, but record index specifically.
577 Private
->BootpIndex
= Private
->NumOffers
+ 1;
581 if (IS_PROXY_DHCP_OFFER (Offer
)) {
583 // It's a proxy dhcp offer with no your address, including pxe10, wfm11a or binl offer.
585 Private
->GotProxyOffer
= TRUE
;
587 if (OfferType
== DHCP4_PACKET_TYPE_BINL
) {
589 // Cache all binl offers.
591 Private
->BinlIndex
[Private
->ProxyIndex
[DHCP4_PACKET_TYPE_BINL
]] = Private
->NumOffers
;
592 Private
->ProxyIndex
[DHCP4_PACKET_TYPE_BINL
]++;
593 } else if (Private
->ProxyIndex
[OfferType
] != 0) {
595 // Only cache the first pxe10/wfm11a offers each, discard the others.
600 // Record index of the proxy dhcp offer with type other than binl.
602 Private
->ProxyIndex
[OfferType
] = Private
->NumOffers
+ 1;
606 // It's a dhcp offer with your address.
608 ASSERT (Private
->ServerCount
[OfferType
] < PXEBC_MAX_OFFER_NUM
);
609 Private
->OfferIndex
[OfferType
][Private
->ServerCount
[OfferType
]] = Private
->NumOffers
;
610 Private
->ServerCount
[OfferType
]++;
615 // Count the accepted offers.
617 Private
->NumOffers
++;
622 Select the specified proxy offer, such as BINL, DHCP_ONLY and so on.
623 If the proxy does not exist, try offers with bootfile.
625 @param Private Pointer to PxeBc private data.
632 IN PXEBC_PRIVATE_DATA
*Private
637 EFI_DHCP4_PACKET
*Offer
;
639 Private
->SelectedOffer
= 0;
641 if (Private
->SortOffers
) {
643 // Select offer according to the priority
645 if (Private
->ServerCount
[DHCP4_PACKET_TYPE_PXE10
] > 0) {
649 Private
->SelectedOffer
= Private
->OfferIndex
[DHCP4_PACKET_TYPE_PXE10
][0] + 1;
651 } else if (Private
->ServerCount
[DHCP4_PACKET_TYPE_WFM11A
] > 0) {
655 Private
->SelectedOffer
= Private
->OfferIndex
[DHCP4_PACKET_TYPE_WFM11A
][0] + 1;
657 } else if ((Private
->ProxyIndex
[DHCP4_PACKET_TYPE_PXE10
] > 0) &&
658 (Private
->ServerCount
[DHCP4_PACKET_TYPE_DHCP_ONLY
] > 0)
661 // DHCP only and proxy DHCP with PXE10
663 Private
->SelectedOffer
= Private
->OfferIndex
[DHCP4_PACKET_TYPE_DHCP_ONLY
][0] + 1;
664 Private
->ProxyOfferType
= DHCP4_PACKET_TYPE_PXE10
;
666 } else if ((Private
->ProxyIndex
[DHCP4_PACKET_TYPE_WFM11A
] > 0) &&
667 (Private
->ServerCount
[DHCP4_PACKET_TYPE_DHCP_ONLY
] > 0)
670 // DHCP only and proxy DHCP with WfM
672 Private
->SelectedOffer
= Private
->OfferIndex
[DHCP4_PACKET_TYPE_DHCP_ONLY
][0] + 1;
673 Private
->ProxyOfferType
= DHCP4_PACKET_TYPE_WFM11A
;
675 } else if (Private
->ServerCount
[DHCP4_PACKET_TYPE_BINL
] > 0) {
679 Private
->SelectedOffer
= Private
->OfferIndex
[DHCP4_PACKET_TYPE_BINL
][0] + 1;
681 } else if ((Private
->ProxyIndex
[DHCP4_PACKET_TYPE_BINL
] > 0) &&
682 (Private
->ServerCount
[DHCP4_PACKET_TYPE_DHCP_ONLY
] > 0)
685 // DHCP only and proxy DHCP with BINL
687 Private
->SelectedOffer
= Private
->OfferIndex
[DHCP4_PACKET_TYPE_DHCP_ONLY
][0] + 1;
688 Private
->ProxyOfferType
= DHCP4_PACKET_TYPE_BINL
;
692 // Try offers with bootfile
694 for (Index
= 0; Index
< Private
->ServerCount
[DHCP4_PACKET_TYPE_DHCP_ONLY
]; Index
++) {
696 // Select the first DHCP only offer with bootfile
698 OfferIndex
= Private
->OfferIndex
[DHCP4_PACKET_TYPE_DHCP_ONLY
][Index
];
699 if (Private
->Dhcp4Offers
[OfferIndex
].Dhcp4Option
[PXEBC_DHCP4_TAG_INDEX_BOOTFILE
] != NULL
) {
700 Private
->SelectedOffer
= OfferIndex
+ 1;
705 if (Private
->SelectedOffer
== 0) {
707 // Select the Bootp reply with bootfile if any
709 Private
->SelectedOffer
= Private
->BootpIndex
;
714 // Try the offers in the received order.
716 for (Index
= 0; Index
< Private
->NumOffers
; Index
++) {
718 Offer
= &Private
->Dhcp4Offers
[Index
].Packet
.Offer
;
720 if (IS_PROXY_DHCP_OFFER (Offer
)) {
727 if ((Private
->Dhcp4Offers
[Index
].OfferType
== DHCP4_PACKET_TYPE_DHCP_ONLY
) &&
728 ((!Private
->GotProxyOffer
) && (Private
->Dhcp4Offers
[Index
].Dhcp4Option
[PXEBC_DHCP4_TAG_INDEX_BOOTFILE
] == NULL
))) {
730 // DHCP only offer but no proxy offer received and no bootfile option in this offer
735 Private
->SelectedOffer
= Index
+ 1;
745 EFI_DHCP4_CALLBACK is provided by the consumer of the EFI DHCPv4 Protocol driver
746 to intercept events that occurred in the configuration process. This structure
747 provides advanced control of each state transition of the DHCP process. The
748 returned status code determines the behavior of the EFI DHCPv4 Protocol driver.
749 There are three possible returned values, which are described in the following
752 @param This Pointer to the EFI DHCPv4 Protocol instance that is used to
753 configure this callback function.
754 @param Context Pointer to the context that is initialized by
755 EFI_DHCP4_PROTOCOL.Configure().
756 @param CurrentState The current operational state of the EFI DHCPv4 Protocol
758 @param Dhcp4Event The event that occurs in the current state, which usually means a
760 @param Packet The DHCP packet that is going to be sent or already received.
761 @param NewPacket The packet that is used to replace the above Packet.
763 @retval EFI_SUCCESS Tells the EFI DHCPv4 Protocol driver to continue the DHCP process.
764 @retval EFI_NOT_READY Only used in the Dhcp4Selecting state. The EFI DHCPv4 Protocol
765 driver will continue to wait for more DHCPOFFER packets until the retry
767 @retval EFI_ABORTED Tells the EFI DHCPv4 Protocol driver to abort the current process and
768 return to the Dhcp4Init or Dhcp4InitReboot state.
774 IN EFI_DHCP4_PROTOCOL
* This
,
776 IN EFI_DHCP4_STATE CurrentState
,
777 IN EFI_DHCP4_EVENT Dhcp4Event
,
778 IN EFI_DHCP4_PACKET
* Packet OPTIONAL
,
779 OUT EFI_DHCP4_PACKET
**NewPacket OPTIONAL
782 PXEBC_PRIVATE_DATA
*Private
;
783 EFI_PXE_BASE_CODE_MODE
*Mode
;
784 EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL
*Callback
;
785 EFI_DHCP4_PACKET_OPTION
*MaxMsgSize
;
789 CHAR8
*SystemSerialNumber
;
790 EFI_DHCP4_HEADER
*DhcpHeader
;
792 if ((Dhcp4Event
!= Dhcp4RcvdOffer
) &&
793 (Dhcp4Event
!= Dhcp4SelectOffer
) &&
794 (Dhcp4Event
!= Dhcp4SendDiscover
) &&
795 (Dhcp4Event
!= Dhcp4RcvdAck
) &&
796 (Dhcp4Event
!= Dhcp4SendRequest
)) {
800 Private
= (PXEBC_PRIVATE_DATA
*) Context
;
801 Mode
= Private
->PxeBc
.Mode
;
802 Callback
= Private
->PxeBcCallback
;
805 // Override the Maximum DHCP Message Size.
807 MaxMsgSize
= PxeBcParseExtendOptions (
808 Packet
->Dhcp4
.Option
,
809 GET_OPTION_BUFFER_LEN (Packet
),
810 PXEBC_DHCP4_TAG_MAXMSG
812 if (MaxMsgSize
!= NULL
) {
813 Value
= HTONS (PXEBC_DHCP4_MAX_PACKET_SIZE
);
814 CopyMem (MaxMsgSize
->Data
, &Value
, sizeof (Value
));
817 if ((Dhcp4Event
!= Dhcp4SelectOffer
) && (Callback
!= NULL
)) {
818 Received
= (BOOLEAN
) ((Dhcp4Event
== Dhcp4RcvdOffer
) || (Dhcp4Event
== Dhcp4RcvdAck
));
819 Status
= Callback
->Callback (
824 (EFI_PXE_BASE_CODE_PACKET
*) &Packet
->Dhcp4
826 if (Status
!= EFI_PXE_BASE_CODE_CALLBACK_STATUS_CONTINUE
) {
831 Status
= EFI_SUCCESS
;
833 switch (Dhcp4Event
) {
835 case Dhcp4SendDiscover
:
836 case Dhcp4SendRequest
:
837 if (Mode
->SendGUID
) {
839 // send the system GUID instead of the MAC address as the hardware address
840 // in the DHCP packet header.
842 DhcpHeader
= &Packet
->Dhcp4
.Header
;
844 if (EFI_ERROR (GetSmbiosSystemGuidAndSerialNumber ((EFI_GUID
*) DhcpHeader
->ClientHwAddr
, &SystemSerialNumber
))) {
846 // GUID not yet set - send all 0xff's to show programable (via SetVariable)
847 // SetMem(DHCPV4_OPTIONS_BUFFER.DhcpPlatformId.Guid, sizeof(EFI_GUID), 0xff);
848 // GUID not yet set - send all 0's to show not programable
850 ZeroMem (DhcpHeader
->ClientHwAddr
, sizeof (EFI_GUID
));
853 DhcpHeader
->HwAddrLen
= sizeof (EFI_GUID
);
856 if (Dhcp4Event
== Dhcp4SendDiscover
) {
858 // Cache the dhcp discover packet, of which some information will be used later.
860 CopyMem (Mode
->DhcpDiscover
.Raw
, &Packet
->Dhcp4
, Packet
->Length
);
866 Status
= EFI_NOT_READY
;
867 if (Private
->NumOffers
< PXEBC_MAX_OFFER_NUM
) {
869 // Cache the dhcp offers in Private->Dhcp4Offers[]
871 PxeBcCacheDhcpOffer (Private
, Packet
);
876 case Dhcp4SelectOffer
:
878 // Select an offer, if succeeded, Private->SelectedOffer points to
879 // the index of the selected one.
881 PxeBcSelectOffer (Private
);
883 if (Private
->SelectedOffer
== 0) {
884 Status
= EFI_ABORTED
;
886 *NewPacket
= &Private
->Dhcp4Offers
[Private
->SelectedOffer
- 1].Packet
.Offer
;
895 ASSERT (Private
->SelectedOffer
!= 0);
897 PxeBcCopyEfiDhcp4Packet (&Private
->Dhcp4Ack
.Packet
.Ack
, Packet
);
909 Initialize the DHCP options and build the option list.
911 @param Private Pointer to PxeBc private data.
912 @param OptList Pointer to a DHCP option list.
914 @param IsDhcpDiscover Discover dhcp option or not.
916 @return The index item number of the option list.
920 PxeBcBuildDhcpOptions (
921 IN PXEBC_PRIVATE_DATA
*Private
,
922 IN EFI_DHCP4_PACKET_OPTION
**OptList
,
923 IN BOOLEAN IsDhcpDiscover
927 PXEBC_DHCP4_OPTION_ENTRY OptEnt
;
929 CHAR8
*SystemSerialNumber
;
932 OptList
[0] = (EFI_DHCP4_PACKET_OPTION
*) Private
->OptionBuffer
;
934 if (!IsDhcpDiscover
) {
936 // Append message type.
938 OptList
[Index
]->OpCode
= PXEBC_DHCP4_TAG_MSG_TYPE
;
939 OptList
[Index
]->Length
= 1;
940 OptEnt
.Mesg
= (PXEBC_DHCP4_OPTION_MESG
*) OptList
[Index
]->Data
;
941 OptEnt
.Mesg
->Type
= PXEBC_DHCP4_MSG_TYPE_REQUEST
;
943 OptList
[Index
] = GET_NEXT_DHCP_OPTION (OptList
[Index
- 1]);
946 // Append max message size.
948 OptList
[Index
]->OpCode
= PXEBC_DHCP4_TAG_MAXMSG
;
949 OptList
[Index
]->Length
= sizeof (PXEBC_DHCP4_OPTION_MAX_MESG_SIZE
);
950 OptEnt
.MaxMesgSize
= (PXEBC_DHCP4_OPTION_MAX_MESG_SIZE
*) OptList
[Index
]->Data
;
951 Value
= NTOHS (PXEBC_DHCP4_MAX_PACKET_SIZE
);
952 CopyMem (&OptEnt
.MaxMesgSize
->Size
, &Value
, sizeof (UINT16
));
954 OptList
[Index
] = GET_NEXT_DHCP_OPTION (OptList
[Index
- 1]);
957 // Parameter request list option.
959 OptList
[Index
]->OpCode
= PXEBC_DHCP4_TAG_PARA_LIST
;
960 OptList
[Index
]->Length
= 35;
961 OptEnt
.Para
= (PXEBC_DHCP4_OPTION_PARA
*) OptList
[Index
]->Data
;
962 OptEnt
.Para
->ParaList
[0] = PXEBC_DHCP4_TAG_NETMASK
;
963 OptEnt
.Para
->ParaList
[1] = PXEBC_DHCP4_TAG_TIME_OFFSET
;
964 OptEnt
.Para
->ParaList
[2] = PXEBC_DHCP4_TAG_ROUTER
;
965 OptEnt
.Para
->ParaList
[3] = PXEBC_DHCP4_TAG_TIME_SERVER
;
966 OptEnt
.Para
->ParaList
[4] = PXEBC_DHCP4_TAG_NAME_SERVER
;
967 OptEnt
.Para
->ParaList
[5] = PXEBC_DHCP4_TAG_DNS_SERVER
;
968 OptEnt
.Para
->ParaList
[6] = PXEBC_DHCP4_TAG_HOSTNAME
;
969 OptEnt
.Para
->ParaList
[7] = PXEBC_DHCP4_TAG_BOOTFILE_LEN
;
970 OptEnt
.Para
->ParaList
[8] = PXEBC_DHCP4_TAG_DOMAINNAME
;
971 OptEnt
.Para
->ParaList
[9] = PXEBC_DHCP4_TAG_ROOTPATH
;
972 OptEnt
.Para
->ParaList
[10] = PXEBC_DHCP4_TAG_EXTEND_PATH
;
973 OptEnt
.Para
->ParaList
[11] = PXEBC_DHCP4_TAG_EMTU
;
974 OptEnt
.Para
->ParaList
[12] = PXEBC_DHCP4_TAG_TTL
;
975 OptEnt
.Para
->ParaList
[13] = PXEBC_DHCP4_TAG_BROADCAST
;
976 OptEnt
.Para
->ParaList
[14] = PXEBC_DHCP4_TAG_NIS_DOMAIN
;
977 OptEnt
.Para
->ParaList
[15] = PXEBC_DHCP4_TAG_NIS_SERVER
;
978 OptEnt
.Para
->ParaList
[16] = PXEBC_DHCP4_TAG_NTP_SERVER
;
979 OptEnt
.Para
->ParaList
[17] = PXEBC_DHCP4_TAG_VENDOR
;
980 OptEnt
.Para
->ParaList
[18] = PXEBC_DHCP4_TAG_REQUEST_IP
;
981 OptEnt
.Para
->ParaList
[19] = PXEBC_DHCP4_TAG_LEASE
;
982 OptEnt
.Para
->ParaList
[20] = PXEBC_DHCP4_TAG_SERVER_ID
;
983 OptEnt
.Para
->ParaList
[21] = PXEBC_DHCP4_TAG_T1
;
984 OptEnt
.Para
->ParaList
[22] = PXEBC_DHCP4_TAG_T2
;
985 OptEnt
.Para
->ParaList
[23] = PXEBC_DHCP4_TAG_CLASS_ID
;
986 OptEnt
.Para
->ParaList
[24] = PXEBC_DHCP4_TAG_TFTP
;
987 OptEnt
.Para
->ParaList
[25] = PXEBC_DHCP4_TAG_BOOTFILE
;
988 OptEnt
.Para
->ParaList
[26] = PXEBC_PXE_DHCP4_TAG_UUID
;
989 OptEnt
.Para
->ParaList
[27] = 0x80;
990 OptEnt
.Para
->ParaList
[28] = 0x81;
991 OptEnt
.Para
->ParaList
[29] = 0x82;
992 OptEnt
.Para
->ParaList
[30] = 0x83;
993 OptEnt
.Para
->ParaList
[31] = 0x84;
994 OptEnt
.Para
->ParaList
[32] = 0x85;
995 OptEnt
.Para
->ParaList
[33] = 0x86;
996 OptEnt
.Para
->ParaList
[34] = 0x87;
998 OptList
[Index
] = GET_NEXT_DHCP_OPTION (OptList
[Index
- 1]);
1001 // Append UUID/Guid-based client identifier option
1003 OptList
[Index
]->OpCode
= PXEBC_PXE_DHCP4_TAG_UUID
;
1004 OptList
[Index
]->Length
= sizeof (PXEBC_DHCP4_OPTION_UUID
);
1005 OptEnt
.Uuid
= (PXEBC_DHCP4_OPTION_UUID
*) OptList
[Index
]->Data
;
1006 OptEnt
.Uuid
->Type
= 0;
1008 OptList
[Index
] = GET_NEXT_DHCP_OPTION (OptList
[Index
- 1]);
1010 if (EFI_ERROR (GetSmbiosSystemGuidAndSerialNumber ((EFI_GUID
*) OptEnt
.Uuid
->Guid
, &SystemSerialNumber
))) {
1012 // GUID not yet set - send all 0xff's to show programable (via SetVariable)
1013 // SetMem(DHCPV4_OPTIONS_BUFFER.DhcpPlatformId.Guid, sizeof(EFI_GUID), 0xff);
1014 // GUID not yet set - send all 0's to show not programable
1016 ZeroMem (OptEnt
.Uuid
->Guid
, sizeof (EFI_GUID
));
1020 // Append client network device interface option
1022 OptList
[Index
]->OpCode
= PXEBC_PXE_DHCP4_TAG_UNDI
;
1023 OptList
[Index
]->Length
= sizeof (PXEBC_DHCP4_OPTION_UNDI
);
1024 OptEnt
.Undi
= (PXEBC_DHCP4_OPTION_UNDI
*) OptList
[Index
]->Data
;
1025 if (Private
->Nii
!= NULL
) {
1026 OptEnt
.Undi
->Type
= Private
->Nii
->Type
;
1027 OptEnt
.Undi
->MajorVer
= Private
->Nii
->MajorVer
;
1028 OptEnt
.Undi
->MinorVer
= Private
->Nii
->MinorVer
;
1030 OptEnt
.Undi
->Type
= DEFAULT_UNDI_TYPE
;
1031 OptEnt
.Undi
->MajorVer
= DEFAULT_UNDI_MAJOR
;
1032 OptEnt
.Undi
->MinorVer
= DEFAULT_UNDI_MINOR
;
1036 OptList
[Index
] = GET_NEXT_DHCP_OPTION (OptList
[Index
- 1]);
1039 // Append client system architecture option
1041 OptList
[Index
]->OpCode
= PXEBC_PXE_DHCP4_TAG_ARCH
;
1042 OptList
[Index
]->Length
= sizeof (PXEBC_DHCP4_OPTION_ARCH
);
1043 OptEnt
.Arch
= (PXEBC_DHCP4_OPTION_ARCH
*) OptList
[Index
]->Data
;
1044 Value
= HTONS (SYS_ARCH
);
1045 CopyMem (&OptEnt
.Arch
->Type
, &Value
, sizeof (UINT16
));
1047 OptList
[Index
] = GET_NEXT_DHCP_OPTION (OptList
[Index
- 1]);
1050 // Append client system architecture option
1052 OptList
[Index
]->OpCode
= PXEBC_DHCP4_TAG_CLASS_ID
;
1053 OptList
[Index
]->Length
= sizeof (PXEBC_DHCP4_OPTION_CLID
);
1054 OptEnt
.Clid
= (PXEBC_DHCP4_OPTION_CLID
*) OptList
[Index
]->Data
;
1055 CopyMem (OptEnt
.Clid
, DEFAULT_CLASS_ID_DATA
, sizeof (PXEBC_DHCP4_OPTION_CLID
));
1056 CvtNum (SYS_ARCH
, OptEnt
.Clid
->ArchitectureType
, sizeof (OptEnt
.Clid
->ArchitectureType
));
1058 if (Private
->Nii
!= NULL
) {
1060 // If NII protocol exists, update DHCP option data
1062 CopyMem (OptEnt
.Clid
->InterfaceName
, Private
->Nii
->StringId
, sizeof (OptEnt
.Clid
->InterfaceName
));
1063 CvtNum (Private
->Nii
->MajorVer
, OptEnt
.Clid
->UndiMajor
, sizeof (OptEnt
.Clid
->UndiMajor
));
1064 CvtNum (Private
->Nii
->MinorVer
, OptEnt
.Clid
->UndiMinor
, sizeof (OptEnt
.Clid
->UndiMinor
));
1074 Discover the boot of service and initialize the vendor option if exists.
1076 @param Private Pointer to PxeBc private data.
1077 @param Type PxeBc option boot item type
1078 @param Layer PxeBc option boot item layer
1079 @param UseBis Use BIS or not
1080 @param DestIp Ip address for server
1081 @param IpCount The total count of the server ip address
1082 @param SrvList Server list
1083 @param IsDiscv Discover the vendor or not
1084 @param Reply The dhcp4 packet of Pxe reply
1086 @retval EFI_SUCCESS Operation succeeds.
1087 @retval EFI_OUT_OF_RESOURCES Allocate memory pool failed.
1088 @retval EFI_NOT_FOUND There is no vendor option exists.
1089 @retval EFI_TIMEOUT Send Pxe Discover time out.
1093 PxeBcDiscvBootService (
1094 IN PXEBC_PRIVATE_DATA
* Private
,
1098 IN EFI_IP_ADDRESS
* DestIp
,
1100 IN EFI_PXE_BASE_CODE_SRVLIST
* SrvList
,
1102 OUT EFI_DHCP4_PACKET
* Reply OPTIONAL
1105 EFI_PXE_BASE_CODE_UDP_PORT Sport
;
1106 EFI_PXE_BASE_CODE_MODE
*Mode
;
1107 EFI_DHCP4_PROTOCOL
*Dhcp4
;
1108 EFI_DHCP4_TRANSMIT_RECEIVE_TOKEN Token
;
1114 EFI_DHCP4_LISTEN_POINT ListenPoint
;
1115 EFI_DHCP4_PACKET
*Response
;
1116 EFI_DHCP4_PACKET_OPTION
*OptList
[PXEBC_DHCP4_MAX_OPTION_NUM
];
1118 EFI_DHCP4_PACKET_OPTION
*PxeOpt
;
1119 PXEBC_OPTION_BOOT_ITEM
*PxeBootItem
;
1121 CHAR8
*SystemSerialNumber
;
1122 EFI_DHCP4_HEADER
*DhcpHeader
;
1125 ASSERT (IsDiscv
&& (Layer
!= NULL
));
1127 Mode
= Private
->PxeBc
.Mode
;
1128 Dhcp4
= Private
->Dhcp4
;
1129 Status
= EFI_SUCCESS
;
1131 ZeroMem (&Token
, sizeof (EFI_DHCP4_TRANSMIT_RECEIVE_TOKEN
));
1133 if (DestIp
== NULL
) {
1134 Sport
= PXEBC_DHCP4_S_PORT
;
1137 Sport
= PXEBC_BS_DISCOVER_PORT
;
1141 if (!UseBis
&& Layer
!= NULL
) {
1142 *Layer
&= EFI_PXE_BASE_CODE_BOOT_LAYER_MASK
;
1145 OptCount
= PxeBcBuildDhcpOptions (Private
, OptList
, FALSE
);
1149 // Add vendor option of PXE_BOOT_ITEM
1151 VendorOptLen
= (sizeof (EFI_DHCP4_PACKET_OPTION
) - 1) * 2 + sizeof (PXEBC_OPTION_BOOT_ITEM
) + 1;
1152 OptList
[OptCount
] = AllocatePool (VendorOptLen
);
1153 if (OptList
[OptCount
] == NULL
) {
1154 return EFI_OUT_OF_RESOURCES
;
1157 OptList
[OptCount
]->OpCode
= PXEBC_DHCP4_TAG_VENDOR
;
1158 OptList
[OptCount
]->Length
= (UINT8
) (VendorOptLen
- 2);
1159 PxeOpt
= (EFI_DHCP4_PACKET_OPTION
*) OptList
[OptCount
]->Data
;
1160 PxeOpt
->OpCode
= PXEBC_VENDOR_TAG_BOOT_ITEM
;
1161 PxeOpt
->Length
= sizeof (PXEBC_OPTION_BOOT_ITEM
);
1162 PxeBootItem
= (PXEBC_OPTION_BOOT_ITEM
*) PxeOpt
->Data
;
1163 PxeBootItem
->Type
= HTONS (Type
);
1164 PxeBootItem
->Layer
= HTONS (*Layer
);
1165 PxeOpt
->Data
[PxeOpt
->Length
] = PXEBC_DHCP4_TAG_EOP
;
1170 Status
= Dhcp4
->Build (Dhcp4
, &Private
->SeedPacket
, 0, NULL
, OptCount
, OptList
, &Token
.Packet
);
1173 gBS
->FreePool (OptList
[OptCount
- 1]);
1176 if (EFI_ERROR (Status
)) {
1180 DhcpHeader
= &Token
.Packet
->Dhcp4
.Header
;
1181 if (Mode
->SendGUID
) {
1182 if (EFI_ERROR (GetSmbiosSystemGuidAndSerialNumber ((EFI_GUID
*) DhcpHeader
->ClientHwAddr
, &SystemSerialNumber
))) {
1184 // GUID not yet set - send all 0's to show not programable
1186 ZeroMem (DhcpHeader
->ClientHwAddr
, sizeof (EFI_GUID
));
1189 DhcpHeader
->HwAddrLen
= sizeof (EFI_GUID
);
1192 Xid
= NET_RANDOM (NetRandomInitSeed ());
1193 Token
.Packet
->Dhcp4
.Header
.Xid
= HTONL(Xid
);
1194 Token
.Packet
->Dhcp4
.Header
.Reserved
= HTONS((IsBCast
) ? 0x8000 : 0);
1195 CopyMem (&Token
.Packet
->Dhcp4
.Header
.ClientAddr
, &Private
->StationIp
, sizeof (EFI_IPv4_ADDRESS
));
1197 Token
.RemotePort
= Sport
;
1200 SetMem (&Token
.RemoteAddress
, sizeof (EFI_IPv4_ADDRESS
), 0xff);
1202 CopyMem (&Token
.RemoteAddress
, DestIp
, sizeof (EFI_IPv4_ADDRESS
));
1205 CopyMem (&Token
.GatewayAddress
, &Private
->GatewayIp
, sizeof (EFI_IPv4_ADDRESS
));
1208 Token
.ListenPointCount
= 1;
1209 Token
.ListenPoints
= &ListenPoint
;
1210 Token
.ListenPoints
[0].ListenPort
= PXEBC_BS_DISCOVER_PORT
;
1211 CopyMem (&Token
.ListenPoints
[0].ListenAddress
, &Private
->StationIp
, sizeof(EFI_IPv4_ADDRESS
));
1212 CopyMem (&Token
.ListenPoints
[0].SubnetMask
, &Private
->SubnetMask
, sizeof(EFI_IPv4_ADDRESS
));
1215 // Send Pxe Discover
1217 for (TryIndex
= 1; TryIndex
<= PXEBC_BOOT_REQUEST_RETRIES
; TryIndex
++) {
1219 Token
.TimeoutValue
= (UINT16
) (PXEBC_BOOT_REQUEST_TIMEOUT
* TryIndex
);
1220 Token
.Packet
->Dhcp4
.Header
.Seconds
= (UINT16
) (PXEBC_BOOT_REQUEST_TIMEOUT
* (TryIndex
- 1));
1222 Status
= Dhcp4
->TransmitReceive (Dhcp4
, &Token
);
1224 if (Token
.Status
!= EFI_TIMEOUT
) {
1229 if (!EFI_ERROR (Status
)) {
1235 Response
= Token
.ResponseList
;
1237 while (RepIndex
< Token
.ResponseCount
) {
1239 while (SrvIndex
< IpCount
) {
1241 if (SrvList
[SrvIndex
].AcceptAnyResponse
) {
1245 if ((SrvList
[SrvIndex
].Type
== Type
) && EFI_IP4_EQUAL (&(Response
->Dhcp4
.Header
.ServerAddr
), &(Private
->ServerIp
))) {
1252 if ((IpCount
!= SrvIndex
) || (IpCount
== 0)) {
1259 Response
= (EFI_DHCP4_PACKET
*) ((UINT8
*) Response
+ Response
->Size
);
1262 if (RepIndex
< Token
.ResponseCount
) {
1264 if (Reply
!= NULL
) {
1265 PxeBcCopyEfiDhcp4Packet (Reply
, Response
);
1269 CopyMem (&(Mode
->PxeDiscover
), &(Token
.Packet
->Dhcp4
), Token
.Packet
->Length
);
1270 Mode
->PxeDiscoverValid
= TRUE
;
1272 CopyMem (Mode
->PxeReply
.Raw
, &Response
->Dhcp4
, Response
->Length
);
1273 Mode
->PxeReplyReceived
= TRUE
;
1276 Status
= EFI_NOT_FOUND
;
1280 // free the responselist
1282 gBS
->FreePool (Token
.ResponseList
);
1285 // Free the dhcp packet
1287 gBS
->FreePool (Token
.Packet
);
1294 Parse interested dhcp options.
1296 @param Buffer Pointer to the dhcp options packet.
1297 @param Length The length of the dhcp options.
1298 @param OptTag The option OpCode.
1300 @return NULL if the buffer length is 0 and OpCode is not
1301 PXEBC_DHCP4_TAG_EOP, or the pointer to the buffer.
1304 EFI_DHCP4_PACKET_OPTION
*
1305 PxeBcParseExtendOptions (
1311 EFI_DHCP4_PACKET_OPTION
*Option
;
1314 Option
= (EFI_DHCP4_PACKET_OPTION
*) Buffer
;
1317 while (Offset
< Length
&& Option
->OpCode
!= PXEBC_DHCP4_TAG_EOP
) {
1319 if (Option
->OpCode
== OptTag
) {
1324 if (Option
->OpCode
== PXEBC_DHCP4_TAG_PAD
) {
1327 Offset
+= Option
->Length
+ 2;
1330 Option
= (EFI_DHCP4_PACKET_OPTION
*) (Buffer
+ Offset
);
1338 This function is to parse and check vendor options.
1340 @param Dhcp4Option Pointer to dhcp options
1341 @param VendorOption Pointer to vendor options
1343 @return TRUE if valid for vendor options, or FALSE.
1347 PxeBcParseVendorOptions (
1348 IN EFI_DHCP4_PACKET_OPTION
*Dhcp4Option
,
1349 IN PXEBC_VENDOR_OPTION
*VendorOption
1353 UINT8 VendorOptionLen
;
1354 EFI_DHCP4_PACKET_OPTION
*PxeOption
;
1357 BitMap
= VendorOption
->BitMap
;
1358 VendorOptionLen
= Dhcp4Option
->Length
;
1359 PxeOption
= (EFI_DHCP4_PACKET_OPTION
*) &Dhcp4Option
->Data
[0];
1362 while ((Offset
< VendorOptionLen
) && (PxeOption
->OpCode
!= PXEBC_DHCP4_TAG_EOP
)) {
1364 // Parse every Vendor Option and set its BitMap
1366 switch (PxeOption
->OpCode
) {
1368 case PXEBC_VENDOR_TAG_MTFTP_IP
:
1370 CopyMem (&VendorOption
->MtftpIp
, PxeOption
->Data
, sizeof (EFI_IPv4_ADDRESS
));
1373 case PXEBC_VENDOR_TAG_MTFTP_CPORT
:
1375 CopyMem (&VendorOption
->MtftpCPort
, PxeOption
->Data
, sizeof (VendorOption
->MtftpCPort
));
1378 case PXEBC_VENDOR_TAG_MTFTP_SPORT
:
1380 CopyMem (&VendorOption
->MtftpSPort
, PxeOption
->Data
, sizeof (VendorOption
->MtftpSPort
));
1383 case PXEBC_VENDOR_TAG_MTFTP_TIMEOUT
:
1385 VendorOption
->MtftpTimeout
= *PxeOption
->Data
;
1388 case PXEBC_VENDOR_TAG_MTFTP_DELAY
:
1390 VendorOption
->MtftpDelay
= *PxeOption
->Data
;
1393 case PXEBC_VENDOR_TAG_DISCOVER_CTRL
:
1395 VendorOption
->DiscoverCtrl
= *PxeOption
->Data
;
1398 case PXEBC_VENDOR_TAG_DISCOVER_MCAST
:
1400 CopyMem (&VendorOption
->DiscoverMcastIp
, PxeOption
->Data
, sizeof (EFI_IPv4_ADDRESS
));
1403 case PXEBC_VENDOR_TAG_BOOT_SERVERS
:
1405 VendorOption
->BootSvrLen
= PxeOption
->Length
;
1406 VendorOption
->BootSvr
= (PXEBC_BOOT_SVR_ENTRY
*) PxeOption
->Data
;
1409 case PXEBC_VENDOR_TAG_BOOT_MENU
:
1411 VendorOption
->BootMenuLen
= PxeOption
->Length
;
1412 VendorOption
->BootMenu
= (PXEBC_BOOT_MENU_ENTRY
*) PxeOption
->Data
;
1415 case PXEBC_VENDOR_TAG_MENU_PROMPT
:
1417 VendorOption
->MenuPromptLen
= PxeOption
->Length
;
1418 VendorOption
->MenuPrompt
= (PXEBC_MENU_PROMPT
*) PxeOption
->Data
;
1421 case PXEBC_VENDOR_TAG_MCAST_ALLOC
:
1423 CopyMem (&VendorOption
->McastIpBase
, PxeOption
->Data
, sizeof (EFI_IPv4_ADDRESS
));
1424 CopyMem (&VendorOption
->McastIpBlock
, PxeOption
->Data
+ 4, sizeof (VendorOption
->McastIpBlock
));
1425 CopyMem (&VendorOption
->McastIpRange
, PxeOption
->Data
+ 6, sizeof (VendorOption
->McastIpRange
));
1428 case PXEBC_VENDOR_TAG_CREDENTIAL_TYPES
:
1430 VendorOption
->CredTypeLen
= PxeOption
->Length
;
1431 VendorOption
->CredType
= (UINT32
*) PxeOption
->Data
;
1434 case PXEBC_VENDOR_TAG_BOOT_ITEM
:
1436 CopyMem (&VendorOption
->BootSrvType
, PxeOption
->Data
, sizeof (VendorOption
->BootSrvType
));
1437 CopyMem (&VendorOption
->BootSrvLayer
, PxeOption
->Data
+ 2, sizeof (VendorOption
->BootSrvLayer
));
1441 SET_VENDOR_OPTION_BIT_MAP (BitMap
, PxeOption
->OpCode
);
1443 if (PxeOption
->OpCode
== PXEBC_DHCP4_TAG_PAD
) {
1446 Offset
= (UINT8
) (Offset
+ PxeOption
->Length
+ 2);
1449 PxeOption
= (EFI_DHCP4_PACKET_OPTION
*) (Dhcp4Option
->Data
+ Offset
);
1453 // FixMe, return falas if invalid of any vendor option
1461 This function display boot item detail.
1463 If the length of the boot item string over 70 Char, just display 70 Char.
1465 @param Str Pointer to a string (boot item string).
1466 @param Len The length of string.
1472 PxeBcDisplayBootItem (
1479 Len
= (UINT8
) MIN (70, Len
);
1482 AsciiPrint ("%a \n", Str
);
1488 Choose the boot prompt.
1490 @param Private Pointer to PxeBc private data.
1492 @retval EFI_SUCCESS Select boot prompt done.
1493 @retval EFI_TIMEOUT Select boot prompt time out.
1494 @retval EFI_NOT_FOUND The proxy offer is not Pxe10.
1495 @retval EFI_ABORTED User cancel the operation.
1496 @retval EFI_NOT_READY Read the input key from the keybroad has not finish.
1500 PxeBcSelectBootPrompt (
1501 IN PXEBC_PRIVATE_DATA
*Private
1504 PXEBC_CACHED_DHCP4_PACKET
*Packet
;
1505 PXEBC_VENDOR_OPTION
*VendorOpt
;
1506 EFI_EVENT TimeoutEvent
;
1507 EFI_EVENT DescendEvent
;
1508 EFI_INPUT_KEY InputKey
;
1516 TimeoutEvent
= NULL
;
1517 DescendEvent
= NULL
;
1519 if (Private
->PxeBc
.Mode
->ProxyOfferReceived
) {
1521 Packet
= &Private
->ProxyOffer
;
1524 Packet
= &Private
->Dhcp4Ack
;
1527 if (Packet
->OfferType
!= DHCP4_PACKET_TYPE_PXE10
) {
1528 return EFI_NOT_FOUND
;
1531 VendorOpt
= &Packet
->PxeVendorOption
;
1533 if (!IS_VALID_BOOT_PROMPT (VendorOpt
->BitMap
)) {
1537 Timeout
= VendorOpt
->MenuPrompt
->Timeout
;
1538 Prompt
= VendorOpt
->MenuPrompt
->Prompt
;
1539 PromptLen
= (UINT8
) (VendorOpt
->MenuPromptLen
- 1);
1545 if (Timeout
== 255) {
1549 Status
= gBS
->CreateEvent (
1557 if (EFI_ERROR (Status
)) {
1561 Status
= gBS
->SetTimer (
1564 Timeout
* TICKS_PER_SECOND
1567 if (EFI_ERROR (Status
)) {
1571 Status
= gBS
->CreateEvent (
1579 if (EFI_ERROR (Status
)) {
1583 Status
= gBS
->SetTimer (
1589 if (EFI_ERROR (Status
)) {
1593 SecCol
= gST
->ConOut
->Mode
->CursorColumn
;
1594 SecRow
= gST
->ConOut
->Mode
->CursorRow
;
1596 PxeBcDisplayBootItem (Prompt
, PromptLen
);
1598 gST
->ConOut
->SetCursorPosition (gST
->ConOut
, SecCol
+ PromptLen
, SecRow
);
1599 AsciiPrint ("(%d) ", Timeout
--);
1601 while (EFI_ERROR (gBS
->CheckEvent (TimeoutEvent
))) {
1603 if (!EFI_ERROR (gBS
->CheckEvent (DescendEvent
))) {
1604 gST
->ConOut
->SetCursorPosition (gST
->ConOut
, SecCol
+ PromptLen
, SecRow
);
1605 AsciiPrint ("(%d) ", Timeout
--);
1608 if (gST
->ConIn
->ReadKeyStroke (gST
->ConIn
, &InputKey
) == EFI_NOT_READY
) {
1610 gBS
->Stall (10 * TICKS_PER_MS
);
1614 if (InputKey
.ScanCode
== 0) {
1616 switch (InputKey
.UnicodeChar
) {
1618 Status
= EFI_ABORTED
;
1624 Status
= EFI_TIMEOUT
;
1632 switch (InputKey
.ScanCode
) {
1634 Status
= EFI_TIMEOUT
;
1638 Status
= EFI_ABORTED
;
1649 gST
->ConOut
->SetCursorPosition (gST
->ConOut
, 0 , SecRow
+ 1);
1653 if (DescendEvent
!= NULL
) {
1654 gBS
->CloseEvent (DescendEvent
);
1657 if (TimeoutEvent
!= NULL
) {
1658 gBS
->CloseEvent (TimeoutEvent
);
1666 Select the boot menu.
1668 @param Private Pointer to PxeBc private data.
1669 @param Type The type of the menu.
1670 @param UseDefaultItem Use default item or not.
1672 @retval EFI_ABORTED User cancel operation.
1673 @retval EFI_SUCCESS Select the boot menu success.
1674 @retval EFI_NOT_READY Read the input key from the keybroad has not finish.
1678 PxeBcSelectBootMenu (
1679 IN PXEBC_PRIVATE_DATA
*Private
,
1681 IN BOOLEAN UseDefaultItem
1684 PXEBC_CACHED_DHCP4_PACKET
*Packet
;
1685 PXEBC_VENDOR_OPTION
*VendorOpt
;
1686 EFI_INPUT_KEY InputKey
;
1695 PXEBC_BOOT_MENU_ENTRY
*MenuItem
;
1696 PXEBC_BOOT_MENU_ENTRY
*MenuArray
[PXEBC_MAX_MENU_NUM
];
1703 if (Private
->PxeBc
.Mode
->ProxyOfferReceived
) {
1705 Packet
= &Private
->ProxyOffer
;
1708 Packet
= &Private
->Dhcp4Ack
;
1711 ASSERT (Packet
->OfferType
== DHCP4_PACKET_TYPE_PXE10
);
1713 VendorOpt
= &Packet
->PxeVendorOption
;
1715 if (!IS_VALID_BOOT_MENU (VendorOpt
->BitMap
)) {
1719 SetMem (Blank
, sizeof(Blank
), ' ');
1721 MenuSize
= VendorOpt
->BootMenuLen
;
1722 MenuItem
= VendorOpt
->BootMenu
;
1724 if (MenuSize
== 0) {
1725 return EFI_NOT_READY
;
1728 while (MenuSize
> 0) {
1729 MenuArray
[Index
] = MenuItem
;
1730 MenuSize
= (UINT8
) (MenuSize
- (MenuItem
->DescLen
+ 3));
1731 MenuItem
= (PXEBC_BOOT_MENU_ENTRY
*) ((UINT8
*) MenuItem
+ MenuItem
->DescLen
+ 3);
1732 if (Index
++ > (PXEBC_MAX_MENU_NUM
- 1)) {
1737 if (UseDefaultItem
) {
1738 *Type
= MenuArray
[0]->Type
;
1739 *Type
= NTOHS (*Type
);
1745 for (Index
= 0; Index
< MenuNum
; Index
++) {
1746 PxeBcDisplayBootItem (MenuArray
[Index
]->DescStr
, MenuArray
[Index
]->DescLen
);
1749 TopRow
= gST
->ConOut
->Mode
->CursorRow
- MenuNum
;
1753 // highlight selected row
1755 gST
->ConOut
->SetAttribute (gST
->ConOut
, EFI_TEXT_ATTR (EFI_BLACK
, EFI_LIGHTGRAY
));
1756 gST
->ConOut
->SetCursorPosition (gST
->ConOut
, 0, TopRow
+ Select
);
1757 Blank
[MenuArray
[Select
]->DescLen
] = 0;
1758 AsciiPrint ("%a\r", Blank
);
1759 PxeBcDisplayBootItem (MenuArray
[Select
]->DescStr
, MenuArray
[Select
]->DescLen
);
1760 gST
->ConOut
->SetCursorPosition (gST
->ConOut
, 0, TopRow
+ MenuNum
);
1761 LastSelect
= Select
;
1763 while (gST
->ConIn
->ReadKeyStroke (gST
->ConIn
, &InputKey
) == EFI_NOT_READY
) {
1764 gBS
->Stall (10 * TICKS_PER_MS
);
1767 if (!InputKey
.ScanCode
) {
1768 switch (InputKey
.UnicodeChar
) {
1770 InputKey
.ScanCode
= SCAN_ESC
;
1773 case CTRL ('j'): /* linefeed */
1774 case CTRL ('m'): /* return */
1778 case CTRL ('i'): /* tab */
1782 InputKey
.ScanCode
= SCAN_DOWN
;
1785 case CTRL ('h'): /* backspace */
1788 InputKey
.ScanCode
= SCAN_UP
;
1792 InputKey
.ScanCode
= 0;
1796 switch (InputKey
.ScanCode
) {
1807 if (++Select
== MenuNum
) {
1818 case SCAN_PAGE_DOWN
:
1820 Select
= (UINT16
) (MenuNum
- 1);
1827 /* unhighlight last selected row */
1828 gST
->ConOut
->SetAttribute (gST
->ConOut
, EFI_TEXT_ATTR (EFI_LIGHTGRAY
, EFI_BLACK
));
1829 gST
->ConOut
->SetCursorPosition (gST
->ConOut
, 0, TopRow
+ LastSelect
);
1830 Blank
[MenuArray
[LastSelect
]->DescLen
] = 0;
1831 AsciiPrint ("%a\r", Blank
);
1832 PxeBcDisplayBootItem (MenuArray
[LastSelect
]->DescStr
, MenuArray
[LastSelect
]->DescLen
);
1833 gST
->ConOut
->SetCursorPosition (gST
->ConOut
, 0, TopRow
+ MenuNum
);
1837 // Swap the byte order
1839 CopyMem (Type
, &MenuArray
[Select
]->Type
, sizeof (UINT16
));
1840 *Type
= NTOHS (*Type
);