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.