The mkimage.py utility script takes as input a configuration file that provides
image information.
Note:
For information about running this script, see mkimage.py in the System Services
Reference.
The configuration
file used by mkimage.py provides the following information:
- maximum size of the image
- size and number of partitions, to a maximum of four
- order of partitions
- type of each partition
- path to each partition
For example, the contents of the OMAP5 configuration file (omap5uevm-sd.cfg) look like
this:
[disk]
heads=64
sectors_per_track=32
cylinders=3724
sector_size=512
[boot]
path=/dos
type=12
num_sectors=1048576
order=1
[base]
path=/base
type=179
num_sectors=1253376
order=2
[data]
path=/
type=178
num_sectors=5322752
order=3
The sections of this file define the following:
-
[disk]
- This section doesn't specify a partition, but determines the size of the image and of the
partitions. This section is required, must not be empty, must appear first in the file, and must be
called [disk].
- heads
- The number of heads for the data medium used.
- sectors_per_track
- The number of sectors for each track for the data medium used.
- cylinders
- The number of cylinders for the data medium.
- sector_size
- The size of the sectors used to store the data.
-
[partition_name]
- A partition in the image. In the example above, [boot] is the first partition and
contains boot information.
-
path
- Identifies the mountpoint of the partition.
-
type
- Identifies the type of partition. For information about partition types, see "Partitions" in the System Architecture guide for QNX Neutrino.
-
num_sectors
- The number of sectors for the partition.
- order
- The order for the specified partition in the image. If the order is 1, it's the
bootable partition.
The example above shows three partitions:
- [boot] is of type 12 (FAT), has a partition order of 1 (meaning the first partition in
the image), and is located at /dos. The configuration file used with
mksysimage.py will indicate that this first partition is the boot
ifs and that the ifs file will be renamed to
qnx-ifs.
- [base] is of type 179 (QNX Power-Safe), has a partition order of 2, and is located at
/base.
- [data] is of type 178 (QNX Power-Safe), has a partition order of 3, and is located at
the root /.