[mirror_edk2.git] / MdeModulePkg / Universal / DevicePathDxe / DevicePathToText.c

/*++\r
\r
Copyright (c) 2006, Intel Corporation                                                         \r
All rights reserved. This program and the accompanying materials                          \r
are licensed and made available under the terms and conditions of the BSD License         \r
which accompanies this distribution.  The full text of the license may be found at        \r
http://opensource.org/licenses/bsd-license.php                                            \r
                                                                                          \r
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
\r
Module Name:\r
\r
  DevicePathToText.c\r
\r
Abstract:\r
\r
  DevicePathToText protocol as defined in the UEFI 2.0 specification.\r
\r
--*/\r
\r
//\r
// Include common header file for this module.\r
//\r
#include "CommonHeader.h"\r
\r
#include "DevicePath.h"\r
\r
STATIC\r
EFI_DEVICE_PATH_PROTOCOL *\r
UnpackDevicePath (\r
  IN EFI_DEVICE_PATH_PROTOCOL  *DevPath\r
  )\r
/*++\r
\r
  Routine Description:\r
    Function unpacks a device path data structure so that all the nodes of a device path \r
    are naturally aligned.\r
\r
  Arguments:\r
    DevPath        - A pointer to a device path data structure\r
\r
  Returns:\r
    If the memory for the device path is successfully allocated, then a pointer to the \r
    new device path is returned.  Otherwise, NULL is returned.\r
\r
--*/\r
{\r
  EFI_DEVICE_PATH_PROTOCOL  *Src;\r
  EFI_DEVICE_PATH_PROTOCOL  *Dest;\r
  EFI_DEVICE_PATH_PROTOCOL  *NewPath;\r
  UINTN                     Size;\r
\r
  if (DevPath == NULL) {\r
    return NULL;\r
  }\r
  //\r
  // Walk device path and round sizes to valid boundries\r
  //\r
  Src   = DevPath;\r
  Size  = 0;\r
  for (;;) {\r
    Size += DevicePathNodeLength (Src);\r
    Size += ALIGN_SIZE (Size);\r
\r
    if (IsDevicePathEnd (Src)) {\r
      break;\r
    }\r
\r
    Src = (EFI_DEVICE_PATH_PROTOCOL *) NextDevicePathNode (Src);\r
  }\r
  //\r
  // Allocate space for the unpacked path\r
  //\r
  NewPath = AllocateZeroPool (Size);\r
  if (NewPath != NULL) {\r
\r
    ASSERT (((UINTN) NewPath) % MIN_ALIGNMENT_SIZE == 0);\r
\r
    //\r
    // Copy each node\r
    //\r
    Src   = DevPath;\r
    Dest  = NewPath;\r
    for (;;) {\r
      Size = DevicePathNodeLength (Src);\r
      CopyMem (Dest, Src, Size);\r
      Size += ALIGN_SIZE (Size);\r
      SetDevicePathNodeLength (Dest, Size);\r
      Dest->Type |= EFI_DP_TYPE_UNPACKED;\r
      Dest = (EFI_DEVICE_PATH_PROTOCOL *) (((UINT8 *) Dest) + Size);\r
\r
      if (IsDevicePathEnd (Src)) {\r
        break;\r
      }\r
\r
      Src = (EFI_DEVICE_PATH_PROTOCOL *) NextDevicePathNode (Src);\r
    }\r
  }\r
\r
  return NewPath;\r
}\r
\r
STATIC\r
VOID *\r
ReallocatePool (\r
  IN VOID                 *OldPool,\r
  IN UINTN                OldSize,\r
  IN UINTN                NewSize\r
  )\r
/*++\r
\r
  Routine Description:\r
    Adjusts the size of a previously allocated buffer.\r
\r
  Arguments:\r
    OldPool               - A pointer to the buffer whose size is being adjusted.\r
    OldSize               - The size of the current buffer.\r
    NewSize               - The size of the new buffer.\r
\r
  Returns:\r
    EFI_SUCEESS           - The requested number of bytes were allocated.\r
    EFI_OUT_OF_RESOURCES  - The pool requested could not be allocated.\r
    EFI_INVALID_PARAMETER - The buffer was invalid.\r
\r
--*/\r
{\r
  VOID  *NewPool;\r
\r
  NewPool = NULL;\r
  if (NewSize) {\r
    NewPool = AllocateZeroPool (NewSize);\r
  }\r
\r
  if (OldPool) {\r
    if (NewPool) {\r
      CopyMem (NewPool, OldPool, OldSize < NewSize ? OldSize : NewSize);\r
    }\r
\r
    FreePool (OldPool);\r
  }\r
\r
  return NewPool;\r
}\r
\r
STATIC\r
CHAR16 *\r
CatPrint (\r
  IN OUT POOL_PRINT   *Str,\r
  IN CHAR16           *Fmt,\r
  ...\r
  )\r
