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.