ROFSBUILD
ROFSBUILD is the Symbian platform non-XIP (execute-in-place) ROM builder.
It is normally invoked through BUILDROM, the
Symbian platform ROM configuration tool that acts as a front-end to ROFSBUILD.
ROFSBUILD understands a sub-set of the BUILDROM OBEY file syntax.
Syntax conventions
All commands and options should be entered as stated. For more
information on general syntax conventions, see the BNF grammar section in
Symbian OS Library >> About the Symbian Developer Library
>> Documentation conventions.
ROFSBUILD command syntax
ROFSBUILD [options] <obeyfile>
options
can be one or more of the following:
–argfile=<parameter file>
|
Accepts a parameter file, which contains a list of command-line
parameters specific to the ROM tools, as input.
|
-v
|
Verbose mode.
|
-?
|
Displays more detailed help for the command.
|
-s[log|screen|both]
|
Displays a summary of the size to the specified destination, i.e.
to the log, to the screen or to both the log and the screen.
|
-d<bitmask>
|
Sets the trace bitmask; this only applies to debug builds.
The simplest way of specifying this is to use a string of
hexadecimal characters starting with 0x (e.g 0x01234567). However, any string
that can be interpreted and translated into a valid TUint value may be used.
See the standard C function strtoul().
|
-compress
|
Compresses executable files where possible using the inflate
(Deflate, Huffman+LZ77) algorithm unless the -compressionmethod
keyword is used to override the default.
|
-compressionmethod [none | inflate | bytepair]
|
Can be used either with the -compress keyword or
alone.
none
|
No compression is used.
|
Inflate
|
Compresses executable files using the default (Deflate,
Huffman+LZ77) algorithm.
|
bytepair
|
Compresses executable files using the bytepair algorithm.
Bytepair compression allows faster decompression than the default Deflate,
Huffman+LZ77 algorithm and supports demand paging by performing compression and
decompression of code in independent 4 KB pages.
|
|
-coreimage <core image file>
|
Uses the specified core image file as the basis for creating the
extension.
|
-datadrive=<obeyfile_1>,[...,<obeyfile_n>]
|
Specifies the data drive description IBY/OBY file.
|
-lowmem
|
Reduces the physical memory consumption during image generation.
|
-loglevel<level>
|
Level of information to log file. The following valid log levels
are available:
0
|
Default level of information to log file.
|
1
|
Logs the host or the ROM filenames, the file size, and the
hidden attribute in addition to the loglevel 0 information.
|
2
|
Logs the E32 file header attributes such as UIDs, data
size, heap size, stack size, VID, SID, and priority in addition to the
loglevel 1 information.
|
|
-fastcompress
|
Compresses the files specified in the oby files with low
byte-pair compression ratio. This reduces the time to create image and
increases the size of output image.
|
<obeyfile>
is a standard text file containing
statements that are used to control the operation of the tool.
See the OBEY files reference for the
full syntax.