/** @file Support routines for PxeBc. Copyright (c) 2007 - 2017, Intel Corporation. All rights reserved.
This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License which accompanies this distribution. The full text of the license may be found at http://opensource.org/licenses/bsd-license.php THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. **/ #include "PxeBcImpl.h" /** The common notify function associated with various PxeBc events. @param Event The event signaled. @param Context The context. **/ VOID EFIAPI PxeBcCommonNotify ( IN EFI_EVENT Event, IN VOID *Context ) { *((BOOLEAN *) Context) = TRUE; } /** This function initialize(or configure) the Udp4Write instance. @param Udp4 Pointer to the EFI_UDP4_PROTOCOL instance. @param StationIp Pointer to the station ip address. @param SubnetMask Pointer to the subnetmask of the station ip address. @param Gateway Pointer to the gateway ip address. @param SrcPort Pointer to the srouce port of the station. @param Ttl The time to live field of the IP header. @param ToS The type of service field of the IP header. @retval EFI_SUCCESS The configuration settings were set, changed, or reset successfully. @retval EFI_NO_MAPPING When using a default address, configuration (DHCP, BOOTP, RARP, etc.) is not finished yet. @retval EFI_INVALID_PARAMETER One or more following conditions are TRUE: @retval EFI_ALREADY_STARTED The EFI UDPv4 Protocol instance is already started/configured and must be stopped/reset before it can be reconfigured. @retval EFI_ACCESS_DENIED UdpConfigData. AllowDuplicatePort is FALSE and UdpConfigData.StationPort is already used by other instance. @retval EFI_OUT_OF_RESOURCES The EFI UDPv4 Protocol driver cannot allocate memory for this EFI UDPv4 Protocol instance. @retval EFI_DEVICE_ERROR An unexpected network or system error occurred and this instance was not opened. @retval Others Please examine the function Udp4->Routes(Udp4, FALSE, &mZeroIp4Addr, &mZeroIp4Addr, Gateway) returns. **/ EFI_STATUS PxeBcConfigureUdpWriteInstance ( IN EFI_UDP4_PROTOCOL *Udp4, IN EFI_IPv4_ADDRESS *StationIp, IN EFI_IPv4_ADDRESS *SubnetMask, IN EFI_IPv4_ADDRESS *Gateway, IN OUT UINT16 *SrcPort, IN UINT8 Ttl, IN UINT8 ToS ) { EFI_UDP4_CONFIG_DATA Udp4CfgData; EFI_STATUS Status; ZeroMem (&Udp4CfgData, sizeof (Udp4CfgData)); Udp4CfgData.ReceiveTimeout = PXEBC_DEFAULT_LIFETIME; Udp4CfgData.TypeOfService = ToS; Udp4CfgData.TimeToLive = Ttl; Udp4CfgData.AllowDuplicatePort = TRUE; CopyMem (&Udp4CfgData.StationAddress, StationIp, sizeof (*StationIp)); CopyMem (&Udp4CfgData.SubnetMask, SubnetMask, sizeof (*SubnetMask)); Udp4CfgData.StationPort = *SrcPort; // // Reset the instance. // Udp4->Configure (Udp4, NULL); Status = Udp4->Configure (Udp4, &Udp4CfgData); if (!EFI_ERROR (Status) && (Gateway->Addr[0] != 0)) { // // basic configuration OK, need to add the default route entry // Status = Udp4->Routes (Udp4, FALSE, &mZeroIp4Addr, &mZeroIp4Addr, Gateway); if (EFI_ERROR (Status)) { // // roll back // Udp4->Configure (Udp4, NULL); } } if (!EFI_ERROR (Status) && (*SrcPort == 0)) { Udp4->GetModeData (Udp4, &Udp4CfgData, NULL, NULL, NULL); *SrcPort = Udp4CfgData.StationPort; } return Status; } /** This function is to display the IPv4 address. @param[in] Ip The pointer to the IPv4 address. **/ VOID PxeBcShowIp4Addr ( IN EFI_IPv4_ADDRESS *Ip ) { UINTN Index; for (Index = 0; Index < 4; Index++) { AsciiPrint ("%d", Ip->Addr[Index]); if (Index < 3) { AsciiPrint ("."); } } } /** Convert number to ASCII value. @param Number Numeric value to convert to decimal ASCII value. @param Buffer Buffer to place ASCII version of the Number. @param Length Length of Buffer. **/ VOID CvtNum ( IN UINTN Number, IN UINT8 *Buffer, IN UINTN Length ) { UINTN Remainder; for (; Length > 0; Length--) { Remainder = Number % 10; Number /= 10; Buffer[Length - 1] = (UINT8) ('0' + Remainder); } } /** Convert unsigned int number to decimal number. @param Number The unsigned int number will be converted. @param Buffer Pointer to the buffer to store the decimal number after transform. @param[in] BufferSize The maxsize of the buffer. @return the length of the number after transform. **/ UINTN UtoA10 ( IN UINTN Number, IN CHAR8 *Buffer, IN UINTN BufferSize ) { UINTN Index; CHAR8 TempStr[64]; Index = 63; TempStr[Index] = 0; do { Index--; TempStr[Index] = (CHAR8) ('0' + (Number % 10)); Number = Number / 10; } while (Number != 0); AsciiStrCpyS (Buffer, BufferSize, &TempStr[Index]); return AsciiStrLen (Buffer); } /** Convert ASCII numeric string to a UINTN value. @param Buffer Pointer to the 8-byte unsigned int value. @return UINTN value of the ASCII string. **/ UINT64 AtoU64 ( IN UINT8 *Buffer ) { UINT64 Value; UINT8 Character; Value = 0; while ((Character = *Buffer++) != '\0') { Value = MultU64x32 (Value, 10) + (Character - '0'); } return Value; }