4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Routines used to operate the Ip4 configure variable.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncCopyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncThis program and the accompanying materials
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncare licensed and made available under the terms and conditions of the BSD License
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncwhich accompanies this distribution. The full text of the license may be found at<BR>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncTHE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncWITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Check whether the configure parameter is valid.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param NicConfig The configure parameter to check
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return TRUE if the parameter is valid for the interface, otherwise FALSE.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (NicConfig->Source == IP4_CONFIG_SOURCE_STATIC) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Validate that the addresses are unicast and mask
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // is properly formated
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((Netmask == 0) || !IP4_IS_VALID_NETMASK (Netmask) ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (Station == 0) || !NetIp4IsUnicast (Station, Netmask)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Validate that the next hops are on the connected network
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // or that is a direct route (Gateway == 0).
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (Index = 0; Index < IpConfig->RouteTableSize; Index++) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Gateway = EFI_NTOHL (IpConfig->RouteTable[Index].GatewayAddress);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((Gateway != 0) && (!IP4_NET_EQUAL (Station, Gateway, Netmask) ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // return false if it is an unkown configure source. Valid
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // sources are static and dhcp.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return (BOOLEAN) (NicConfig->Source == IP4_CONFIG_SOURCE_DHCP);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Read the ip4 configure variable from the EFI variable.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Instance The IP4 CONFIG instance.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return The IP4 configure read if it is there and is valid, otherwise NULL.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync NicConfig = GetVariable (Instance->MacString, &gEfiNicIp4ConfigVariableGuid);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Ip4ConfigFixRouteTablePointer (&NicConfig->Ip4Info);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Write the IP4 configure variable to the NVRAM. If Config
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync is NULL, remove the variable.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Instance The IP4 CONFIG instance.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param NicConfig The IP4 configure data to write.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The variable is written to the NVRam.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval Others Failed to write the variable.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (NicConfig == NULL) ? 0 : SIZEOF_NIC_IP4_CONFIG_INFO (NicConfig),
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Check whether a NIC exist in the platform given its MAC address.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param NicAddr The MAC address for the NIC to be checked.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval TRUE The NIC exist in the platform.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval FALSE The NIC doesn't exist in the platform.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Locate Service Binding handles.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (Index = 0; Index < NumberOfHandles; Index++) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get MAC address.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = NetLibGetMacAddress (HandleBuffer[Index], &MacAddr, &AddrSize);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((NicAddr->Len == AddrSize) && (CompareMem (NicAddr->MacAddr.Addr, MacAddr.Addr, AddrSize) == 0)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Reclaim Ip4Config Variables for NIC which has been removed from the platform.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check whether we need perform reclaim.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get all Ip4Config Variable.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VariableName = AllocateZeroPool (VariableNameSize);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VariableName = ReallocatePool (VariableNameBufferSize, VariableNameSize, VariableName);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Try again using the new buffer.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // No more variable available, finish search.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check variable GUID.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!CompareGuid (&VendorGuid, &gEfiNicIp4ConfigVariableGuid)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync NicConfig = GetVariable (VariableName, &gEfiNicIp4ConfigVariableGuid);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // No NIC found for this Ip4Config variable, remove it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Since we are in loop of GetNextVariableName(), we need move on to next
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Variable first and then delete current Variable.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CurrentVariableName = AllocateCopyPool (VariableNameSize, VariableName);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // We already get next variable, go to check it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Fix the RouteTable pointer in an EFI_IP4_IPCONFIG_DATA structure.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync The pointer is set to be immediately follow the ConfigData if there're entries
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync in the RouteTable. Otherwise it is set to NULL.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param ConfigData The IP4 IP configure data.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // The memory used for route table entries must immediately follow
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // the ConfigData and be not packed.