-rename


< Optimizing Linkage Editor (rlink) Options / Other Options >

[Format]

-rename = <suboption> [,...]
          <suboption>: {[<file>] (<name> = <name> [,...])
                      | [<module>] (<name> = <name> [,...] ) }

[Description]

-

Modifies an external symbol name or a section name.

-

Symbol names or section names in a specific file or library in a module can be modified.

-

For a C/C++ variable name, add an underscore (_) at the head of the definition name in the program.

-

When a function name is modified, the operation is not guaranteed.

-

If the specified name matches both section and symbol names, the symbol name is modified.

-

If there are several files or modules of the same name, the priority depends on the input order.

[Examples]

rename=(_sym1=data)         ; Modifies _sym1 to data.
rename=lib1(P=P1)           ; Modifies the section P to P1
                            ; in the library module lib1.

[Remarks]

-

When extract or strip is specified, this option is unavailable.

-

When form=absolute is specified, the section name of the input library cannot be modified.

-

Operation is not guaranteed if this option is used in combination with compile option -merge_files.