Perform setup activities and then run mkifs to include IFS
files in an image. 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:
gen-ifs.py [-o] output [options]
Runs on:
Windows, Linux. Must be run using Python 2.7.5.
Options:
- -c, --config
- Read the specified IFS configuration file.
- -d
defaultifs,
--default-ifs=defaultifs
- Specify which IFS file is the default IFS
(qnx-ifs).
- --defaults
- Include default directories in the search path.
- -f
buildfile,
--input=buildfile
- Include the specified input file.
- -h, --help
- Show the help that describes how to use this command.
- -N--no-defaults
- Don't include default directories in the search path.
- -o
imagefile,
--output=imagefile
- Write to the specified IFS file.
- -P
productname
boardname,
--product=productname
boardname
- Specify the product name and the board name. 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.
- --output-path
- Write IFS(s) to the specified location.
- -r
directory,
--root=directory
- Include the specified directory as a root directory.
- -v, --verbose
- Increase verbosity.
Description:
The gen-ifs.py script defines MKIFS_PATH for the
specified board type, locates and concatenates the specified buildfiles, and then
runs mkifs to include the IFS files in an image. Don't use the
gen-ifs.py script on its own. Instead, you should run mksysimage.py, which
calls the gen-ifs.py script.
An IFS is a bootable image filesystem that contains the procnto
module, your boot script, and possibly other components such as drivers and shared
objects. To create the IFS files to include in the final target image,
gen-ifs.py calls the mkifs utility.
Note: If you generate only a single IFS (.ifs) file, then you need
to specify just the -o and -f options. However, if
you want to generate multiple .ifs files, then you must specify
at least the -c, -d, and
--output-path options.
The following example uses the omap5uevm platform and creates an
.ifs file. The information in the resulting file is used by
the image-generation script mksysimage.py.
Exit status:
- 0
- The setup activities and inclusion of the IFS image files completed successfully.
- >0
- An error occurred.