mktar.py

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

Syntax:

 mktar.py  [-o output] [options] ... [board_name_argument]

Runs on:

Windows, Linux. Must be run using Python 2.7.5.

Options:

--bars
Include new-style (BAR) applications (implies --no-defaults)
--compress
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.
--help
Display a help message showing mktar usage information.
--no-defaults
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.
--profile
Specify the profile XML file. If it's not specified, the file name is profile.xml.
-P PRODUCT BOARDNAME, --product=PRODUCT BOARDNAME
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.
-Q QT_PATH, --qt=QT_PATH
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.
-z
Compress with gzip.

Description:

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

Note: If you use mktar.py 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:

$QNX_DEPLOYMENT_WORKSPACE/target/boards/omap5uevm/profile.xml.

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

$QNX_DEPLOYMENT_WORKSPACE/infra/utils/pymodules/qnx/config.py

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/path.py:get_stage_locator.

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

Exit status:

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

Caveats:

None.