Legacy to new map¶

This document maps the legacy xbutil/xbmgmt commands to the new xbutil/xbmgmt commands. It lists out the new xbutil/xbmgmt calls that replace the existing calls. A few points:

The new utilities are complete redesign and architecture, hence there may not be exact 1-to-1 mapping.

The help menus (--help) of these new utilities have also been improved and are highly descriptive with regards to both the commands and options. Please refer to them as needed.

The new command opions have both short and long format, for example -d or --device. In the table below, only the longer option format is used.

You may refer the documentation of the new tools in the following links xbutil (Next Generation) and xbmgmt (Next Generation) .

xbutil¶

Subcommand Legacy	Subcommand New	Option Legacy	Option New
`help`	`--help`
`reset`	`reset`	`-d <bdf>`	`--device <bdf>`
`validate`	`validate`	`-d <bdf>`	`--device <bdf>`
		`-q`	`--run quick`
			`--run <testname>`
			`--format <type>`
			`--output <file>`
`scan`	`examine`
`query`	`examine`	`-d <bdf>`	`--device <bdf>`
			`--report <list>`
			`--output <file>`
`dump`	`examine`		`--format <type>`
`top`	`top`	`-d <bdf>`	`--device <bdf>`
`program`	`program`	`-d <bdf>`	`--device <bdf>`
		`-p <xclbin>`	`--user <xclbin>`

xbmgmt¶

Subcommand Legacy	Subcommand New	Option Legacy	Option New
`help`	`--help`
`flash`	`program`	`-d <bdf>`	`--device <bdf>`
		`--update`	`--base`
		`--update --shell <name>`	`--base --image <name w/ path>`
		`--factory_reset`	`--revert-to-golden`
`partition`	`program`	`--card <bdf>`	`--device <bdf>`
		`--program` `--name <shell name>`	`--shell <shell-file w/ path>`
		`--path <xclbin w/ path>`	`--user <xclbin w/ path>`
`scan`	`examine`		`--report host`
	`examine`		`--device <bdf>`
			`--report <list>`
			`--format <type>`
			`--output <file>`
`reset`	`reset`	`-d <bdf>`	`--device <bdf>`