dump-nodes-tree

Synopsis

 qbs dump-nodes-tree [options] [config:configuration-name]

Description

Dumps the nodes in the build graph to stdout.

This is an internal command that is used for debugging purposes only.

Options

--build-directory|-d <directory>

Specifies a <directory> where build artifacts are stored.

The default value is the current directory unless preferences.defaultBuildDirectory is set.

Relative paths will be interpreted relative to the current directory.

You can use the following special values as placeholders:

  • @project is expanded to the name of the project file excluding the extension .qbs.
  • @path is expanded to the name of the directory containing the project file.

--products|-p <name>[,<name>...]

Takes only the products specified by <name> and their dependencies into account.

--settings-dir <directory>

Reads all settings (such as profile information) from the specified <directory>. If the directory does not exist, it will be created.

The default value is system-specific. For example:

  • Linux: $HOME/.config/QtProject/qbs
  • Windows: %APPDATA%\QtProject\qbs
  • macOS: $HOME/Library/Preferences/qbs

Parameters

config:configuration-name

Specifies the build configuration to use.

Qbs can build a project for one or multiple configurations at once, each having a different set of parameters. The config parameter has a special function: with each occurrence a new configuration instance begins and all subsequent parameters until the next config are assigned to this instance. Parameter assignments before the first occurrence of config are applied to all build configurations. Inside products and modules, the current active build configuration can be retrieved via qbs.configurationName.

In the following snippet, a profile clang is applied to all configurations while cpp.optimization is different for debug and release:

 profile:clang config:debug cpp.optimization:none config:release cpp.optimization:small

The value of config determines the name of the build folder and affects the default value of the qbs.buildVariant property. Qbs knows the config values "debug" and "release", but in general any name can be chosen. When naming configurations created for special purposes, follow the rules for legal names generally used in programming languages:

  • The first character must be a letter (a-z), an underscore (_), or a dollar sign ($).
  • Subsequent characters may be letters, digits, underscores, or dollar signs.

Examples

Dumps the nodes tree into a file called nodes-tree.log:

 qbs dump-nodes-tree >nodes-tree.log