dh

Syntax

dh[-lxxx][handle|-p prot_id][-d][-b][-v][-sfo]

Description

Displays the device handles in the UEFI environment.

Options

-lxxx

Displays device handles in a specific language. For a list of possible code options, see the UEFI specification.

handle

Displays the handle for a specific device.

-p prot_id

Displays protocol information associated to handles. If not specified, all protocols are displayed.

-d

Displays UEFI driver model-related information.

-b

Displays one screen at a time.

-v

Displays verbose information.

-sfo

Displays information in standard formatted output.

Usage

If a handle number is specified, the details of all the protocols that are associated with that device handle are displayed. Otherwise, the -p option can be used to list the device handles that contain a specific protocol. If neither -pprot_id nor handle is specified, all handles are displayed.

Examples

To display all handles one screen at a time:

Shell> dh -b
Handle dump 
  1: Image(DXE Core) 
  2: FwVol FwFileSys FwVolBlk DevPath(MemMap(11:1B50000- 
     1D4FFC8)) 
  3: Image(Ebc)
  4: DevPath(MemMap(11:1CA0000-1CB0000)) 
  5: Image(WinNtThunk) 
  6: WinNtThunk DevPath(..76F3-11D4-BCEA-0080C73C8881)) 
  7: Image(WinNtBusDriver) DriverBinding 
...

To display detailed information about handle 0x30:

Shell> dh 30 -v
Handle 30 (01AF5308) 
  IsaIo
    ROM Size......: 00000000
    ROM Location..: 00000000
    ISA Resource List :
      IO : 000003F8-000003FF Attr : 00000000
      INT : 00000004-00000000 Attr : 00000000

    dpath 
      PNP Device Path for PnP
      HID A0341D0, UID 0x0
      Hardware Device Path for PCI
      PNP Device Path for PnP
      HID 50141D0, UID 0
    AsStr: 'Acpi(PNP0A03,0)/Pci(1F|0)/Acpi(PNP0501,0)'

To display all handles associated with the diskio protocol:

Shell> dh -p diskio
Handle dump by protocol 'Diskio'
  15: DiskIo BlkIo DevPath(..i(3|1)/Ata(Secondary,Master))
  16: DiskIo BlkIo DevPath(..,1)/PCI(0|0)/Scsi(Pun0,Lun0))
  44: DiskIo BlkIo Fs DevPath(..ABD0-01C0-507B-9E5F8078F531)
      ESP
  45: DiskIo BlkIo Fs DevPath(..i(Pun0,Lun0)/HD(Part4,SigG0))
      ESP
  17: DiskIo BlkIo DevPath(..PCI(3|1)/Ata(Primary,Master))
      

To display all handles associated with the Image protocol and break when the screen is full:

Shell> dh -p Image -b
Handle dump by protocol 'image'
  1: Image(DXE Core)
  5: Image(WinNtThunk)
  7: Image(WinNtBusDriver) DriverBinding
  8: Image(Metronome)
  A: Image(IsaBus) DriverBinding
  B: Image(WinNtConsole) DriverBinding
...

Output details

The following table describes the possible output for this command.