Appendix D
Obtaining xbmgmt Command
Options
Xilinx
®
Board Management (xbmgmt) ulity is a standalone command line tool that is included
with the XRT installaon package. This ulity is used for card installaon and administraon, and
requires sudo privileges when running it and supports tasks include ashing the card rmware,
and scanning the current device and system conguraon. Complete command documentaon
can be found under xbmgmt Ulity in the Applicaon Acceleraon Development ow of the Vis
Unied Soware Plaorm Documentaon (UG1416).
This secon describes how to obtain the xbmgmt command opons necessary for ashing the
base paron and programming the shell paron.
The following command is used to ash the base paron.
$ sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell <base_name> --card
<card_bdf>
The following command is used to program the shell paron.
$ sudo /opt/xilinx/xrt/bin/xbmgmt partition --program --name <shell_name> --
card <card_bdf>
Command opons, descripons, and commands to display the opons 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 paron.
$ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan
Appendix D: Obtaining xbmgmt Command Options
UG1301 (v1.8) February 5, 2021 www.xilinx.com
Getting Started with Alveo Accelerator Cards 47