p2p - 2021.2 English

Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393)

Document ID
UG1393
ft:locale
English (United States)
Release Date
2021-12-15
Version
2021.2 English
Important: This option cannot be used with embedded processor platforms.

The p2p command is used to enable/disable (PCIe Peer-to-Peer Support) feature and check current configuration.

Important: Only platforms supporting P2P feature, see Alveo Data Center Accelerator Card Platforms User Guide (UG1120), can run this command.

P2P configuration is persistent across warm reboot.

Note: Enabling or disabling P2P requires root privilege.

It has the following command line format:

xbutil p2p [-d card] --[enable | disable | validate]

The following table lists the available options.

Table 1. xbutil p2p Command Options
Option Description Required
-d <card> Specifies the target card. <card> can be specified as either the card_id or Bus:Device:Function (BDF). Defaults to card_id = 0 if not specified.
Note: Use the xbutil scan command to display both the card_id and BDF for installed cards.
N
--enable Enables p2p

Option –-enable, –-disable, and –-validatee mutually exclusive. Only one can be in the command.

A warm reboot is required if the returned xbutil query status for P2P is no_iomem.

--enable,

--disable,

--validate

mutually exclusive

--disable Enables p2p

Option --enable, –-disable, and –-validate are mutually exclusive. Only one can be in the command.

This might require warm reboot to fully disable.

--enable,

--disable,

--validate

mutually exclusive

--validate Validates p2p feature.

Option –-enable, –-disable, and –-validate are mutually exclusive. Only one can be in the command.

Run after a warm reboot if it is needed.

--enable,

--disable,

--validate

mutually exclusive

Use xbutil query to display the current status of P2P. The following is a partial output of the xbutil query command showing the current status under the heading P2P Enabled.
PCIe            DMA chan(bidir) MIG Calibrated  P2P Enabled
GEN 3x16        2               true            false
Table 2. P2P Enabled Returned Value Definition
Value Comment
true P2P is enabled.
false P2P is disabled.
no_iomem P2P is enabled in device but system could not allocate I/O memory, warm reboot is needed.

If P2P is not enabled when trying to validate, validation will be skipped and the following message will be displayed:

P2P BAR is not enabled. Skipping validation

If the card platform does not support P2P, the following message will be displayed:

ERROR: P2P is not supported on this platform

If no xclbin is programmed, the following message will be displayed:

'uuid' invalid, please re-program xclbin.