Appendix D
Obtaining xbmgmt Command
Options
Xilinx
®
Board Management (
xbmgmt
) utility is a standalone command line tool that is included
with the XRT installation package. This utility is used for card installation and administration, and
requires
sudo
privileges when running it and supports tasks include flashing the card firmware,
and scanning the current device and system configuration. Complete command documentation
can be found under
in the Application Acceleration Development flow of the Vitis
Unified Software Platform Documentation (UG1416).
This section describes how to obtain the
xbmgmt
command options necessary for flashing the
base partition and programming the shell partition.
The following command is used to flash the base partition.
$ sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell <base_name> --card
<card_bdf>
The following command is used to program the shell partition.
$ sudo /opt/xilinx/xrt/bin/xbmgmt partition --program --name <shell_name> --
card <card_bdf>
Command options, descriptions, and commands to display the options are provided in the
following table.
Table 5: Command Options and Descriptions
Option
Description
Command
card_bdf
Card Bus Device Function (BDF) for the
card in the following format:
[Bus : Device : Function]
xbmgmt flash --scan
or
xbmgmt partition --scan
base_name
Base partition firmware name
xbmgmt flash --scan
shell_name
Shell partition firmware name
xbmgmt partition --scan
Use the following command to list the available base partition.
$ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan
Appendix D: Obtaining xbmgmt Command Options
UG1301 (v1.8) February 5, 2021
Getting Started with Alveo Accelerator Cards
47