OS Image Buildfiles

You can edit the OS image (mkifs) buildfile to configure the OS image.

The OS image is created by the mkifs utility. The utility creates the OS image according to command line options and instructions in the buildfile. The OS image buildfile is a plain text file that specifies:

Locations of buildfiles

The buildfile for your BSP is located in the directory ${BSP_ROOT_DIR}/prebuilt/${PROCESSOR}/boot/build/board.build directory. For example: /prebuilt/aarch64le/boot/build/dekelsinore-ghost8.build

Modifying buildfiles

To modify the OS image configuration using the buildfile, first review the information about the file's structure and content that this chapter provides. Then, make the required changes to the buildfile at the following location:

${BSP_ROOT_DIR}/src/hardware/startup/boards/board/board-variant/build

The buildfile changes take effect after you rebuild your system. To rebuild your system, in ${BSP_ROOT_DIR}, run make.

(Because the rebuild process overwrites the buildfile stored in the /images directory, you cannot use that buildfile to modify the OS image.)

For more information on how to build a new system image after you have modified the buildfile, see the chapter Working with QNX BSPs in this guide.

See also the mkifs entry in the Utilities Reference, and the appendix Sample Buildfiles in this guide.