The command supports the new Simics PCIe library and the legacy Simics PCIe library. The command also tries to traverse hybrid PCIe systems where a root port is implemented with the new Simics PCIe library but endpoints and switches underneath could be based on the legacy Simics PCIe library.
The new Simics PCIe library utilizes the classes pcie-downstream-port and pcie-downstream-port-legacy to build up the PCIe topology. The legacy Simics PCIe library utilizes the classes pcie-bus and pci-bus to build up the PCIe topology. The command finds all instantiated objects of these classes, and tries to construct the hierarchy based on how these class instances are connected to one another.
The -include-bus flag adds an addition column in the table, listing which bus object the device and function are underneath.
The -skip-info flag can be used to hide the info column in the table that contains the class description of the device.
The -indicate-legacy-pcie flag can be used to show if the PCIe device is modeled based on the new or legacy Simics PCIe interfaces.
The namespace argument can be used to only traverse PCIe hierarchies where the host bridge is part of the namespace.