9.3.3 Dynamically Releasing the PCIe Endpoint From a Logical Domain
9.3.3 Dynamically Releasing the PCIe Endpoint From a Logical Domain
The operation of dynamically releasing the PCIe endpoint from a logical domain must be performed from the control domain.
Before removing the PCIe endpoint, confirm that it is not being used by the logical domain. For details, see the manual for the software being used.
|
Figure 9-3 Releasing the Assignment of a PCIe Endpoint
|
|
Table 9-4 lists the procedure for dynamically releasing a PCIe endpoint.
| Step | Operation Description | Execution Location | Command Used |
|---|---|---|---|
| 1 | Checking the assignment status of PCIe endpoints | Control domain | primary# ldm list-io |
| 2 | Releasing the PCIe endpoint assigned to a logical domain | Control domain | primary# ldm remove-io <device> <domain-name> |
| 3 | Returning the PCIe endpoint to the control domain or root domain | Control domain | primary# ldm add-io <device> <domain-name> |
| 4 | Confirming that the PCIe endpoint has been returned to the control domain or root domain | Control domain | primary# ldm list-io |
The following example executes the commands for releasing the PCIe endpoint from logical domain guest to allow the PCIe card to be replaced.
- Check the assignment status of PCIe endpoints to logical domains.
In this example, PCI slot #5 of the SPARC M12-2S of BB-ID#01 is assigned to the logical domain guest.
| primary# ldm list-io NAME TYPE BUS DOMAIN STATUS ---- ---- --- ------ ------ (Omitted) /BB1/PCI0 PCIE PCIE9 primary EMP /BB1/PCI1 PCIE PCIE15 primary EMP /BB1/PCI2 PCIE PCIE8 primary EMP /BB1/PCI3 PCIE PCIE14 primary EMP /BB1/PCI4 PCIE PCIE13 primary EMP /BB1/PCI5 PCIE PCIE11 guest OCC /BB1/PCI6 PCIE PCIE12 primary EMP (Omitted) |
- Release the PCIe endpoint from the logical domain.
Release PCI slot #5 of the SPARC M12-2S of BB-ID#01 from the logical domain guest.
| primary# ldm remove-io /BB1/PCI5 guest |
- Return the released PCIe endpoint to the control domain or root domain.
To remove a PCIe card or release a root complex by the PCI Hot Plug function, you need to return the PCIe endpoint to the control domain or the root domain beforehand.
Return PCI slot #5 of the SPARC M12-2S of BB-ID#01 to the control domain.
| primary# ldm add-io /BB1/PCI5 primary |
- Confirm that the target PCIe endpoint has been returned to the control domain or root domain.
Confirm that PCI slot #5 of the SPARC M12-2S of BB-ID#01 has been returned to the control domain.
| primary# ldm list-io NAME TYPE BUS DOMAIN STATUS ---- ---- --- ------ ------ (Omitted) /BB1/PCI0 PCIE PCIE9 primary EMP /BB1/PCI1 PCIE PCIE15 primary EMP /BB1/PCI2 PCIE PCIE8 primary EMP /BB1/PCI3 PCIE PCIE14 primary EMP /BB1/PCI4 PCIE PCIE13 primary EMP /BB1/PCI5 PCIE PCIE11 primary OCC /BB1/PCI6 PCIE PCIE12 primary EMP (Omitted) |
< Previous Page | Next Page >