====== Bus location setting ======

===== Name =====

    busloc

===== Details =====

^ Type                | [[:cfgtype:uint32|32-bit unsigned integer]]   |
^ DHCP option number  | not applicable                                |
^ ISC dhcpd syntax    | not applicable                                |

===== Examples =====

=== Display the bus location of interface "net0" ===

    iPXE> show net0/busloc
    net0/busloc:uint32 = 0x18

=== Display the bus location of interface "net0" as a PCI bus:dev.fn address ===

    iPXE> show net0/busloc:busdevfn
    net0/busloc:busdevfn = 00:03.0

=== Retrieve the PCI vendor and device IDs of interface "net0" ===

    echo net0 has IDs ${pci/${net0/busloc}.0.2}:${pci/${net0/busloc}.2.2}

===== Description =====

Describes the location on the hardware bus to which the network device is attached.  For example, the location of a PCI device will be its bus:dev.fn address.

===== See also =====

  * ''[[:cfg:bustype]]''
  * ''[[:cfg:busid]]''
  * ''[[:cfg:chip]]''
  * [[:cfg|List of all iPXE settings]]

===== Notes =====

The bus location is formatted as an opaque 32-bit unsigned integer.  If you know the bus type, then you can choose to interpret the bus location in a type-specific way.  For example:

    iseq ${net0/bustype} PCI && echo ${net0/busloc:busdevfn} || echo ${net0/busloc}

For PCI devices, the bus location can be used to extract information from PCI configuration space.  For example, to dump the first 64 bytes of PCI configuration space for interface "net0":

    show pci/${net0/busloc}.0.64