11.2. Informational Options

These options print information and exit without building anything.

--dump-build-graph

Dump to standard output the complete build graph consisting of items and platforms. This is primarily useful for debugging abuild or diagnosing unusual problems relating to which items are built in which order. Although nothing is built in when this option is specified, abuild still performs complete validation including reading of all the interface files. The build graph is discussed in Section 29.6, “Construction of the Build Graph”.

--dump-data

Dump to standard output all information computed by abuild. Useful for debugging or for tools that need in-depth information about what abuild knows. --dump-data is mutually exclusive with running any targets. If you need to see --dump-data output and build targets at the same time, use --monitored instead (see Chapter 28, Monitored Mode). For details about the format generated by --dump-data, please see Appendix C, --dump-data Format.

--help|-H

Print a brief summary of abuild's command-line options.

--list-platforms

Print the names of all object-code platforms categorized by platform type and build tree, and indicate which ones would be built by default. Note that abuild may build on additional platforms beyond those selected by default in order to satisfy dependencies from other items.

--list-traits

Print the names of all traits known in the local build tree, its backing areas, and its externals. This is the list of traits that are available for use on the command line with the --only-with-traits and --related-by-traits options.

--print-abuild-top

Print the path to the top of abuild's installation.

-V|--version

Print the version number of abuild.