/*++\r
\r
  Routine Description:\r
    Concatenates a formatted unicode string to allocated pool.  \r
    The caller must free the resulting buffer.\r
\r
  Arguments:\r
    Str         - Tracks the allocated pool, size in use, and \r
                  amount of pool allocated.\r
    Fmt         - The format string\r
\r
  Returns:\r
    Allocated buffer with the formatted string printed in it.  \r
    The caller must free the allocated buffer.   The buffer\r
    allocation is not packed.\r
\r
--*/\r
{\r
  UINT16  *AppendStr;\r
  VA_LIST Args;\r
  UINTN   Size;\r
\r
  AppendStr = AllocateZeroPool (0x1000);\r
  if (AppendStr == NULL) {\r
    return Str->Str;\r
  }\r
\r
  VA_START (Args, Fmt);\r
  UnicodeVSPrint (AppendStr, 0x1000, Fmt, Args);\r
  VA_END (Args);\r
  if (NULL == Str->Str) {\r
    Size   = StrSize (AppendStr);\r
    Str->Str  = AllocateZeroPool (Size);\r
    ASSERT (Str->Str != NULL);\r
  } else {\r
    Size = StrSize (AppendStr)  - sizeof (UINT16);\r
    Size = Size + StrSize (Str->Str);\r
    Str->Str = ReallocatePool (\r
                Str->Str,\r
                StrSize (Str->Str),\r
                Size\r
                );\r
    ASSERT (Str->Str != NULL);\r
  }\r
\r
  Str->MaxLen = MAX_CHAR * sizeof (UINT16);\r
  if (Size < Str->MaxLen) {\r
    StrCat (Str->Str, AppendStr);\r
    Str->Len = Size - sizeof (UINT16);\r
  }\r
\r
  FreePool (AppendStr);\r
  return Str->Str;\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextPci (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  PCI_DEVICE_PATH *Pci;\r
\r
  Pci = DevPath;\r
  CatPrint (Str, L"Pci(%x,%x)", Pci->Function, Pci->Device);\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextPccard (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  PCCARD_DEVICE_PATH  *Pccard;\r
\r
  Pccard = DevPath;\r
  CatPrint (Str, L"PcCard(%x)", Pccard->FunctionNumber);\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextMemMap (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  MEMMAP_DEVICE_PATH  *MemMap;\r
\r
  MemMap = DevPath;\r
  CatPrint (\r
    Str,\r
    L"MemoryMapped(%lx,%lx)",\r
    MemMap->StartingAddress,\r
    MemMap->EndingAddress\r
    );\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextVendor (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  VENDOR_DEVICE_PATH  *Vendor;\r
  CHAR16              *Type;\r
  UINTN               Index;\r
  UINT32              FlowControlMap;\r
  UINT16              Info;\r
\r
  Vendor = (VENDOR_DEVICE_PATH *) DevPath;\r
  switch (DevicePathType (&Vendor->Header)) {\r
  case HARDWARE_DEVICE_PATH:\r
    Type = L"Hw";\r
    break;\r
\r
  case MESSAGING_DEVICE_PATH:\r
    Type = L"Msg";\r
    if (AllowShortcuts) {\r
      if (CompareGuid (&Vendor->Guid, &gEfiPcAnsiGuid)) {\r
        CatPrint (Str, L"VenPcAnsi()");\r
        return ;\r
      } else if (CompareGuid (&Vendor->Guid, &gEfiVT100Guid)) {\r
        CatPrint (Str, L"VenVt100()");\r
        return ;\r
      } else if (CompareGuid (&Vendor->Guid, &gEfiVT100PlusGuid)) {\r
        CatPrint (Str, L"VenVt100Plus()");\r
        return ;\r
      } else if (CompareGuid (&Vendor->Guid, &gEfiVTUTF8Guid)) {\r
        CatPrint (Str, L"VenUft8()");\r
        return ;\r
      } else if (CompareGuid (&Vendor->Guid, &mEfiDevicePathMessagingUartFlowControlGuid)) {\r
        FlowControlMap = (((UART_FLOW_CONTROL_DEVICE_PATH *) Vendor)->FlowControlMap);\r
        switch (FlowControlMap & 0x00000003) {\r
        case 0:\r
          CatPrint (Str, L"UartFlowCtrl(%s)", L"None");\r
          break;\r
\r
        case 1:\r
          CatPrint (Str, L"UartFlowCtrl(%s)", L"Hardware");\r
          break;\r
\r
        case 2:\r
          CatPrint (Str, L"UartFlowCtrl(%s)", L"XonXoff");\r
          break;\r
\r
        default:\r
          break;\r
        }\r
\r
        return ;\r
      } else if (CompareGuid (&Vendor->Guid, &mEfiDevicePathMessagingSASGuid)) {\r
        CatPrint (\r
          Str,\r
          L"SAS(%lx,%lx,%x,",\r
          ((SAS_DEVICE_PATH *) Vendor)->SasAddress,\r
          ((SAS_DEVICE_PATH *) Vendor)->Lun,\r
          ((SAS_DEVICE_PATH *) Vendor)->RelativeTargetPort\r
          );\r
        Info = (((SAS_DEVICE_PATH *) Vendor)->DeviceTopology);\r
        if ((Info & 0x0f) == 0) {\r
          CatPrint (Str, L"NoTopology,0,0,0,");\r
        } else if (((Info & 0x0f) == 1) || ((Info & 0x0f) == 2)) {\r
          CatPrint (\r
            Str,\r
            L"%s,%s,%s,",\r
            (Info & (0x1 << 4)) ? L"SATA" : L"SAS",\r
            (Info & (0x1 << 5)) ? L"External" : L"Internal",\r
            (Info & (0x1 << 6)) ? L"Expanded" : L"Direct"\r
            );\r
          if ((Info & 0x0f) == 1) {\r
            CatPrint (Str, L"0,");\r
          } else {\r
            CatPrint (Str, L"%x,", (Info >> 8) & 0xff);\r
          }\r
        } else {\r
          CatPrint (Str, L"0,0,0,0,");\r
        }\r
\r
        CatPrint (Str, L"%x)", ((SAS_DEVICE_PATH *) Vendor)->Reserved);\r
        return ;\r
      } else if (CompareGuid (&Vendor->Guid, &gEfiDebugPortProtocolGuid)) {\r
        CatPrint (Str, L"DebugPort()");\r
        return ;\r
      } else {\r
        return ;\r
        //\r
        // reserved\r
        //\r
      }\r
    }\r
    break;\r
\r
  case MEDIA_DEVICE_PATH:\r
    Type = L"Media";\r
    break;\r
\r
  default:\r
    Type = L"?";\r
    break;\r
  }\r
\r
  CatPrint (Str, L"Ven%s(%g,", Type, &Vendor->Guid);\r
  for (Index = 0; Index < DevicePathNodeLength (&Vendor->Header) - sizeof (VENDOR_DEVICE_PATH); Index++) {\r
    CatPrint (Str, L"%02x", ((VENDOR_DEVICE_PATH_WITH_DATA *) Vendor)->VendorDefinedData[Index]);\r
  }\r
\r
  CatPrint (Str, L")");\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextController (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  CONTROLLER_DEVICE_PATH  *Controller;\r
\r
  Controller = DevPath;\r
  CatPrint (\r
    Str,\r
    L"Ctrl(%x)",\r
    Controller->ControllerNumber\r
    );\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextAcpi (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  ACPI_HID_DEVICE_PATH  *Acpi;\r
\r
  Acpi = DevPath;\r
  if ((Acpi->HID & PNP_EISA_ID_MASK) == PNP_EISA_ID_CONST) {\r
    if (AllowShortcuts) {\r
      switch (EISA_ID_TO_NUM (Acpi->HID)) {\r
      case 0x0a03:\r
        CatPrint (Str, L"PciRoot(%x)", Acpi->UID);\r
        break;\r
\r
      case 0x0604:\r
        CatPrint (Str, L"Floppy(%x)", Acpi->UID);\r
        break;\r
\r
      case 0x0301:\r
        CatPrint (Str, L"Keyboard(%x)", Acpi->UID);\r
        break;\r
\r
      case 0x0501:\r
        CatPrint (Str, L"Serial(%x)", Acpi->UID);\r
        break;\r
\r
      case 0x0401:\r
        CatPrint (Str, L"ParallelPort(%x)", Acpi->UID);\r
        break;\r
\r
      default:\r
        break;\r
      }\r
\r
      return ;\r
    }\r
\r
    CatPrint (Str, L"Acpi(PNP%04x,%x)", EISA_ID_TO_NUM (Acpi->HID), Acpi->UID);\r
  } else {\r
    CatPrint (Str, L"Acpi(%08x,%x)", Acpi->HID, Acpi->UID);\r
  }\r
}\r
\r
#define NextStrA(a) ((UINT8 *) (((UINT8 *) (a)) + AsciiStrLen ((CHAR8 *) (a)) + 1))\r
\r
STATIC\r
VOID\r
DevPathToTextExtAcpi (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  ACPI_EXTENDED_HID_DEVICE_PATH_WITH_STR  *AcpiExt;\r
  UINT8                                   *NextString;\r
\r
  AcpiExt = DevPath;\r
\r
  if (AllowShortcuts) {\r
    NextString = NextStrA (AcpiExt->HidUidCidStr);\r
    if ((*(AcpiExt->HidUidCidStr) == '\0') &&\r
        (*(NextStrA (NextString)) == '\0') &&\r
        (AcpiExt->UID == 0)\r
        ) {\r
      if ((AcpiExt->HID & PNP_EISA_ID_MASK) == PNP_EISA_ID_CONST) {\r
        CatPrint (\r
          Str,\r
          L"AcpiExp(PNP%04x,%x,%a)",\r
          EISA_ID_TO_NUM (AcpiExt->HID),\r
          AcpiExt->CID,\r
          NextStrA (AcpiExt->HidUidCidStr)\r
          );\r
      } else {\r
        CatPrint (\r
          Str,\r
          L"AcpiExp(%08x,%x,%a)",\r
          AcpiExt->HID,\r
          AcpiExt->CID,\r
          NextStrA (AcpiExt->HidUidCidStr)\r
          );\r
      }\r
    }\r
    return ;\r
  }\r
\r
  NextString = NextStrA (AcpiExt->HidUidCidStr);\r
  NextString = NextStrA (NextString);\r
  if ((AcpiExt->HID & PNP_EISA_ID_MASK) == PNP_EISA_ID_CONST) {\r
    CatPrint (\r
      Str,\r
      L"AcpiEx(PNP%04x,%x,%x,%a,%a,%a)",\r
      EISA_ID_TO_NUM (AcpiExt->HID),\r
      AcpiExt->CID,\r
      AcpiExt->UID,\r
      AcpiExt->HidUidCidStr,\r
      NextString,\r
      NextStrA (AcpiExt->HidUidCidStr)\r
      );\r
  } else {\r
    CatPrint (\r
      Str,\r
      L"AcpiEx(%08x,%x,%x,%a,%a,%a)",\r
      AcpiExt->HID,\r
      AcpiExt->CID,\r
      AcpiExt->UID,\r
      AcpiExt->HidUidCidStr,\r
      NextString,\r
      NextStrA (AcpiExt->HidUidCidStr)\r
      );\r
  }\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextAtapi (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  ATAPI_DEVICE_PATH *Atapi;\r
\r
  Atapi = DevPath;\r
\r
  if (DisplayOnly) {\r
    CatPrint (Str, L"Ata(%x)", Atapi->Lun);\r
  } else {\r
    CatPrint (\r
      Str,\r
      L"Ata(%s,%s,%x)",\r
      Atapi->PrimarySecondary ? L"Secondary" : L"Primary",\r
      Atapi->SlaveMaster ? L"Slave" : L"Master",\r
      Atapi->Lun\r
      );\r
  }\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextScsi (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  SCSI_DEVICE_PATH  *Scsi;\r
\r
  Scsi = DevPath;\r
  CatPrint (Str, L"Scsi(%x,%x)", Scsi->Pun, Scsi->Lun);\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextFibre (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  FIBRECHANNEL_DEVICE_PATH  *Fibre;\r
\r
  Fibre = DevPath;\r
  CatPrint (Str, L"Fibre(%lx,%lx)", Fibre->WWN, Fibre->Lun);\r
}\r
\r
STATIC\r
VOID\r
DevPathToText1394 (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  F1394_DEVICE_PATH *F1394;\r
\r
  F1394 = DevPath;\r
  CatPrint (Str, L"I1394(%lx)", F1394->Guid);\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextUsb (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  USB_DEVICE_PATH *Usb;\r
\r
  Usb = DevPath;\r
  CatPrint (Str, L"USB(%x,%x)", Usb->ParentPortNumber, Usb->InterfaceNumber);\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextUsbWWID (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  USB_WWID_DEVICE_PATH  *UsbWWId;\r
\r
  UsbWWId = DevPath;\r
  CatPrint (\r
    Str,\r
    L"UsbWwid(%x,%x,%x,\"WWID\")",\r
    UsbWWId->VendorId,\r
    UsbWWId->ProductId,\r
    UsbWWId->InterfaceNumber\r
    );\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextLogicalUnit (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  DEVICE_LOGICAL_UNIT_DEVICE_PATH *LogicalUnit;\r
\r
  LogicalUnit = DevPath;\r
  CatPrint (Str, L"Unit(%x)", LogicalUnit->Lun);\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextUsbClass (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  USB_CLASS_DEVICE_PATH *UsbClass;\r
\r
  UsbClass = DevPath;\r
\r
  if (AllowShortcuts == TRUE) {\r
    switch (UsbClass->DeviceClass) {\r
    case 1:\r
      CatPrint (\r
        Str,\r
        L"UsbAudio(%x,%x,%x,%x)",\r
        UsbClass->VendorId,\r
        UsbClass->ProductId,\r
        UsbClass->DeviceSubClass,\r
        UsbClass->DeviceProtocol\r
        );\r
      break;\r
\r
    case 2:\r
      CatPrint (\r
        Str,\r
        L"UsbCDCControl(%x,%x,%x,%x)",\r
        UsbClass->VendorId,\r
        UsbClass->ProductId,\r
        UsbClass->DeviceSubClass,\r
        UsbClass->DeviceProtocol\r
        );\r
      break;\r
\r
    case 3:\r
      CatPrint (\r
        Str,\r
        L"UsbHID(%x,%x,%x,%x)",\r
        UsbClass->VendorId,\r
        UsbClass->ProductId,\r
        UsbClass->DeviceSubClass,\r
        UsbClass->DeviceProtocol\r
        );\r
      break;\r
\r
    case 6:\r
      CatPrint (\r
        Str,\r
        L"UsbImage(%x,%x,%x,%x)",\r
        UsbClass->VendorId,\r
        UsbClass->ProductId,\r
        UsbClass->DeviceSubClass,\r
        UsbClass->DeviceProtocol\r
        );\r
      break;\r
\r
    case 7:\r
      CatPrint (\r
        Str,\r
        L"UsbPrinter(%x,%x,%x,%x)",\r
        UsbClass->VendorId,\r
        UsbClass->ProductId,\r
        UsbClass->DeviceSubClass,\r
        UsbClass->DeviceProtocol\r
        );\r
      break;\r
\r
    case 8:\r
      CatPrint (\r
        Str,\r
        L"UsbMassStorage(%x,%x,%x,%x)",\r
        UsbClass->VendorId,\r
        UsbClass->ProductId,\r
        UsbClass->DeviceSubClass,\r
        UsbClass->DeviceProtocol\r
        );\r
      break;\r
\r
    case 9:\r
      CatPrint (\r
        Str,\r
        L"UsbHub(%x,%x,%x,%x)",\r
        UsbClass->VendorId,\r
        UsbClass->ProductId,\r
        UsbClass->DeviceSubClass,\r
        UsbClass->DeviceProtocol\r
        );\r
      break;\r
\r
    case 10:\r
      CatPrint (\r
        Str,\r
        L"UsbCDCData(%x,%x,%x,%x)",\r
        UsbClass->VendorId,\r
        UsbClass->ProductId,\r
        UsbClass->DeviceSubClass,\r
        UsbClass->DeviceProtocol\r
        );\r
      break;\r
\r
    case 11:\r
      CatPrint (\r
        Str,\r
        L"UsbSmartCard(%x,%x,%x,%x)",\r
        UsbClass->VendorId,\r
        UsbClass->ProductId,\r
        UsbClass->DeviceSubClass,\r
        UsbClass->DeviceProtocol\r
        );\r
      break;\r
\r
    case 14:\r
      CatPrint (\r
        Str,\r
        L"UsbVideo(%x,%x,%x,%x)",\r
        UsbClass->VendorId,\r
        UsbClass->ProductId,\r
        UsbClass->DeviceSubClass,\r
        UsbClass->DeviceProtocol\r
        );\r
      break;\r
\r
    case 220:\r
      CatPrint (\r
        Str,\r
        L"UsbDiagnostic(%x,%x,%x,%x)",\r
        UsbClass->VendorId,\r
        UsbClass->ProductId,\r
        UsbClass->DeviceSubClass,\r
        UsbClass->DeviceProtocol\r
        );\r
      break;\r
\r
    case 224:\r
      CatPrint (\r
        Str,\r
        L"UsbWireless(%x,%x,%x,%x)",\r
        UsbClass->VendorId,\r
        UsbClass->ProductId,\r
        UsbClass->DeviceSubClass,\r
        UsbClass->DeviceProtocol\r
        );\r
      break;\r
\r
    case 254:\r
      if (UsbClass->DeviceSubClass == 1) {\r
        CatPrint (\r
          Str,\r
          L"UsbDeviceFirmwareUpdate(%x,%x,%x)",\r
          UsbClass->VendorId,\r
          UsbClass->ProductId,\r
          UsbClass->DeviceProtocol\r
          );\r
      } else if (UsbClass->DeviceSubClass == 2) {\r
        CatPrint (\r
          Str,\r
          L"UsbIrdaBridge(%x,%x,%x)",\r
          UsbClass->VendorId,\r
          UsbClass->ProductId,\r
          UsbClass->DeviceProtocol\r
          );\r
      } else if (UsbClass->DeviceSubClass == 3) {\r
        CatPrint (\r
          Str,\r
          L"UsbTestAndMeasurement(%x,%x,%x)",\r
          UsbClass->VendorId,\r
          UsbClass->ProductId,\r
          UsbClass->DeviceProtocol\r
          );\r
      }\r
      break;\r
\r
    default:\r
      break;\r
    }\r
\r
    return ;\r
  }\r
\r
  CatPrint (\r
    Str,\r
    L"UsbClass(%x,%x,%x,%x,%x)",\r
    UsbClass->VendorId,\r
    UsbClass->ProductId,\r
    UsbClass->DeviceClass,\r
    UsbClass->DeviceSubClass,\r
    UsbClass->DeviceProtocol\r
    );\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextI2O (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  I2O_DEVICE_PATH *I2O;\r
\r
  I2O = DevPath;\r
  CatPrint (Str, L"I2O(%x)", I2O->Tid);\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextMacAddr (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  MAC_ADDR_DEVICE_PATH  *MAC;\r
  UINTN                 HwAddressSize;\r
  UINTN                 Index;\r
\r
  MAC           = DevPath;\r
\r
  HwAddressSize = sizeof (EFI_MAC_ADDRESS);\r
  if (MAC->IfType == 0x01 || MAC->IfType == 0x00) {\r
    HwAddressSize = 6;\r
  }\r
\r
  CatPrint (Str, L"MAC(");\r
\r
  for (Index = 0; Index < HwAddressSize; Index++) {\r
    CatPrint (Str, L"%02x", MAC->MacAddress.Addr[Index]);\r
  }\r
\r
  CatPrint (Str, L",%x)", MAC->IfType);\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextIPv4 (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  IPv4_DEVICE_PATH  *IP;\r
\r
  IP = DevPath;\r
  if (DisplayOnly == TRUE) {\r
    CatPrint (\r
      Str,\r
      L"IPv4(%d.%d.%d.%d)",\r
      IP->RemoteIpAddress.Addr[0],\r
      IP->RemoteIpAddress.Addr[1],\r
      IP->RemoteIpAddress.Addr[2],\r
      IP->RemoteIpAddress.Addr[3]\r
      );\r
    return ;\r
  }\r
\r
  CatPrint (\r
    Str,\r
    L"IPv4(%d.%d.%d.%d,%s,%s,%d.%d.%d.%d)",\r
    IP->RemoteIpAddress.Addr[0],\r
    IP->RemoteIpAddress.Addr[1],\r
    IP->RemoteIpAddress.Addr[2],\r
    IP->RemoteIpAddress.Addr[3],\r
    IP->Protocol ? L"TCP" : L"UDP",\r
    (IP->StaticIpAddress == TRUE) ? L"Static" : L"DHCP",\r
    IP->LocalIpAddress.Addr[0],\r
    IP->LocalIpAddress.Addr[1],\r
    IP->LocalIpAddress.Addr[2],\r
    IP->LocalIpAddress.Addr[3]\r
    );\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextIPv6 (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  IPv6_DEVICE_PATH  *IP;\r
\r
  IP = DevPath;\r
  if (DisplayOnly == TRUE) {\r
    CatPrint (\r
      Str,\r
      L"IPv6(%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x)",\r
      IP->RemoteIpAddress.Addr[0],\r
      IP->RemoteIpAddress.Addr[1],\r
      IP->RemoteIpAddress.Addr[2],\r
      IP->RemoteIpAddress.Addr[3],\r
      IP->RemoteIpAddress.Addr[4],\r
      IP->RemoteIpAddress.Addr[5],\r
      IP->RemoteIpAddress.Addr[6],\r
      IP->RemoteIpAddress.Addr[7],\r
      IP->RemoteIpAddress.Addr[8],\r
      IP->RemoteIpAddress.Addr[9],\r
      IP->RemoteIpAddress.Addr[10],\r
      IP->RemoteIpAddress.Addr[11],\r
      IP->RemoteIpAddress.Addr[12],\r
      IP->RemoteIpAddress.Addr[13],\r
      IP->RemoteIpAddress.Addr[14],\r
      IP->RemoteIpAddress.Addr[15]\r
      );\r
    return ;\r
  }\r
\r
  CatPrint (\r
    Str,\r
    L"IPv6(%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x,%s,%s,%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x)",\r
    IP->RemoteIpAddress.Addr[0],\r
    IP->RemoteIpAddress.Addr[1],\r
    IP->RemoteIpAddress.Addr[2],\r
    IP->RemoteIpAddress.Addr[3],\r
    IP->RemoteIpAddress.Addr[4],\r
    IP->RemoteIpAddress.Addr[5],\r
    IP->RemoteIpAddress.Addr[6],\r
    IP->RemoteIpAddress.Addr[7],\r
    IP->RemoteIpAddress.Addr[8],\r
    IP->RemoteIpAddress.Addr[9],\r
    IP->RemoteIpAddress.Addr[10],\r
    IP->RemoteIpAddress.Addr[11],\r
    IP->RemoteIpAddress.Addr[12],\r
    IP->RemoteIpAddress.Addr[13],\r
    IP->RemoteIpAddress.Addr[14],\r
    IP->RemoteIpAddress.Addr[15],\r
    IP->Protocol ? L"TCP" : L"UDP",\r
    (IP->StaticIpAddress == TRUE) ? L"Static" : L"DHCP",\r
    IP->LocalIpAddress.Addr[0],\r
    IP->LocalIpAddress.Addr[1],\r
    IP->LocalIpAddress.Addr[2],\r
    IP->LocalIpAddress.Addr[3],\r
    IP->LocalIpAddress.Addr[4],\r
    IP->LocalIpAddress.Addr[5],\r
    IP->LocalIpAddress.Addr[6],\r
    IP->LocalIpAddress.Addr[7],\r
    IP->LocalIpAddress.Addr[8],\r
    IP->LocalIpAddress.Addr[9],\r
    IP->LocalIpAddress.Addr[10],\r
    IP->LocalIpAddress.Addr[11],\r
    IP->LocalIpAddress.Addr[12],\r
    IP->LocalIpAddress.Addr[13],\r
    IP->LocalIpAddress.Addr[14],\r
    IP->LocalIpAddress.Addr[15]\r
    );\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextInfiniBand (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  INFINIBAND_DEVICE_PATH  *InfiniBand;\r
\r
  InfiniBand = DevPath;\r
  CatPrint (\r
    Str,\r
    L"Infiniband(%x,%g,%lx,%lx,%lx)",\r
    InfiniBand->ResourceFlags,\r
    InfiniBand->PortGid,\r
    InfiniBand->ServiceId,\r
    InfiniBand->TargetPortId,\r
    InfiniBand->DeviceId\r
    );\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextUart (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  UART_DEVICE_PATH  *Uart;\r
  CHAR8             Parity;\r
\r
  Uart = DevPath;\r
  switch (Uart->Parity) {\r
  case 0:\r
    Parity = 'D';\r
    break;\r
\r
  case 1:\r
    Parity = 'N';\r
    break;\r
\r
  case 2:\r
    Parity = 'E';\r
    break;\r
\r
  case 3:\r
    Parity = 'O';\r
    break;\r
\r
  case 4:\r
    Parity = 'M';\r
    break;\r
\r
  case 5:\r
    Parity = 'S';\r
    break;\r
\r
  default:\r
    Parity = 'x';\r
    break;\r
  }\r
\r
  if (Uart->BaudRate == 0) {\r
    CatPrint (Str, L"Uart(DEFAULT,");\r
  } else {\r
    CatPrint (Str, L"Uart(%ld,", Uart->BaudRate);\r
  }\r
\r
  if (Uart->DataBits == 0) {\r
    CatPrint (Str, L"DEFAULT,");\r
  } else {\r
    CatPrint (Str, L"%d,", Uart->DataBits);\r
  }\r
\r
  CatPrint (Str, L"%c,", Parity);\r
\r
  switch (Uart->StopBits) {\r
  case 0:\r
    CatPrint (Str, L"D)");\r
    break;\r
\r
  case 1:\r
    CatPrint (Str, L"1)");\r
    break;\r
\r
  case 2:\r
    CatPrint (Str, L"1.5)");\r
    break;\r
\r
  case 3:\r
    CatPrint (Str, L"2)");\r
    break;\r
\r
  default:\r
    CatPrint (Str, L"x)");\r
    break;\r
  }\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextiSCSI (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  ISCSI_DEVICE_PATH_WITH_NAME *iSCSI;\r
  UINT16                      Options;\r
\r
  iSCSI = DevPath;\r
  CatPrint (\r
    Str,\r
    L"iSCSI(%s,%x,%lx,",\r
    iSCSI->iSCSITargetName,\r
    iSCSI->TargetPortalGroupTag,\r
    iSCSI->Lun\r
    );\r
\r
  Options = iSCSI->LoginOption;\r
  CatPrint (Str, L"%s,", ((Options >> 1) & 0x0001) ? L"CRC32C" : L"None");\r
  CatPrint (Str, L"%s,", ((Options >> 3) & 0x0001) ? L"CRC32C" : L"None");\r
  if ((Options >> 11) & 0x0001) {\r
    CatPrint (Str, L"%s,", L"None");\r
  } else if ((Options >> 12) & 0x0001) {\r
    CatPrint (Str, L"%s,", L"CHAP_UNI");\r
  } else {\r
    CatPrint (Str, L"%s,", L"CHAP_BI");\r
\r
  }\r
\r
  CatPrint (Str, L"%s)", (iSCSI->NetworkProtocol == 0) ? L"TCP" : L"reserved");\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextHardDrive (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  HARDDRIVE_DEVICE_PATH *Hd;\r
\r
  Hd = DevPath;\r
  switch (Hd->SignatureType) {\r
  case 0:\r
    CatPrint (\r
      Str,\r
      L"HD(%d,%s,0,",\r
      Hd->PartitionNumber,\r
      L"None"\r
      );\r
    break;\r
\r
  case SIGNATURE_TYPE_MBR:\r
    CatPrint (\r
      Str,\r
      L"HD(%d,%s,%08x,",\r
      Hd->PartitionNumber,\r
      L"MBR",\r
      *((UINT32 *) (&(Hd->Signature[0])))\r
      );\r
    break;\r
\r
  case SIGNATURE_TYPE_GUID:\r
    CatPrint (\r
      Str,\r
      L"HD(%d,%s,%g,",\r
      Hd->PartitionNumber,\r
      L"GUID",\r
      (EFI_GUID *) &(Hd->Signature[0])\r
      );\r
    break;\r
\r
  default:\r
    break;\r
  }\r
\r
  CatPrint (Str, L"%lx,%lx)", Hd->PartitionStart, Hd->PartitionSize);\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextCDROM (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  CDROM_DEVICE_PATH *Cd;\r
\r
  Cd = DevPath;\r
  if (DisplayOnly == TRUE) {\r
    CatPrint (Str, L"CDROM(%x)", Cd->BootEntry);\r
    return ;\r
  }\r
\r
  CatPrint (Str, L"CDROM(%x,%lx,%lx)", Cd->BootEntry, Cd->PartitionStart, Cd->PartitionSize);\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextFilePath (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  FILEPATH_DEVICE_PATH  *Fp;\r
\r
  Fp = DevPath;\r
  CatPrint (Str, L"%s", Fp->PathName);\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextMediaProtocol (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  MEDIA_PROTOCOL_DEVICE_PATH  *MediaProt;\r
\r
  MediaProt = DevPath;\r
  CatPrint (Str, L"Media(%g)", &MediaProt->Protocol);\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextBBS (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  BBS_BBS_DEVICE_PATH *Bbs;\r
  CHAR16              *Type;\r
\r
  Bbs = DevPath;\r
  switch (Bbs->DeviceType) {\r
  case BBS_TYPE_FLOPPY:\r
    Type = L"Floppy";\r
    break;\r
\r
  case BBS_TYPE_HARDDRIVE:\r
    Type = L"HD";\r
    break;\r
\r
  case BBS_TYPE_CDROM:\r
    Type = L"CDROM";\r
    break;\r
\r
  case BBS_TYPE_PCMCIA:\r
    Type = L"PCMCIA";\r
    break;\r
\r
  case BBS_TYPE_USB:\r
    Type = L"USB";\r
    break;\r
\r
  case BBS_TYPE_EMBEDDED_NETWORK:\r
    Type = L"Network";\r
    break;\r
\r
  default:\r
    Type = L"?";\r
    break;\r
  }\r
\r
  CatPrint (Str, L"BBS(%s,%a", Type, Bbs->String);\r
\r
  if (DisplayOnly == TRUE) {\r
    CatPrint (Str, L")");\r
    return ;\r
  }\r
\r
  CatPrint (Str, L",%x)", Bbs->StatusFlag);\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextEndInstance (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  CatPrint (Str, L",");\r
}\r
\r
STATIC\r
VOID\r
DevPathToTextNodeUnknown (\r
  IN OUT POOL_PRINT  *Str,\r
  IN VOID            *DevPath,\r
  IN BOOLEAN         DisplayOnly,\r
  IN BOOLEAN         AllowShortcuts\r
  )\r
{\r
  CatPrint (Str, L"?");\r
}\r
\r
GLOBAL_REMOVE_IF_UNREFERENCED const DEVICE_PATH_TO_TEXT_TABLE DevPathToTextTable[] = {\r
  {HARDWARE_DEVICE_PATH, HW_PCI_DP, DevPathToTextPci},\r
  {HARDWARE_DEVICE_PATH, HW_PCCARD_DP, DevPathToTextPccard},\r
  {HARDWARE_DEVICE_PATH, HW_MEMMAP_DP, DevPathToTextMemMap},\r
  {HARDWARE_DEVICE_PATH, HW_VENDOR_DP, DevPathToTextVendor},\r
  {HARDWARE_DEVICE_PATH, HW_CONTROLLER_DP, DevPathToTextController},\r
  {ACPI_DEVICE_PATH, ACPI_DP, DevPathToTextAcpi},\r
  {ACPI_DEVICE_PATH, ACPI_EXTENDED_DP, DevPathToTextExtAcpi},\r
  {MESSAGING_DEVICE_PATH, MSG_ATAPI_DP, DevPathToTextAtapi},\r
  {MESSAGING_DEVICE_PATH, MSG_SCSI_DP, DevPathToTextScsi},\r
  {MESSAGING_DEVICE_PATH, MSG_FIBRECHANNEL_DP, DevPathToTextFibre},\r
  {MESSAGING_DEVICE_PATH, MSG_1394_DP, DevPathToText1394},\r
  {MESSAGING_DEVICE_PATH, MSG_USB_DP, DevPathToTextUsb},\r
  {MESSAGING_DEVICE_PATH, MSG_USB_WWID_DP, DevPathToTextUsbWWID},\r
  {MESSAGING_DEVICE_PATH, MSG_DEVICE_LOGICAL_UNIT_DP, DevPathToTextLogicalUnit},\r
  {MESSAGING_DEVICE_PATH, MSG_USB_CLASS_DP, DevPathToTextUsbClass},\r
  {MESSAGING_DEVICE_PATH, MSG_I2O_DP, DevPathToTextI2O},\r
  {MESSAGING_DEVICE_PATH, MSG_MAC_ADDR_DP, DevPathToTextMacAddr},\r
  {MESSAGING_DEVICE_PATH, MSG_IPv4_DP, DevPathToTextIPv4},\r
  {MESSAGING_DEVICE_PATH, MSG_IPv6_DP, DevPathToTextIPv6},\r
  {MESSAGING_DEVICE_PATH, MSG_INFINIBAND_DP, DevPathToTextInfiniBand},\r
  {MESSAGING_DEVICE_PATH, MSG_UART_DP, DevPathToTextUart},\r
  {MESSAGING_DEVICE_PATH, MSG_VENDOR_DP, DevPathToTextVendor},\r
  {MESSAGING_DEVICE_PATH, MSG_ISCSI_DP, DevPathToTextiSCSI},\r
  {MEDIA_DEVICE_PATH, MEDIA_HARDDRIVE_DP, DevPathToTextHardDrive},\r
  {MEDIA_DEVICE_PATH, MEDIA_CDROM_DP, DevPathToTextCDROM},\r
  {MEDIA_DEVICE_PATH, MEDIA_VENDOR_DP, DevPathToTextVendor},\r
  {MEDIA_DEVICE_PATH, MEDIA_FILEPATH_DP, DevPathToTextFilePath},\r
  {MEDIA_DEVICE_PATH, MEDIA_PROTOCOL_DP, DevPathToTextMediaProtocol},\r
  {MEDIA_DEVICE_PATH, MEDIA_FILEPATH_DP, DevPathToTextFilePath},\r
  {BBS_DEVICE_PATH, BBS_BBS_DP, DevPathToTextBBS},\r
  {END_DEVICE_PATH_TYPE, END_INSTANCE_DEVICE_PATH_SUBTYPE, DevPathToTextEndInstance},\r
  {0, 0, NULL}\r
};\r
\r
CHAR16 *\r
ConvertDeviceNodeToText (\r
  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DeviceNode,\r
  IN BOOLEAN                         DisplayOnly,\r
  IN BOOLEAN                         AllowShortcuts\r
  )\r
/*++\r
\r
  Routine Description:\r
    Convert a device node to its text representation.\r
\r
  Arguments:\r
    DeviceNode       -   Points to the device node to be converted.\r
    DisplayOnly      -   If DisplayOnly is TRUE, then the shorter text representation\r
                         of the display node is used, where applicable. If DisplayOnly\r
                         is FALSE, then the longer text representation of the display node\r
                         is used.\r
    AllowShortcuts   -   If AllowShortcuts is TRUE, then the shortcut forms of text\r
                         representation for a device node can be used, where applicable.\r
\r
  Returns:\r
    A pointer        -   a pointer to the allocated text representation of the device node.\r
    NULL             -   if DeviceNode is NULL or there was insufficient memory.\r
\r
--*/\r
{\r
  POOL_PRINT  Str;\r
  UINTN       Index;\r
  UINTN       NewSize;\r
  VOID        (*DumpNode)(POOL_PRINT *, VOID *, BOOLEAN, BOOLEAN);\r
\r
  if (DeviceNode == NULL) {\r
    return NULL;\r
  }\r
\r
  ZeroMem (&Str, sizeof (Str));\r
\r
  //\r
  // Process the device path node\r
  //\r
  DumpNode = NULL;\r
  for (Index = 0; DevPathToTextTable[Index].Function != NULL; Index++) {\r
    if (DevicePathType (DeviceNode) == DevPathToTextTable[Index].Type &&\r
        DevicePathSubType (DeviceNode) == DevPathToTextTable[Index].SubType\r
        ) {\r
      DumpNode = DevPathToTextTable[Index].Function;\r
      break;\r
    }\r
  }\r
  //\r
  // If not found, use a generic function\r
  //\r
  if (DumpNode == NULL) {\r
    DumpNode = DevPathToTextNodeUnknown;\r
  }\r
\r
  //\r
  // Print this node\r
  //\r
  DumpNode (&Str, (VOID *) DeviceNode, DisplayOnly, AllowShortcuts);\r
\r
  //\r
  // Shrink pool used for string allocation\r
  //\r
  NewSize = (Str.Len + 1) * sizeof (CHAR16);\r
  Str.Str = ReallocatePool (Str.Str, NewSize, NewSize);\r
  ASSERT (Str.Str != NULL);\r
  Str.Str[Str.Len] = 0;\r
  return Str.Str;\r
}\r
\r
CHAR16 *\r
ConvertDevicePathToText (\r
  IN CONST EFI_DEVICE_PATH_PROTOCOL   *DevicePath,\r
  IN BOOLEAN                          DisplayOnly,\r
  IN BOOLEAN                          AllowShortcuts\r
  )\r
/*++\r
\r
  Routine Description:\r
    Convert a device path to its text representation.\r
\r
  Arguments:\r
    DeviceNode       -   Points to the device path to be converted.\r
    DisplayOnly      -   If DisplayOnly is TRUE, then the shorter text representation\r
                         of the display node is used, where applicable. If DisplayOnly\r
                         is FALSE, then the longer text representation of the display node\r
                         is used.\r
    AllowShortcuts   -   If AllowShortcuts is TRUE, then the shortcut forms of text\r
                         representation for a device node can be used, where applicable.\r
\r
  Returns:\r
    A pointer        -   a pointer to the allocated text representation of the device path.\r
    NULL             -   if DeviceNode is NULL or there was insufficient memory.\r
\r
--*/\r
{\r
  POOL_PRINT                Str;\r
  EFI_DEVICE_PATH_PROTOCOL  *DevPathNode;\r
  EFI_DEVICE_PATH_PROTOCOL  *UnpackDevPath;\r
  UINTN                     Index;\r
  UINTN                     NewSize;\r
  VOID                      (*DumpNode) (POOL_PRINT *, VOID *, BOOLEAN, BOOLEAN);\r
\r
  if (DevicePath == NULL) {\r
    return NULL;\r
  }\r
\r
  ZeroMem (&Str, sizeof (Str));\r
\r
  //\r
  // Unpacked the device path\r
  //\r
  UnpackDevPath = UnpackDevicePath ((EFI_DEVICE_PATH_PROTOCOL *) DevicePath);\r
  ASSERT (UnpackDevPath != NULL);\r
\r
  //\r
  // Process each device path node\r
  //\r
  DevPathNode = UnpackDevPath;\r
  while (!IsDevicePathEnd (DevPathNode)) {\r
    //\r
    // Find the handler to dump this device path node\r
    //\r
    DumpNode = NULL;\r
    for (Index = 0; DevPathToTextTable[Index].Function; Index += 1) {\r
\r
      if (DevicePathType (DevPathNode) == DevPathToTextTable[Index].Type &&\r
          DevicePathSubType (DevPathNode) == DevPathToTextTable[Index].SubType\r
          ) {\r
        DumpNode = DevPathToTextTable[Index].Function;\r
        break;\r
      }\r
    }\r
    //\r
    // If not found, use a generic function\r
    //\r
    if (!DumpNode) {\r
      DumpNode = DevPathToTextNodeUnknown;\r
    }\r
    //\r
    //  Put a path seperator in if needed\r
    //\r
    if (Str.Len && DumpNode != DevPathToTextEndInstance) {\r
      if (*(Str.Str + Str.Len / sizeof (CHAR16) - 1) != L',') {	\r
        CatPrint (&Str, L"/");\r
      }	  \r
    }\r
    //\r
    // Print this node of the device path\r
    //\r
    DumpNode (&Str, DevPathNode, DisplayOnly, AllowShortcuts);\r
\r
    //\r
    // Next device path node\r
    //\r
    DevPathNode = NextDevicePathNode (DevPathNode);\r
  }\r
  //\r
  // Shrink pool used for string allocation\r
  //\r
  FreePool (UnpackDevPath);\r
\r
  NewSize = (Str.Len + 1) * sizeof (CHAR16);\r
  Str.Str = ReallocatePool (Str.Str, NewSize, NewSize);\r
  ASSERT (Str.Str != NULL);\r
  Str.Str[Str.Len] = 0;\r
  return Str.Str;\r
}\r