-Binary


This option specifies the input binary file.

[Specification format]

-Binary=suboption[, ...]
  suboption := file( section[:alignment][/attribute][,symbol] )

 

-

Interpretation when omitted

None

[Detailed description]

-

This option specifies input binary file file.
If multiple files are specified, delimit them with a comma (,).

-

If the extension is omitted from the input file specification, it is assumed that ".bin" has been specified.

-

Input binary data is allocated as the data of specified section section.
Specify the section address by the -start option.
An error will occur if section is omitted.

-

When symbol symbol is specified, it can be linked as a defined symbol.
For a variable name referenced by a C program, add "_" at the head of the reference name in the program.

-

The section specified by this option can have its section attribute and number of alignment specified.

-

CODE or DATA can be specified as section attribute attribute.
If attribute is omitted, the write, read, and execute attributes will be all valid by default.

-

The value that can be specified for number of alignment alignment is a power of 2 (1, 2, 4, 8, 16, or 32).
Other value cannot be specified.
If alignment is omitted, "1" will be valid by default.

[Example of use]

-

b.bin is allocated from 0x200 as the D1bin section.
c.bin is allocated after D1bin as the D2bin section (with the number of alignment = 4).
The c.bin data is linked as defined symbol "_datab".
To perform the above operations, describe as:


>rlink a.obj -start=D*/200 -binary=b.bin(D1bin),c.bin(D2bin:4,_datab)

[Remark]

-

If the -form={object|library} option or -strip option is specified, this option will be invalid.

-

If input object file is not specified, this option cannot be specified.