Scroll to navigation

QDL(1) User Commands QDL(1)

NAME

qdl - Qualcomm Download

SYNOPSIS

qdl [options] <prog.mbn> (<program-xml> | <patch-xml> | <read-xml>)...

DESCRIPTION

qdl [options] <prog.mbn> ((read | write) <address> <binary>)... qdl [options] <prog.mbn> (erase <address>)... qdl [options] <prog.mbn> (sha256 <address>)... qdl [options] <prog.mbn> (reset) qdl list qdl chipinfo qdl ramdump [--debug] [-o <ramdump-path>] [<segment-filter>,...] qdl ks -p <sahara-dev-node> -s <id:file-path>... qdl flash (<flashmap>[::specifier] | <contents>[::<specifier>]) qdl create-zip <zipfile> <contents>[::<specifier>]
Print detailed debug info
Print the current version and exit
Dry run execution, no device reading or flashing
Allow skipping of missing files during flashing
Set target storage type T: <emmc|nand|nvme|spinor|ufs>
Provision the target storage
Set an optional folder T to search for files
Select target by serial number T (e.g. <0AA94EFD>)
Override chunk size for transaction with T
Generate table of digests in the T folder
Set slot number T for multiple storage devices
Use digest tables in the T folder for VIP
Do not send the reset command after flashing completes
Select device backend B: <auto|usb|qud> (default: auto)
Use readback mechanism M to skip <program> entries already on flash; M: <none|sha256> (default: none)
Print this usage info
<program-xml>
xml file containing <program> or <erase> directives
<patch-xml>
xml file containing <patch> directives
<read-xml>
xml file containing <read> directives
<address>
disk address specifier, can be one of <P>, <P/S>, <P/S+L>, <name>, or <P/name>, to specify a physical partition number P, a starting sector number S, the number of sectors to follow L, or partition by "name"
<ramdump-path>
path where ramdump should stored
<segment-filter>
optional glob-pattern to select which segments to ramdump
<sahara-dev-node>
Sahara device node, e.g. /dev/mhi0_QAIC_SAHARA (ks)
<id:file-path>
map a Sahara image id to a host file, repeatable (ks)
<flashmap>
flashmap JSON file, or ZIP archive with flashmap.json
<contents>
contents XML file
<specifier>
comma-separated list of specifiers, such as storage type, layout, and flavors

Example: qdl prog_firehose_ddr.elf rawprogram*.xml patch*.xml

qdl flash contents.xml::ufs,spinor/safe_rtos qdl flash installer.zip::layout1/ufs
August 2026 qdl version 2.8-1~bpo13+1