-SPace | CS+ V8.01.00

-SPace

This option fills the vacant area of the output range.

[Specification format]

-SPace[=data]

-	Interpretation when omitted

None

[Detailed description]

-	This option fills the vacant area of the output range with user-specified data data.

-	The items that can be specified as data are shown below.

Numerical Value	Hexadecimal value
Random	Random number

-	The way of filling unused areas differs with the output range specification as follows.

-	When the -Output option is used to specify sections as the range for output:

The specified value is output to vacant areas between the specified sections.

-	When the -Output option is used to specify a range of addresses as the range for output:

The specified value is output to vacant areas within the specified range.

-	When the -FIX_RECORD_LENGTH_AND_ALIGN option is specified:

-	The specified value is output to an unused area at the top of a section, which starts at an address that can be divided by the alignment number.

-	The specified value is output when the end of a section does not reach the specified record length.

Output data sizes in units of 1, 2, or 4 bytes are valid. The size is determined by the hexadecimal number specified using this option.
If a 3-byte value is specified, the upper digit is extended with 0 to handle it as a 4-byte value.
If an odd number of digits is specified, the upper digit is extended with 0 to handle it as an even number of digits.

-	If the size of a vacant area is not a multiple of the size of the output data, the value is output as many times as possible, and then a warning will be output.

[Example of use]

-	To fill the vacant memory area with "ffH" within the range from address 100H to address 2FFH, describe as:

>rlink a.obj b.obj -form=hexadecimal -output=file1=100-2ff -start=P1/100,P2/200 -space=ff

[Remark]

-	If the specification of the data is omitted in this option, vacant areas are not filled with values.

-	This option is valid only when the -form={binary\|stype\|hexadecimal} option is specified.

-	If the output range is not specified in the -output option and the -fix_record_length_and_align option is not specified, this option will be invalid.