bartoszek/zephyr
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

doc: document CMAKE_BUILD_PARALLEL_LEVEL and VERBOSE env variables

Browse Source 
Sysbuild may include several images and when using ninja as build tools
then build options like `ninja -v` or `ninja -j <n>` is only consumed
by the top-level build folder, which is sysbuild itself.

CMake supports setting number of jobs or verbosity using environment
variables.

Document this feature in the Building with sysbuild section.

Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
This commit is contained in:
Torsten Rasmussen 2025-03-06 12:17:17 +01:00 committed by Benjamin Cabé
parent 63cf79bd99
commit e270fd4689
1 changed files with 19 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
doc/build/sysbuild/index.rst vendored
View File

@ -143,6 +143,25 @@ As mentioned above, you can run sysbuild via ``west build`` or ``cmake``.
an extra CMake argument. ``APP_DIR`` is the path to the main Zephyr
application managed by sysbuild.
.. tip::
The environment variables, ``CMAKE_BUILD_PARALLEL_LEVEL`` and ``VERBOSE``, can be used to
control the build process when using sysbuild with CMake and ninja.
To set number of jobs for ninja for all sysbuild images, set the CMAKE_BUILD_PARALLEL_LEVEL
environment variable and invoke the build with ``cmake --build``, for example:
.. code-block:: shell
CMAKE_BUILD_PARALLEL_LEVEL=<n> cmake --build .
For verbose output of all images, use:
.. code-block:: shell
VERBOSE=1 cmake --build .
Configuration namespacing
*************************