Create an image of the platform and generate supporting files, such as .ifs and .tar

Syntax:  [-o output] [options]... [board_name.external]

Runs on:

Windows, Linux. Must be run using Python 2.7.5.


-c, --mksysimage-config-file
Specify the configuration file used for the utility.
-f, --force
Force the overwriting of existing .tar files.
-g, --osversion-content
Specify any additional content for the os.version file.
-G, --no-gen, --no-generation
Run only and the imaging components.
Specify the options for (see --help).
-h, --help
Show the help that describes how to use this command.
Specify the path of the configuration files for
Specify the options for (see --help).
Specify the options for (see --help).
Don't generate .ifs files.
Don't run the part of the process.
Don't run the part of the process.
Don't generate an os.version file.
-o OUTPUT_PATH, --output-path=OUTPUT_PATH
Write .image and .tar files to the specified path. If the -t option is specified, the .tar files are written to that path instead.
-p, --keep-partition-images
Keep the partition images.
Specify the name of the product. You can set the QNX_PRODUCT environment variable to specify the default product to use when this option isn't specified.
-q, --quiet
Prevent any output.
Specify the location where Qt is installed on the host computer. You can set the QNX_QT environment variable to specify the default location to use when this option isn't specified.
-t, --tar-file-path
Read and write .tar files to and from the specified path.
-v, --verbose
Increase the verbosity.
Specify the path to the QNX_DEPLOYMENT_WORKSPACE. This workspace is where you deployed the assets required to build the image.
You should refer to the Getting Started guide for the value of the QNX_DEPLOYMENT_WORKSPACE variable.


The utility is a Python script that invokes other utilities to generate tar files and images for each platform. The script is located at $QNX_DEPLOYMENT_WORKSPACE/infra/utils/scripts. You should refer to the Getting Started guide for the value of QNX_DEPLOYMENT_WORKSPACE.

By default, reads a configuration file from: $QNX_DEPLOYMENT_WORKSPACE/infra/product/AnM/boards/platform.ext/mksysimage/platform-mksysimage.cfg

This configuration file defines the tar files and images created during the image-generation process. The image variants for each platform are defined within the configuration file. By default, for each image variant, generates two tar files and one image. The tar file platform-os.tar contains two QNX filesystems that include all files except MLO and IFS files. The tar file platform-dos-image_variant contains a FAT16 filesystem that includes all bootup files, such as MLO and IFS files. The final generated image includes these two tar files.

You can change the default configuration file associated with The default file is located at: $QNX_DEPLOYMENT_WORKSPACE/infra/product/AnM/boards/platform.ext/mksysimage/platform-mksysimage.cfg

You can also specify your own file by using the -c option in Setting this option will enable you to further customize your tar files and images. For more information about changing the configuration, see "Configuration file for" in Getting Started. If you want to skip some steps of the image-generation process and generate only certain types of intermediate files, see "Troubleshooting tips" in the same guide.


To run, you need to specify the platform, its variant, and the output path.

The following example reads the default configuration file for the omap5uevm platform and creates three images and their corresponding .tar files in the specified output path called /tmp:

 -o /tmp/ omap5uevm.external

Exit status:

The specified image file was created successfully.
An error occurred.