gen-ifs

Syntax:

 gen-ifs  [-o] output [options]

Runs on:

QNX Neutrino

Options:

-c, --config: Read the specified IFS configuration file.
-d, --default-ifs: Specify which IFS file is the default IFS (qnx-ifs).
--defaults: Include default directories in the search path.
-f, --input: Include the specified input file.
-N--no-defaults: Don't include default directories in the search path.
-o, --output: Write to the specified IFS file.
--output-path: Write IFS(s) to the specified location.
-r, --root: Include the specified directory as a root directory.
-v, --verbose: Increase verbosity.

Description:

The gen-ifs utility sets up the 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.

The gen-ifs utility calls the mkifs utility to create the .ifs file(s) that are included in the final target image. 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.

Note: If you generate only a single .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.

Examples:

The following example creates a single ifs file as output:

%QNX_CAR_DEPLOYMENT%/deployment/scripts/gen-ifs -o omap5uevm.external

Exit status:

0: The setup activities and inclusion of the IFS image files completed successfully.
>0: An error occurred.

Caveats:

None.