| /** @file | |
| DevicePathToText protocol as defined in the UEFI 2.0 specification. | |
| Copyright (c) 2013 - 2014, Intel Corporation. All rights reserved.<BR> | |
| 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 "UefiDevicePathLib.h" | |
| /** | |
| Concatenates a formatted unicode string to allocated pool. The caller must | |
| free the resulting buffer. | |
| @param Str Tracks the allocated pool, size in use, and | |
| amount of pool allocated. | |
| @param Fmt The format string | |
| @param ... Variable arguments based on the format string. | |
| @return Allocated buffer with the formatted string printed in it. | |
| The caller must free the allocated buffer. The buffer | |
| allocation is not packed. | |
| **/ | |
| CHAR16 * | |
| EFIAPI | |
| UefiDevicePathLibCatPrint ( | |
| IN OUT POOL_PRINT *Str, | |
| IN CHAR16 *Fmt, | |
| ... | |
| ) | |
| { | |
| UINTN Count; | |
| VA_LIST Args; | |
| VA_START (Args, Fmt); | |
| Count = SPrintLength (Fmt, Args); | |
| if ((Str->Count + (Count + 1)) * sizeof (CHAR16) > Str->Capacity) { | |
| Str->Capacity = (Str->Count + (Count + 1) * 2) * sizeof (CHAR16); | |
| Str->Str = ReallocatePool ( | |
| Str->Count * sizeof (CHAR16), | |
| Str->Capacity, | |
| Str->Str | |
| ); | |
| ASSERT (Str->Str != NULL); | |
| } | |
| UnicodeVSPrint (&Str->Str[Str->Count], Str->Capacity - Str->Count * sizeof (CHAR16), Fmt, Args); | |
| Str->Count += Count; | |
| VA_END (Args); | |
| return Str->Str; | |
| } | |
| /** | |
| Converts a PCI device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextPci ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| PCI_DEVICE_PATH *Pci; | |
| Pci = DevPath; | |
| UefiDevicePathLibCatPrint (Str, L"Pci(0x%x,0x%x)", Pci->Device, Pci->Function); | |
| } | |
| /** | |
| Converts a PC Card device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextPccard ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| PCCARD_DEVICE_PATH *Pccard; | |
| Pccard = DevPath; | |
| UefiDevicePathLibCatPrint (Str, L"PcCard(0x%x)", Pccard->FunctionNumber); | |
| } | |
| /** | |
| Converts a Memory Map device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextMemMap ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| MEMMAP_DEVICE_PATH *MemMap; | |
| MemMap = DevPath; | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"MemoryMapped(0x%x,0x%lx,0x%lx)", | |
| MemMap->MemoryType, | |
| MemMap->StartingAddress, | |
| MemMap->EndingAddress | |
| ); | |
| } | |
| /** | |
| Converts a Vendor device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextVendor ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| VENDOR_DEVICE_PATH *Vendor; | |
| CHAR16 *Type; | |
| UINTN Index; | |
| UINTN DataLength; | |
| UINT32 FlowControlMap; | |
| UINT16 Info; | |
| Vendor = (VENDOR_DEVICE_PATH *) DevPath; | |
| switch (DevicePathType (&Vendor->Header)) { | |
| case HARDWARE_DEVICE_PATH: | |
| Type = L"Hw"; | |
| break; | |
| case MESSAGING_DEVICE_PATH: | |
| Type = L"Msg"; | |
| if (AllowShortcuts) { | |
| if (CompareGuid (&Vendor->Guid, &gEfiPcAnsiGuid)) { | |
| UefiDevicePathLibCatPrint (Str, L"VenPcAnsi()"); | |
| return ; | |
| } else if (CompareGuid (&Vendor->Guid, &gEfiVT100Guid)) { | |
| UefiDevicePathLibCatPrint (Str, L"VenVt100()"); | |
| return ; | |
| } else if (CompareGuid (&Vendor->Guid, &gEfiVT100PlusGuid)) { | |
| UefiDevicePathLibCatPrint (Str, L"VenVt100Plus()"); | |
| return ; | |
| } else if (CompareGuid (&Vendor->Guid, &gEfiVTUTF8Guid)) { | |
| UefiDevicePathLibCatPrint (Str, L"VenUft8()"); | |
| return ; | |
| } else if (CompareGuid (&Vendor->Guid, &gEfiUartDevicePathGuid)) { | |
| FlowControlMap = (((UART_FLOW_CONTROL_DEVICE_PATH *) Vendor)->FlowControlMap); | |
| switch (FlowControlMap & 0x00000003) { | |
| case 0: | |
| UefiDevicePathLibCatPrint (Str, L"UartFlowCtrl(%s)", L"None"); | |
| break; | |
| case 1: | |
| UefiDevicePathLibCatPrint (Str, L"UartFlowCtrl(%s)", L"Hardware"); | |
| break; | |
| case 2: | |
| UefiDevicePathLibCatPrint (Str, L"UartFlowCtrl(%s)", L"XonXoff"); | |
| break; | |
| default: | |
| break; | |
| } | |
| return ; | |
| } else if (CompareGuid (&Vendor->Guid, &gEfiSasDevicePathGuid)) { | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"SAS(0x%lx,0x%lx,0x%x,", | |
| ((SAS_DEVICE_PATH *) Vendor)->SasAddress, | |
| ((SAS_DEVICE_PATH *) Vendor)->Lun, | |
| ((SAS_DEVICE_PATH *) Vendor)->RelativeTargetPort | |
| ); | |
| Info = (((SAS_DEVICE_PATH *) Vendor)->DeviceTopology); | |
| if (((Info & 0x0f) == 0) && ((Info & BIT7) == 0)) { | |
| UefiDevicePathLibCatPrint (Str, L"NoTopology,0,0,0,"); | |
| } else if (((Info & 0x0f) <= 2) && ((Info & BIT7) == 0)) { | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"%s,%s,%s,", | |
| ((Info & BIT4) != 0) ? L"SATA" : L"SAS", | |
| ((Info & BIT5) != 0) ? L"External" : L"Internal", | |
| ((Info & BIT6) != 0) ? L"Expanded" : L"Direct" | |
| ); | |
| if ((Info & 0x0f) == 1) { | |
| UefiDevicePathLibCatPrint (Str, L"0,"); | |
| } else { | |
| // | |
| // Value 0x0 thru 0xFF -> Drive 1 thru Drive 256 | |
| // | |
| UefiDevicePathLibCatPrint (Str, L"0x%x,", ((Info >> 8) & 0xff) + 1); | |
| } | |
| } else { | |
| UefiDevicePathLibCatPrint (Str, L"0x%x,0,0,0,", Info); | |
| } | |
| UefiDevicePathLibCatPrint (Str, L"0x%x)", ((SAS_DEVICE_PATH *) Vendor)->Reserved); | |
| return ; | |
| } else if (CompareGuid (&Vendor->Guid, &gEfiDebugPortProtocolGuid)) { | |
| UefiDevicePathLibCatPrint (Str, L"DebugPort()"); | |
| return ; | |
| } | |
| } | |
| break; | |
| case MEDIA_DEVICE_PATH: | |
| Type = L"Media"; | |
| break; | |
| default: | |
| Type = L"?"; | |
| break; | |
| } | |
| DataLength = DevicePathNodeLength (&Vendor->Header) - sizeof (VENDOR_DEVICE_PATH); | |
| UefiDevicePathLibCatPrint (Str, L"Ven%s(%g", Type, &Vendor->Guid); | |
| if (DataLength != 0) { | |
| UefiDevicePathLibCatPrint (Str, L","); | |
| for (Index = 0; Index < DataLength; Index++) { | |
| UefiDevicePathLibCatPrint (Str, L"%02x", ((VENDOR_DEVICE_PATH_WITH_DATA *) Vendor)->VendorDefinedData[Index]); | |
| } | |
| } | |
| UefiDevicePathLibCatPrint (Str, L")"); | |
| } | |
| /** | |
| Converts a Controller device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextController ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| CONTROLLER_DEVICE_PATH *Controller; | |
| Controller = DevPath; | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"Ctrl(0x%x)", | |
| Controller->ControllerNumber | |
| ); | |
| } | |
| /** | |
| Converts a ACPI device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextAcpi ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| ACPI_HID_DEVICE_PATH *Acpi; | |
| Acpi = DevPath; | |
| if ((Acpi->HID & PNP_EISA_ID_MASK) == PNP_EISA_ID_CONST) { | |
| switch (EISA_ID_TO_NUM (Acpi->HID)) { | |
| case 0x0a03: | |
| UefiDevicePathLibCatPrint (Str, L"PciRoot(0x%x)", Acpi->UID); | |
| break; | |
| case 0x0a08: | |
| UefiDevicePathLibCatPrint (Str, L"PcieRoot(0x%x)", Acpi->UID); | |
| break; | |
| case 0x0604: | |
| UefiDevicePathLibCatPrint (Str, L"Floppy(0x%x)", Acpi->UID); | |
| break; | |
| case 0x0301: | |
| UefiDevicePathLibCatPrint (Str, L"Keyboard(0x%x)", Acpi->UID); | |
| break; | |
| case 0x0501: | |
| UefiDevicePathLibCatPrint (Str, L"Serial(0x%x)", Acpi->UID); | |
| break; | |
| case 0x0401: | |
| UefiDevicePathLibCatPrint (Str, L"ParallelPort(0x%x)", Acpi->UID); | |
| break; | |
| default: | |
| UefiDevicePathLibCatPrint (Str, L"Acpi(PNP%04x,0x%x)", EISA_ID_TO_NUM (Acpi->HID), Acpi->UID); | |
| break; | |
| } | |
| } else { | |
| UefiDevicePathLibCatPrint (Str, L"Acpi(0x%08x,0x%x)", Acpi->HID, Acpi->UID); | |
| } | |
| } | |
| /** | |
| Converts a ACPI extended HID device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextAcpiEx ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| ACPI_EXTENDED_HID_DEVICE_PATH *AcpiEx; | |
| CHAR8 *HIDStr; | |
| CHAR8 *UIDStr; | |
| CHAR8 *CIDStr; | |
| CHAR16 HIDText[11]; | |
| CHAR16 CIDText[11]; | |
| AcpiEx = DevPath; | |
| HIDStr = (CHAR8 *) (((UINT8 *) AcpiEx) + sizeof (ACPI_EXTENDED_HID_DEVICE_PATH)); | |
| UIDStr = HIDStr + AsciiStrLen (HIDStr) + 1; | |
| CIDStr = UIDStr + AsciiStrLen (UIDStr) + 1; | |
| // | |
| // Converts EISA identification to string. | |
| // | |
| UnicodeSPrint ( | |
| HIDText, | |
| sizeof (HIDText), | |
| L"%c%c%c%04X", | |
| ((AcpiEx->HID >> 10) & 0x1f) + 'A' - 1, | |
| ((AcpiEx->HID >> 5) & 0x1f) + 'A' - 1, | |
| ((AcpiEx->HID >> 0) & 0x1f) + 'A' - 1, | |
| (AcpiEx->HID >> 16) & 0xFFFF | |
| ); | |
| UnicodeSPrint ( | |
| CIDText, | |
| sizeof (CIDText), | |
| L"%c%c%c%04X", | |
| ((AcpiEx->CID >> 10) & 0x1f) + 'A' - 1, | |
| ((AcpiEx->CID >> 5) & 0x1f) + 'A' - 1, | |
| ((AcpiEx->CID >> 0) & 0x1f) + 'A' - 1, | |
| (AcpiEx->CID >> 16) & 0xFFFF | |
| ); | |
| if ((*HIDStr == '\0') && (*CIDStr == '\0') && (AcpiEx->UID == 0)) { | |
| // | |
| // use AcpiExp() | |
| // | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"AcpiExp(%s,%s,%a)", | |
| HIDText, | |
| CIDText, | |
| UIDStr | |
| ); | |
| } else { | |
| if (AllowShortcuts) { | |
| // | |
| // display only | |
| // | |
| if (AcpiEx->HID == 0) { | |
| UefiDevicePathLibCatPrint (Str, L"AcpiEx(%a,", HIDStr); | |
| } else { | |
| UefiDevicePathLibCatPrint (Str, L"AcpiEx(%s,", HIDText); | |
| } | |
| if (AcpiEx->UID == 0) { | |
| UefiDevicePathLibCatPrint (Str, L"%a,", UIDStr); | |
| } else { | |
| UefiDevicePathLibCatPrint (Str, L"0x%x,", AcpiEx->UID); | |
| } | |
| if (AcpiEx->CID == 0) { | |
| UefiDevicePathLibCatPrint (Str, L"%a)", CIDStr); | |
| } else { | |
| UefiDevicePathLibCatPrint (Str, L"%s)", CIDText); | |
| } | |
| } else { | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"AcpiEx(%s,%s,0x%x,%a,%a,%a)", | |
| HIDText, | |
| CIDText, | |
| AcpiEx->UID, | |
| HIDStr, | |
| CIDStr, | |
| UIDStr | |
| ); | |
| } | |
| } | |
| } | |
| /** | |
| Converts a ACPI address device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextAcpiAdr ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| ACPI_ADR_DEVICE_PATH *AcpiAdr; | |
| UINT16 Index; | |
| UINT16 Length; | |
| UINT16 AdditionalAdrCount; | |
| AcpiAdr = DevPath; | |
| Length = (UINT16) DevicePathNodeLength ((EFI_DEVICE_PATH_PROTOCOL *) AcpiAdr); | |
| AdditionalAdrCount = (UINT16) ((Length - 8) / 4); | |
| UefiDevicePathLibCatPrint (Str, L"AcpiAdr(0x%x", AcpiAdr->ADR); | |
| for (Index = 0; Index < AdditionalAdrCount; Index++) { | |
| UefiDevicePathLibCatPrint (Str, L",0x%x", *(UINT32 *) ((UINT8 *) AcpiAdr + 8 + Index * 4)); | |
| } | |
| UefiDevicePathLibCatPrint (Str, L")"); | |
| } | |
| /** | |
| Converts a ATAPI device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextAtapi ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| ATAPI_DEVICE_PATH *Atapi; | |
| Atapi = DevPath; | |
| if (DisplayOnly) { | |
| UefiDevicePathLibCatPrint (Str, L"Ata(0x%x)", Atapi->Lun); | |
| } else { | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"Ata(%s,%s,0x%x)", | |
| (Atapi->PrimarySecondary == 1) ? L"Secondary" : L"Primary", | |
| (Atapi->SlaveMaster == 1) ? L"Slave" : L"Master", | |
| Atapi->Lun | |
| ); | |
| } | |
| } | |
| /** | |
| Converts a SCSI device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextScsi ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| SCSI_DEVICE_PATH *Scsi; | |
| Scsi = DevPath; | |
| UefiDevicePathLibCatPrint (Str, L"Scsi(0x%x,0x%x)", Scsi->Pun, Scsi->Lun); | |
| } | |
| /** | |
| Converts a Fibre device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextFibre ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| FIBRECHANNEL_DEVICE_PATH *Fibre; | |
| Fibre = DevPath; | |
| UefiDevicePathLibCatPrint (Str, L"Fibre(0x%lx,0x%lx)", Fibre->WWN, Fibre->Lun); | |
| } | |
| /** | |
| Converts a FibreEx device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextFibreEx ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| FIBRECHANNELEX_DEVICE_PATH *FibreEx; | |
| UINTN Index; | |
| FibreEx = DevPath; | |
| UefiDevicePathLibCatPrint (Str, L"FibreEx(0x"); | |
| for (Index = 0; Index < sizeof (FibreEx->WWN) / sizeof (FibreEx->WWN[0]); Index++) { | |
| UefiDevicePathLibCatPrint (Str, L"%02x", FibreEx->WWN[Index]); | |
| } | |
| UefiDevicePathLibCatPrint (Str, L",0x"); | |
| for (Index = 0; Index < sizeof (FibreEx->Lun) / sizeof (FibreEx->Lun[0]); Index++) { | |
| UefiDevicePathLibCatPrint (Str, L"%02x", FibreEx->Lun[Index]); | |
| } | |
| UefiDevicePathLibCatPrint (Str, L")"); | |
| } | |
| /** | |
| Converts a Sas Ex device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextSasEx ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| SASEX_DEVICE_PATH *SasEx; | |
| UINTN Index; | |
| SasEx = DevPath; | |
| UefiDevicePathLibCatPrint (Str, L"SasEx(0x"); | |
| for (Index = 0; Index < sizeof (SasEx->SasAddress) / sizeof (SasEx->SasAddress[0]); Index++) { | |
| UefiDevicePathLibCatPrint (Str, L"%02x", SasEx->SasAddress[Index]); | |
| } | |
| UefiDevicePathLibCatPrint (Str, L",0x"); | |
| for (Index = 0; Index < sizeof (SasEx->Lun) / sizeof (SasEx->Lun[0]); Index++) { | |
| UefiDevicePathLibCatPrint (Str, L"%02x", SasEx->Lun[Index]); | |
| } | |
| UefiDevicePathLibCatPrint (Str, L",0x%x,", SasEx->RelativeTargetPort); | |
| if (((SasEx->DeviceTopology & 0x0f) == 0) && ((SasEx->DeviceTopology & BIT7) == 0)) { | |
| UefiDevicePathLibCatPrint (Str, L"NoTopology,0,0,0"); | |
| } else if (((SasEx->DeviceTopology & 0x0f) <= 2) && ((SasEx->DeviceTopology & BIT7) == 0)) { | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"%s,%s,%s,", | |
| ((SasEx->DeviceTopology & BIT4) != 0) ? L"SATA" : L"SAS", | |
| ((SasEx->DeviceTopology & BIT5) != 0) ? L"External" : L"Internal", | |
| ((SasEx->DeviceTopology & BIT6) != 0) ? L"Expanded" : L"Direct" | |
| ); | |
| if ((SasEx->DeviceTopology & 0x0f) == 1) { | |
| UefiDevicePathLibCatPrint (Str, L"0"); | |
| } else { | |
| // | |
| // Value 0x0 thru 0xFF -> Drive 1 thru Drive 256 | |
| // | |
| UefiDevicePathLibCatPrint (Str, L"0x%x", ((SasEx->DeviceTopology >> 8) & 0xff) + 1); | |
| } | |
| } else { | |
| UefiDevicePathLibCatPrint (Str, L"0x%x,0,0,0", SasEx->DeviceTopology); | |
| } | |
| UefiDevicePathLibCatPrint (Str, L")"); | |
| return ; | |
| } | |
| /** | |
| Converts a NVM Express Namespace device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextNVMe ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| NVME_NAMESPACE_DEVICE_PATH *Nvme; | |
| UINT8 *Uuid; | |
| Nvme = DevPath; | |
| Uuid = (UINT8 *) &Nvme->NamespaceUuid; | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"NVMe(0x%x,%02x-%02x-%02x-%02x-%02x-%02x-%02x-%02x)", | |
| Nvme->NamespaceId, | |
| Uuid[7], Uuid[6], Uuid[5], Uuid[4], | |
| Uuid[3], Uuid[2], Uuid[1], Uuid[0] | |
| ); | |
| } | |
| /** | |
| Converts a 1394 device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToText1394 ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| F1394_DEVICE_PATH *F1394DevPath; | |
| F1394DevPath = DevPath; | |
| // | |
| // Guid has format of IEEE-EUI64 | |
| // | |
| UefiDevicePathLibCatPrint (Str, L"I1394(%016lx)", F1394DevPath->Guid); | |
| } | |
| /** | |
| Converts a USB device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextUsb ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| USB_DEVICE_PATH *Usb; | |
| Usb = DevPath; | |
| UefiDevicePathLibCatPrint (Str, L"USB(0x%x,0x%x)", Usb->ParentPortNumber, Usb->InterfaceNumber); | |
| } | |
| /** | |
| Converts a USB WWID device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextUsbWWID ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| USB_WWID_DEVICE_PATH *UsbWWId; | |
| CHAR16 *SerialNumberStr; | |
| CHAR16 *NewStr; | |
| UINT16 Length; | |
| UsbWWId = DevPath; | |
| SerialNumberStr = (CHAR16 *) ((UINT8 *) UsbWWId + sizeof (USB_WWID_DEVICE_PATH)); | |
| Length = (UINT16) ((DevicePathNodeLength ((EFI_DEVICE_PATH_PROTOCOL *) UsbWWId) - sizeof (USB_WWID_DEVICE_PATH)) / sizeof (CHAR16)); | |
| if (SerialNumberStr [Length - 1] != 0) { | |
| // | |
| // In case no NULL terminator in SerialNumber, create a new one with NULL terminator | |
| // | |
| NewStr = AllocateCopyPool ((Length + 1) * sizeof (CHAR16), SerialNumberStr); | |
| ASSERT (NewStr != NULL); | |
| NewStr [Length] = 0; | |
| SerialNumberStr = NewStr; | |
| } | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"UsbWwid(0x%x,0x%x,0x%x,\"%s\")", | |
| UsbWWId->VendorId, | |
| UsbWWId->ProductId, | |
| UsbWWId->InterfaceNumber, | |
| SerialNumberStr | |
| ); | |
| } | |
| /** | |
| Converts a Logic Unit device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextLogicalUnit ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| DEVICE_LOGICAL_UNIT_DEVICE_PATH *LogicalUnit; | |
| LogicalUnit = DevPath; | |
| UefiDevicePathLibCatPrint (Str, L"Unit(0x%x)", LogicalUnit->Lun); | |
| } | |
| /** | |
| Converts a USB class device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextUsbClass ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| USB_CLASS_DEVICE_PATH *UsbClass; | |
| BOOLEAN IsKnownSubClass; | |
| UsbClass = DevPath; | |
| IsKnownSubClass = TRUE; | |
| switch (UsbClass->DeviceClass) { | |
| case USB_CLASS_AUDIO: | |
| UefiDevicePathLibCatPrint (Str, L"UsbAudio"); | |
| break; | |
| case USB_CLASS_CDCCONTROL: | |
| UefiDevicePathLibCatPrint (Str, L"UsbCDCControl"); | |
| break; | |
| case USB_CLASS_HID: | |
| UefiDevicePathLibCatPrint (Str, L"UsbHID"); | |
| break; | |
| case USB_CLASS_IMAGE: | |
| UefiDevicePathLibCatPrint (Str, L"UsbImage"); | |
| break; | |
| case USB_CLASS_PRINTER: | |
| UefiDevicePathLibCatPrint (Str, L"UsbPrinter"); | |
| break; | |
| case USB_CLASS_MASS_STORAGE: | |
| UefiDevicePathLibCatPrint (Str, L"UsbMassStorage"); | |
| break; | |
| case USB_CLASS_HUB: | |
| UefiDevicePathLibCatPrint (Str, L"UsbHub"); | |
| break; | |
| case USB_CLASS_CDCDATA: | |
| UefiDevicePathLibCatPrint (Str, L"UsbCDCData"); | |
| break; | |
| case USB_CLASS_SMART_CARD: | |
| UefiDevicePathLibCatPrint (Str, L"UsbSmartCard"); | |
| break; | |
| case USB_CLASS_VIDEO: | |
| UefiDevicePathLibCatPrint (Str, L"UsbVideo"); | |
| break; | |
| case USB_CLASS_DIAGNOSTIC: | |
| UefiDevicePathLibCatPrint (Str, L"UsbDiagnostic"); | |
| break; | |
| case USB_CLASS_WIRELESS: | |
| UefiDevicePathLibCatPrint (Str, L"UsbWireless"); | |
| break; | |
| default: | |
| IsKnownSubClass = FALSE; | |
| break; | |
| } | |
| if (IsKnownSubClass) { | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"(0x%x,0x%x,0x%x,0x%x)", | |
| UsbClass->VendorId, | |
| UsbClass->ProductId, | |
| UsbClass->DeviceSubClass, | |
| UsbClass->DeviceProtocol | |
| ); | |
| return; | |
| } | |
| if (UsbClass->DeviceClass == USB_CLASS_RESERVE) { | |
| if (UsbClass->DeviceSubClass == USB_SUBCLASS_FW_UPDATE) { | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"UsbDeviceFirmwareUpdate(0x%x,0x%x,0x%x)", | |
| UsbClass->VendorId, | |
| UsbClass->ProductId, | |
| UsbClass->DeviceProtocol | |
| ); | |
| return; | |
| } else if (UsbClass->DeviceSubClass == USB_SUBCLASS_IRDA_BRIDGE) { | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"UsbIrdaBridge(0x%x,0x%x,0x%x)", | |
| UsbClass->VendorId, | |
| UsbClass->ProductId, | |
| UsbClass->DeviceProtocol | |
| ); | |
| return; | |
| } else if (UsbClass->DeviceSubClass == USB_SUBCLASS_TEST) { | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"UsbTestAndMeasurement(0x%x,0x%x,0x%x)", | |
| UsbClass->VendorId, | |
| UsbClass->ProductId, | |
| UsbClass->DeviceProtocol | |
| ); | |
| return; | |
| } | |
| } | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"UsbClass(0x%x,0x%x,0x%x,0x%x,0x%x)", | |
| UsbClass->VendorId, | |
| UsbClass->ProductId, | |
| UsbClass->DeviceClass, | |
| UsbClass->DeviceSubClass, | |
| UsbClass->DeviceProtocol | |
| ); | |
| } | |
| /** | |
| Converts a SATA device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextSata ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| SATA_DEVICE_PATH *Sata; | |
| Sata = DevPath; | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"Sata(0x%x,0x%x,0x%x)", | |
| Sata->HBAPortNumber, | |
| Sata->PortMultiplierPortNumber, | |
| Sata->Lun | |
| ); | |
| } | |
| /** | |
| Converts a I20 device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextI2O ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| I2O_DEVICE_PATH *I2ODevPath; | |
| I2ODevPath = DevPath; | |
| UefiDevicePathLibCatPrint (Str, L"I2O(0x%x)", I2ODevPath->Tid); | |
| } | |
| /** | |
| Converts a MAC address device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextMacAddr ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| MAC_ADDR_DEVICE_PATH *MacDevPath; | |
| UINTN HwAddressSize; | |
| UINTN Index; | |
| MacDevPath = DevPath; | |
| HwAddressSize = sizeof (EFI_MAC_ADDRESS); | |
| if (MacDevPath->IfType == 0x01 || MacDevPath->IfType == 0x00) { | |
| HwAddressSize = 6; | |
| } | |
| UefiDevicePathLibCatPrint (Str, L"MAC("); | |
| for (Index = 0; Index < HwAddressSize; Index++) { | |
| UefiDevicePathLibCatPrint (Str, L"%02x", MacDevPath->MacAddress.Addr[Index]); | |
| } | |
| UefiDevicePathLibCatPrint (Str, L",0x%x)", MacDevPath->IfType); | |
| } | |
| /** | |
| Converts network protocol string to its text representation. | |
| @param Str The string representative of input device. | |
| @param Protocol The network protocol ID. | |
| **/ | |
| VOID | |
| CatNetworkProtocol ( | |
| IN OUT POOL_PRINT *Str, | |
| IN UINT16 Protocol | |
| ) | |
| { | |
| if (Protocol == RFC_1700_TCP_PROTOCOL) { | |
| UefiDevicePathLibCatPrint (Str, L"TCP"); | |
| } else if (Protocol == RFC_1700_UDP_PROTOCOL) { | |
| UefiDevicePathLibCatPrint (Str, L"UDP"); | |
| } else { | |
| UefiDevicePathLibCatPrint (Str, L"0x%x", Protocol); | |
| } | |
| } | |
| /** | |
| Converts IP v4 address to its text representation. | |
| @param Str The string representative of input device. | |
| @param Address The IP v4 address. | |
| **/ | |
| VOID | |
| CatIPv4Address ( | |
| IN OUT POOL_PRINT *Str, | |
| IN EFI_IPv4_ADDRESS *Address | |
| ) | |
| { | |
| UefiDevicePathLibCatPrint (Str, L"%d.%d.%d.%d", Address->Addr[0], Address->Addr[1], Address->Addr[2], Address->Addr[3]); | |
| } | |
| /** | |
| Converts IP v6 address to its text representation. | |
| @param Str The string representative of input device. | |
| @param Address The IP v6 address. | |
| **/ | |
| VOID | |
| CatIPv6Address ( | |
| IN OUT POOL_PRINT *Str, | |
| IN EFI_IPv6_ADDRESS *Address | |
| ) | |
| { | |
| UefiDevicePathLibCatPrint ( | |
| Str, L"%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x", | |
| Address->Addr[0], Address->Addr[1], | |
| Address->Addr[2], Address->Addr[3], | |
| Address->Addr[4], Address->Addr[5], | |
| Address->Addr[6], Address->Addr[7], | |
| Address->Addr[8], Address->Addr[9], | |
| Address->Addr[10], Address->Addr[11], | |
| Address->Addr[12], Address->Addr[13], | |
| Address->Addr[14], Address->Addr[15] | |
| ); | |
| } | |
| /** | |
| Converts a IPv4 device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextIPv4 ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| IPv4_DEVICE_PATH *IPDevPath; | |
| IPDevPath = DevPath; | |
| UefiDevicePathLibCatPrint (Str, L"IPv4("); | |
| CatIPv4Address (Str, &IPDevPath->RemoteIpAddress); | |
| if (DisplayOnly) { | |
| UefiDevicePathLibCatPrint (Str, L")"); | |
| return ; | |
| } | |
| UefiDevicePathLibCatPrint (Str, L","); | |
| CatNetworkProtocol (Str, IPDevPath->Protocol); | |
| UefiDevicePathLibCatPrint (Str, L",%s,", IPDevPath->StaticIpAddress ? L"Static" : L"DHCP"); | |
| CatIPv4Address (Str, &IPDevPath->LocalIpAddress); | |
| if (DevicePathNodeLength (IPDevPath) == sizeof (IPv4_DEVICE_PATH)) { | |
| UefiDevicePathLibCatPrint (Str, L","); | |
| CatIPv4Address (Str, &IPDevPath->GatewayIpAddress); | |
| UefiDevicePathLibCatPrint (Str, L","); | |
| CatIPv4Address (Str, &IPDevPath->SubnetMask); | |
| } | |
| UefiDevicePathLibCatPrint (Str, L")"); | |
| } | |
| /** | |
| Converts a IPv6 device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextIPv6 ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| IPv6_DEVICE_PATH *IPDevPath; | |
| IPDevPath = DevPath; | |
| UefiDevicePathLibCatPrint (Str, L"IPv6("); | |
| CatIPv6Address (Str, &IPDevPath->RemoteIpAddress); | |
| if (DisplayOnly) { | |
| UefiDevicePathLibCatPrint (Str, L")"); | |
| return ; | |
| } | |
| UefiDevicePathLibCatPrint (Str, L","); | |
| CatNetworkProtocol (Str, IPDevPath->Protocol); | |
| switch (IPDevPath->IpAddressOrigin) { | |
| case 0: | |
| UefiDevicePathLibCatPrint (Str, L",Static,"); | |
| break; | |
| case 1: | |
| UefiDevicePathLibCatPrint (Str, L",StatelessAutoConfigure,"); | |
| break; | |
| default: | |
| UefiDevicePathLibCatPrint (Str, L",StatefulAutoConfigure,"); | |
| break; | |
| } | |
| CatIPv6Address (Str, &IPDevPath->LocalIpAddress); | |
| if (DevicePathNodeLength (IPDevPath) == sizeof (IPv6_DEVICE_PATH)) { | |
| UefiDevicePathLibCatPrint (Str, L",0x%x,", IPDevPath->PrefixLength); | |
| CatIPv6Address (Str, &IPDevPath->GatewayIpAddress); | |
| } | |
| UefiDevicePathLibCatPrint (Str, L")"); | |
| } | |
| /** | |
| Converts an Infini Band device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextInfiniBand ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| INFINIBAND_DEVICE_PATH *InfiniBand; | |
| InfiniBand = DevPath; | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"Infiniband(0x%x,%g,0x%lx,0x%lx,0x%lx)", | |
| InfiniBand->ResourceFlags, | |
| InfiniBand->PortGid, | |
| InfiniBand->ServiceId, | |
| InfiniBand->TargetPortId, | |
| InfiniBand->DeviceId | |
| ); | |
| } | |
| /** | |
| Converts a UART device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextUart ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| UART_DEVICE_PATH *Uart; | |
| CHAR8 Parity; | |
| Uart = DevPath; | |
| switch (Uart->Parity) { | |
| case 0: | |
| Parity = 'D'; | |
| break; | |
| case 1: | |
| Parity = 'N'; | |
| break; | |
| case 2: | |
| Parity = 'E'; | |
| break; | |
| case 3: | |
| Parity = 'O'; | |
| break; | |
| case 4: | |
| Parity = 'M'; | |
| break; | |
| case 5: | |
| Parity = 'S'; | |
| break; | |
| default: | |
| Parity = 'x'; | |
| break; | |
| } | |
| if (Uart->BaudRate == 0) { | |
| UefiDevicePathLibCatPrint (Str, L"Uart(DEFAULT,"); | |
| } else { | |
| UefiDevicePathLibCatPrint (Str, L"Uart(%ld,", Uart->BaudRate); | |
| } | |
| if (Uart->DataBits == 0) { | |
| UefiDevicePathLibCatPrint (Str, L"DEFAULT,"); | |
| } else { | |
| UefiDevicePathLibCatPrint (Str, L"%d,", Uart->DataBits); | |
| } | |
| UefiDevicePathLibCatPrint (Str, L"%c,", Parity); | |
| switch (Uart->StopBits) { | |
| case 0: | |
| UefiDevicePathLibCatPrint (Str, L"D)"); | |
| break; | |
| case 1: | |
| UefiDevicePathLibCatPrint (Str, L"1)"); | |
| break; | |
| case 2: | |
| UefiDevicePathLibCatPrint (Str, L"1.5)"); | |
| break; | |
| case 3: | |
| UefiDevicePathLibCatPrint (Str, L"2)"); | |
| break; | |
| default: | |
| UefiDevicePathLibCatPrint (Str, L"x)"); | |
| break; | |
| } | |
| } | |
| /** | |
| Converts an iSCSI device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextiSCSI ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| ISCSI_DEVICE_PATH_WITH_NAME *ISCSIDevPath; | |
| UINT16 Options; | |
| ISCSIDevPath = DevPath; | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"iSCSI(%a,0x%x,0x%lx,", | |
| ISCSIDevPath->TargetName, | |
| ISCSIDevPath->TargetPortalGroupTag, | |
| ISCSIDevPath->Lun | |
| ); | |
| Options = ISCSIDevPath->LoginOption; | |
| UefiDevicePathLibCatPrint (Str, L"%s,", (((Options >> 1) & 0x0001) != 0) ? L"CRC32C" : L"None"); | |
| UefiDevicePathLibCatPrint (Str, L"%s,", (((Options >> 3) & 0x0001) != 0) ? L"CRC32C" : L"None"); | |
| if (((Options >> 11) & 0x0001) != 0) { | |
| UefiDevicePathLibCatPrint (Str, L"%s,", L"None"); | |
| } else if (((Options >> 12) & 0x0001) != 0) { | |
| UefiDevicePathLibCatPrint (Str, L"%s,", L"CHAP_UNI"); | |
| } else { | |
| UefiDevicePathLibCatPrint (Str, L"%s,", L"CHAP_BI"); | |
| } | |
| UefiDevicePathLibCatPrint (Str, L"%s)", (ISCSIDevPath->NetworkProtocol == 0) ? L"TCP" : L"reserved"); | |
| } | |
| /** | |
| Converts a VLAN device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextVlan ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| VLAN_DEVICE_PATH *Vlan; | |
| Vlan = DevPath; | |
| UefiDevicePathLibCatPrint (Str, L"Vlan(%d)", Vlan->VlanId); | |
| } | |
| /** | |
| Converts a Hard drive device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextHardDrive ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| HARDDRIVE_DEVICE_PATH *Hd; | |
| Hd = DevPath; | |
| switch (Hd->SignatureType) { | |
| case SIGNATURE_TYPE_MBR: | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"HD(%d,%s,0x%08x,", | |
| Hd->PartitionNumber, | |
| L"MBR", | |
| *((UINT32 *) (&(Hd->Signature[0]))) | |
| ); | |
| break; | |
| case SIGNATURE_TYPE_GUID: | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"HD(%d,%s,%g,", | |
| Hd->PartitionNumber, | |
| L"GPT", | |
| (EFI_GUID *) &(Hd->Signature[0]) | |
| ); | |
| break; | |
| default: | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"HD(%d,%d,0,", | |
| Hd->PartitionNumber, | |
| Hd->SignatureType | |
| ); | |
| break; | |
| } | |
| UefiDevicePathLibCatPrint (Str, L"0x%lx,0x%lx)", Hd->PartitionStart, Hd->PartitionSize); | |
| } | |
| /** | |
| Converts a CDROM device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextCDROM ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| CDROM_DEVICE_PATH *Cd; | |
| Cd = DevPath; | |
| if (DisplayOnly) { | |
| UefiDevicePathLibCatPrint (Str, L"CDROM(0x%x)", Cd->BootEntry); | |
| return ; | |
| } | |
| UefiDevicePathLibCatPrint (Str, L"CDROM(0x%x,0x%lx,0x%lx)", Cd->BootEntry, Cd->PartitionStart, Cd->PartitionSize); | |
| } | |
| /** | |
| Converts a File device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextFilePath ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| FILEPATH_DEVICE_PATH *Fp; | |
| Fp = DevPath; | |
| UefiDevicePathLibCatPrint (Str, L"%s", Fp->PathName); | |
| } | |
| /** | |
| Converts a Media protocol device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextMediaProtocol ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| MEDIA_PROTOCOL_DEVICE_PATH *MediaProt; | |
| MediaProt = DevPath; | |
| UefiDevicePathLibCatPrint (Str, L"Media(%g)", &MediaProt->Protocol); | |
| } | |
| /** | |
| Converts a Firmware Volume device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextFv ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| MEDIA_FW_VOL_DEVICE_PATH *Fv; | |
| Fv = DevPath; | |
| UefiDevicePathLibCatPrint (Str, L"Fv(%g)", &Fv->FvName); | |
| } | |
| /** | |
| Converts a Firmware Volume File device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextFvFile ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| MEDIA_FW_VOL_FILEPATH_DEVICE_PATH *FvFile; | |
| FvFile = DevPath; | |
| UefiDevicePathLibCatPrint (Str, L"FvFile(%g)", &FvFile->FvFileName); | |
| } | |
| /** | |
| Converts a Relative Offset device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathRelativeOffsetRange ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| MEDIA_RELATIVE_OFFSET_RANGE_DEVICE_PATH *Offset; | |
| Offset = DevPath; | |
| UefiDevicePathLibCatPrint ( | |
| Str, | |
| L"Offset(0x%lx,0x%lx)", | |
| Offset->StartingOffset, | |
| Offset->EndingOffset | |
| ); | |
| } | |
| /** | |
| Converts a BIOS Boot Specification device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextBBS ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| BBS_BBS_DEVICE_PATH *Bbs; | |
| CHAR16 *Type; | |
| Bbs = DevPath; | |
| switch (Bbs->DeviceType) { | |
| case BBS_TYPE_FLOPPY: | |
| Type = L"Floppy"; | |
| break; | |
| case BBS_TYPE_HARDDRIVE: | |
| Type = L"HD"; | |
| break; | |
| case BBS_TYPE_CDROM: | |
| Type = L"CDROM"; | |
| break; | |
| case BBS_TYPE_PCMCIA: | |
| Type = L"PCMCIA"; | |
| break; | |
| case BBS_TYPE_USB: | |
| Type = L"USB"; | |
| break; | |
| case BBS_TYPE_EMBEDDED_NETWORK: | |
| Type = L"Network"; | |
| break; | |
| default: | |
| Type = NULL; | |
| break; | |
| } | |
| if (Type != NULL) { | |
| UefiDevicePathLibCatPrint (Str, L"BBS(%s,%a", Type, Bbs->String); | |
| } else { | |
| UefiDevicePathLibCatPrint (Str, L"BBS(0x%x,%a", Bbs->DeviceType, Bbs->String); | |
| } | |
| if (DisplayOnly) { | |
| UefiDevicePathLibCatPrint (Str, L")"); | |
| return ; | |
| } | |
| UefiDevicePathLibCatPrint (Str, L",0x%x)", Bbs->StatusFlag); | |
| } | |
| /** | |
| Converts an End-of-Device-Path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextEndInstance ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| UefiDevicePathLibCatPrint (Str, L","); | |
| } | |
| GLOBAL_REMOVE_IF_UNREFERENCED const DEVICE_PATH_TO_TEXT_GENERIC_TABLE mUefiDevicePathLibToTextTableGeneric[] = { | |
| {HARDWARE_DEVICE_PATH, L"HardwarePath" }, | |
| {ACPI_DEVICE_PATH, L"AcpiPath" }, | |
| {MESSAGING_DEVICE_PATH, L"Msg" }, | |
| {MEDIA_DEVICE_PATH, L"MediaPath" }, | |
| {BBS_DEVICE_PATH, L"BbsPath" }, | |
| {0, NULL} | |
| }; | |
| /** | |
| Converts an unknown device path structure to its string representative. | |
| @param Str The string representative of input device. | |
| @param DevPath The input device path structure. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| **/ | |
| VOID | |
| DevPathToTextNodeGeneric ( | |
| IN OUT POOL_PRINT *Str, | |
| IN VOID *DevPath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| EFI_DEVICE_PATH_PROTOCOL *Node; | |
| UINTN Index; | |
| Node = DevPath; | |
| for (Index = 0; mUefiDevicePathLibToTextTableGeneric[Index].Text != NULL; Index++) { | |
| if (DevicePathType (Node) == mUefiDevicePathLibToTextTableGeneric[Index].Type) { | |
| break; | |
| } | |
| } | |
| if (mUefiDevicePathLibToTextTableGeneric[Index].Text == NULL) { | |
| // | |
| // It's a node whose type cannot be recognized | |
| // | |
| UefiDevicePathLibCatPrint (Str, L"Path(%d,%d", DevicePathType (Node), DevicePathSubType (Node)); | |
| } else { | |
| // | |
| // It's a node whose type can be recognized | |
| // | |
| UefiDevicePathLibCatPrint (Str, L"%s(%d", mUefiDevicePathLibToTextTableGeneric[Index].Text, DevicePathSubType (Node)); | |
| } | |
| Index = sizeof (EFI_DEVICE_PATH_PROTOCOL); | |
| if (Index < DevicePathNodeLength (Node)) { | |
| UefiDevicePathLibCatPrint (Str, L","); | |
| for (; Index < DevicePathNodeLength (Node); Index++) { | |
| UefiDevicePathLibCatPrint (Str, L"%02x", ((UINT8 *) Node)[Index]); | |
| } | |
| } | |
| UefiDevicePathLibCatPrint (Str, L")"); | |
| } | |
| GLOBAL_REMOVE_IF_UNREFERENCED const DEVICE_PATH_TO_TEXT_TABLE mUefiDevicePathLibToTextTable[] = { | |
| {HARDWARE_DEVICE_PATH, HW_PCI_DP, DevPathToTextPci }, | |
| {HARDWARE_DEVICE_PATH, HW_PCCARD_DP, DevPathToTextPccard }, | |
| {HARDWARE_DEVICE_PATH, HW_MEMMAP_DP, DevPathToTextMemMap }, | |
| {HARDWARE_DEVICE_PATH, HW_VENDOR_DP, DevPathToTextVendor }, | |
| {HARDWARE_DEVICE_PATH, HW_CONTROLLER_DP, DevPathToTextController }, | |
| {ACPI_DEVICE_PATH, ACPI_DP, DevPathToTextAcpi }, | |
| {ACPI_DEVICE_PATH, ACPI_EXTENDED_DP, DevPathToTextAcpiEx }, | |
| {ACPI_DEVICE_PATH, ACPI_ADR_DP, DevPathToTextAcpiAdr }, | |
| {MESSAGING_DEVICE_PATH, MSG_ATAPI_DP, DevPathToTextAtapi }, | |
| {MESSAGING_DEVICE_PATH, MSG_SCSI_DP, DevPathToTextScsi }, | |
| {MESSAGING_DEVICE_PATH, MSG_FIBRECHANNEL_DP, DevPathToTextFibre }, | |
| {MESSAGING_DEVICE_PATH, MSG_FIBRECHANNELEX_DP, DevPathToTextFibreEx }, | |
| {MESSAGING_DEVICE_PATH, MSG_SASEX_DP, DevPathToTextSasEx }, | |
| {MESSAGING_DEVICE_PATH, MSG_NVME_NAMESPACE_DP, DevPathToTextNVMe }, | |
| {MESSAGING_DEVICE_PATH, MSG_1394_DP, DevPathToText1394 }, | |
| {MESSAGING_DEVICE_PATH, MSG_USB_DP, DevPathToTextUsb }, | |
| {MESSAGING_DEVICE_PATH, MSG_USB_WWID_DP, DevPathToTextUsbWWID }, | |
| {MESSAGING_DEVICE_PATH, MSG_DEVICE_LOGICAL_UNIT_DP, DevPathToTextLogicalUnit }, | |
| {MESSAGING_DEVICE_PATH, MSG_USB_CLASS_DP, DevPathToTextUsbClass }, | |
| {MESSAGING_DEVICE_PATH, MSG_SATA_DP, DevPathToTextSata }, | |
| {MESSAGING_DEVICE_PATH, MSG_I2O_DP, DevPathToTextI2O }, | |
| {MESSAGING_DEVICE_PATH, MSG_MAC_ADDR_DP, DevPathToTextMacAddr }, | |
| {MESSAGING_DEVICE_PATH, MSG_IPv4_DP, DevPathToTextIPv4 }, | |
| {MESSAGING_DEVICE_PATH, MSG_IPv6_DP, DevPathToTextIPv6 }, | |
| {MESSAGING_DEVICE_PATH, MSG_INFINIBAND_DP, DevPathToTextInfiniBand }, | |
| {MESSAGING_DEVICE_PATH, MSG_UART_DP, DevPathToTextUart }, | |
| {MESSAGING_DEVICE_PATH, MSG_VENDOR_DP, DevPathToTextVendor }, | |
| {MESSAGING_DEVICE_PATH, MSG_ISCSI_DP, DevPathToTextiSCSI }, | |
| {MESSAGING_DEVICE_PATH, MSG_VLAN_DP, DevPathToTextVlan }, | |
| {MEDIA_DEVICE_PATH, MEDIA_HARDDRIVE_DP, DevPathToTextHardDrive }, | |
| {MEDIA_DEVICE_PATH, MEDIA_CDROM_DP, DevPathToTextCDROM }, | |
| {MEDIA_DEVICE_PATH, MEDIA_VENDOR_DP, DevPathToTextVendor }, | |
| {MEDIA_DEVICE_PATH, MEDIA_PROTOCOL_DP, DevPathToTextMediaProtocol }, | |
| {MEDIA_DEVICE_PATH, MEDIA_FILEPATH_DP, DevPathToTextFilePath }, | |
| {MEDIA_DEVICE_PATH, MEDIA_PIWG_FW_VOL_DP, DevPathToTextFv }, | |
| {MEDIA_DEVICE_PATH, MEDIA_PIWG_FW_FILE_DP, DevPathToTextFvFile }, | |
| {MEDIA_DEVICE_PATH, MEDIA_RELATIVE_OFFSET_RANGE_DP, DevPathRelativeOffsetRange }, | |
| {BBS_DEVICE_PATH, BBS_BBS_DP, DevPathToTextBBS }, | |
| {END_DEVICE_PATH_TYPE, END_INSTANCE_DEVICE_PATH_SUBTYPE, DevPathToTextEndInstance }, | |
| {0, 0, NULL} | |
| }; | |
| /** | |
| Converts a device node to its string representation. | |
| @param DeviceNode A Pointer to the device node to be converted. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| @return A pointer to the allocated text representation of the device node or NULL if DeviceNode | |
| is NULL or there was insufficient memory. | |
| **/ | |
| CHAR16 * | |
| EFIAPI | |
| UefiDevicePathLibConvertDeviceNodeToText ( | |
| IN CONST EFI_DEVICE_PATH_PROTOCOL *DeviceNode, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| POOL_PRINT Str; | |
| UINTN Index; | |
| DEVICE_PATH_TO_TEXT ToText; | |
| if (DeviceNode == NULL) { | |
| return NULL; | |
| } | |
| ZeroMem (&Str, sizeof (Str)); | |
| // | |
| // Process the device path node | |
| // If not found, use a generic function | |
| // | |
| ToText = DevPathToTextNodeGeneric; | |
| for (Index = 0; mUefiDevicePathLibToTextTable[Index].Function != NULL; Index++) { | |
| if (DevicePathType (DeviceNode) == mUefiDevicePathLibToTextTable[Index].Type && | |
| DevicePathSubType (DeviceNode) == mUefiDevicePathLibToTextTable[Index].SubType | |
| ) { | |
| ToText = mUefiDevicePathLibToTextTable[Index].Function; | |
| break; | |
| } | |
| } | |
| // | |
| // Print this node | |
| // | |
| ToText (&Str, (VOID *) DeviceNode, DisplayOnly, AllowShortcuts); | |
| ASSERT (Str.Str != NULL); | |
| return Str.Str; | |
| } | |
| /** | |
| Converts a device path to its text representation. | |
| @param DevicePath A Pointer to the device to be converted. | |
| @param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation | |
| of the display node is used, where applicable. If DisplayOnly | |
| is FALSE, then the longer text representation of the display node | |
| is used. | |
| @param AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text | |
| representation for a device node can be used, where applicable. | |
| @return A pointer to the allocated text representation of the device path or | |
| NULL if DeviceNode is NULL or there was insufficient memory. | |
| **/ | |
| CHAR16 * | |
| EFIAPI | |
| UefiDevicePathLibConvertDevicePathToText ( | |
| IN CONST EFI_DEVICE_PATH_PROTOCOL *DevicePath, | |
| IN BOOLEAN DisplayOnly, | |
| IN BOOLEAN AllowShortcuts | |
| ) | |
| { | |
| POOL_PRINT Str; | |
| EFI_DEVICE_PATH_PROTOCOL *Node; | |
| EFI_DEVICE_PATH_PROTOCOL *AlignedNode; | |
| UINTN Index; | |
| DEVICE_PATH_TO_TEXT ToText; | |
| if (DevicePath == NULL) { | |
| return NULL; | |
| } | |
| ZeroMem (&Str, sizeof (Str)); | |
| // | |
| // Process each device path node | |
| // | |
| Node = (EFI_DEVICE_PATH_PROTOCOL *) DevicePath; | |
| while (!IsDevicePathEnd (Node)) { | |
| // | |
| // Find the handler to dump this device path node | |
| // If not found, use a generic function | |
| // | |
| ToText = DevPathToTextNodeGeneric; | |
| for (Index = 0; mUefiDevicePathLibToTextTable[Index].Function != NULL; Index += 1) { | |
| if (DevicePathType (Node) == mUefiDevicePathLibToTextTable[Index].Type && | |
| DevicePathSubType (Node) == mUefiDevicePathLibToTextTable[Index].SubType | |
| ) { | |
| ToText = mUefiDevicePathLibToTextTable[Index].Function; | |
| break; | |
| } | |
| } | |
| // | |
| // Put a path separator in if needed | |
| // | |
| if ((Str.Count != 0) && (ToText != DevPathToTextEndInstance)) { | |
| if (Str.Str[Str.Count] != L',') { | |
| UefiDevicePathLibCatPrint (&Str, L"/"); | |
| } | |
| } | |
| AlignedNode = AllocateCopyPool (DevicePathNodeLength (Node), Node); | |
| // | |
| // Print this node of the device path | |
| // | |
| ToText (&Str, AlignedNode, DisplayOnly, AllowShortcuts); | |
| FreePool (AlignedNode); | |
| // | |
| // Next device path node | |
| // | |
| Node = NextDevicePathNode (Node); | |
| } | |
| if (Str.Str == NULL) { | |
| return AllocateZeroPool (sizeof (CHAR16)); | |
| } else { | |
| return Str.Str; | |
| } | |
| } |