‑‑image_input
Syntax
‑‑image_inputfilename[,symbol[,section[,alignment]]]
Parameters
| The pure binary file containing the raw image you want to link. See Rules for specifying a filename or directory as parameters. |
| The symbol which the binary data can be referenced with. |
| The section where the binary data will be placed. The default is |
| The alignment of the section. The default is |
Description
Use this option to link pure binary files in addition to the ordinary input files. The file’s entire contents are placed in the section, which means it can only contain pure binary data.
Note
Just as for sections from object files, sections created by using the ‑‑image_input option are not included unless actually needed. You can either specify a symbol in the option and reference this symbol in your application (or use a ‑‑keep option), or you can specify a section name and use the keep directive in a linker configuration file to ensure that the section is included.
Example
‑‑image_input bootstrap.abs,Bootstrap,CSTARTUPCODE,4
The contents of the pure binary file bootstrap.abs are placed in the section CSTARTUPCODE. The section where the contents are placed is 4-byte aligned and will only be included if your application (or the command line option ‑‑keep) includes a reference to the symbol Bootstrap.
See also
Caution
Project>Options>Linker>Input>Raw binary image