Create a .tar file containing a filesystem for a specified board variant. The (wrapped by (Linux) or mksysimage.bat (Windows)) calls this command. You shouldn't call this command on its own.

Syntax:  [-o output] [options] ... [board_name_argument]

Runs on:

Windows, Linux. Must be run using Python 2.7.5.


Include new-style (BAR) applications (implies --no-defaults)
Use the given compression method: auto (default), none, gzip, or bzip2.
--cpu CPUDIR
Set the system architecture (e.g., \"armle-v7\").
-f SETNAME, --fileset=SETNAME
Include the specified fileset.
Display a help message showing mktar usage information.
Don't include the board's default filesets or applications.
-o OUTPUT, --output=OUTPUT
Write to the specified output file.
-p, --package
Include the given package (implies --no-defaults).
--prefix PREFIX
Prefix each path with the specified string.
Specify the profile XML file. If it's not specified, the file name is profile.xml.
Specify the name of the product and the board. The entries that can be used for productname are the names of the subdirectories found in $QNX_DEPLOYMENT_WORKSPACE/target/product/ and the possible entries for boardname are found in $QNX_DEPLOYMENT_WORKSPACE/target/product/productname/boards/.
You should refer to the Getting Started guide for the value of the QNX_DEPLOYMENT_WORKSPACE variable.
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.
-s, --symbols
Search in the runtime-symbols/ folder for the unstripped binaries.
-v, --verbose
Increase verbosity.
Compress with gzip.


The utility creates a .tar file containing the filesets listed in the board-specific profile, resulting in proper ownership and permissions. Don't use the script on its own. Instead, use the script, which calls the script. To create a .tar file with no image, you can call the script with the --no-mkimage option to create .tar files and no image.

Note: If you use without specifying the profile option --profile, then by default, the mktar utility will use the file profile.xml located in /boards/board.external.

The mktar script uses Python's tarfile module to generate a .tar file with the appropriate permissions. The list of included files is determined by a board profile, which is stored as profile.xml in the board directory, whose path is:


For more information and for details about dependencies, see the file located at:


You can overwrite the default profile by using the --profile option. The -vvv option shows the search path used to find files. The typical search path is implemented in the file $QNX_DEPLOYMENT_WORKSPACE/infra/utils/pymodules/qnx/

For more information about how the paths are searched, see "Understanding search paths" in Getting Started.

Exit status:

A .tar file was generated successfully.
An error occurred.