OS Manuals

/usr/bin/dtc

Device Tree Compiler (dtc) for compiling and manipulating device tree source and binary files

From device-tree-compiler 1.8.1-r5 (enterprise-packages), captured 2026-11-08 by running dtc --help (exit 0). permalink

Usage: dtc [options] <input file>

Options: -[qI:O:o:V:d:R:S:p:a:fb:i:H:sW:E:@LAThv]
  -q, --quiet
	Quiet: -q suppress warnings, -qq errors, -qqq all
  -I, --in-format <arg>
	Input formats are:
		dts - device tree source text
		dtb - device tree blob
		fs  - /proc/device-tree style directory
  -o, --out <arg>
	Output file
  -O, --out-format <arg>
	Output formats are:
		dts - device tree source text
		dtb - device tree blob
		yaml - device tree encoded as YAML
		asm - assembler source
  -V, --out-version <arg>
	Blob version to produce, defaults to 17 (for dtb and asm output)
  -d, --out-dependency <arg>
	Output dependency file
  -R, --reserve <arg>
	Make space for <number> reserve map entries (for dtb and asm output)
  -S, --space <arg>
	Make the blob at least <bytes> long (extra space)
  -p, --pad <arg>
	Add padding to the blob of <bytes> long (extra space)
  -a, --align <arg>
	Make the blob align to the <bytes> (extra space)
  -b, --boot-cpu <arg>
	Set the physical boot cpu
  -f, --force
	Try to produce output even if the input tree has errors
  -i, --include <arg>
	Add a path to search for include files
  -s, --sort
	Sort nodes and properties before outputting (useful for comparing trees)
  -H, --phandle <arg>
	Valid phandle formats are:
		legacy - "linux,phandle" properties only
		epapr  - "phandle" properties only
		both   - Both "linux,phandle" and "phandle" properties
  -W, --warning <arg>
	Enable/disable warnings (prefix with "no-")
  -E, --error <arg>
	Enable/disable errors (prefix with "no-")
  -@, --symbols
	Enable generation of symbols
  -L, --local-fixups
	Possibly generates a __local_fixups__ and a __fixups__ node at the root node
  -A, --auto-alias
	Enable auto-alias of labels
  -T, --annotate
	Annotate output .dts with input source file and line (-T -T for more details)
  -h, --help
	Print this help and exit
  -v, --version
	Print version and exit
Options (23)
OptionDescriptionSource
-q, --quietQuiet: -q suppress warnings, -qq errors, -qqq allhelp
-I, --in-format argInput formats are: dts - device tree source text dtb - device tree blob fs - /proc/device-tree style directoryhelp
-o, --out argOutput filehelp
-O, --out-format argOutput formats are: dts - device tree source text dtb - device tree blob yaml - device tree encoded as YAML asm - assembler sourcehelp
-V, --out-version argBlob version to produce, defaults to 17 (for dtb and asm output)help
-d, --out-dependency argOutput dependency filehelp
-R, --reserve argMake space for <number> reserve map entries (for dtb and asm output)help
-S, --space argMake the blob at least <bytes> long (extra space)help
-p, --pad argAdd padding to the blob of <bytes> long (extra space)help
-a, --align argMake the blob align to the <bytes> (extra space)help
-b, --boot-cpu argSet the physical boot cpuhelp
-f, --forceTry to produce output even if the input tree has errorshelp
-i, --include argAdd a path to search for include fileshelp
-s, --sortSort nodes and properties before outputting (useful for comparing trees)help
-H, --phandle argValid phandle formats are: legacy - "linux,phandle" properties only epapr - "phandle" properties only both - Both "linux,phandle" and "phandle" propertieshelp
-W, --warning argEnable/disable warnings (prefix with "no-")help
-E, --error argEnable/disable errors (prefix with "no-")help
-@, --symbolsEnable generation of symbolshelp
-L, --local-fixupsPossibly generates a __local_fixups__ and a __fixups__ node at the root nodehelp
-A, --auto-aliasEnable auto-alias of labelshelp
-T, --annotateAnnotate output .dts with input source file and line (-T -T for more details)help
-h, --helpPrint this help and exithelp
-v, --versionPrint version and exithelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.