Development Tools

-LIB_REName [V1.08 or later]

This option changes the name of a symbol or section that was input from a library.

[Specification format]

-LIB_REName=suboption[, ...]

  suboption := (names)

            |  file(names)

            |  file|modules(names)

  modules := module[|module ...]

  names := name1=name2[, ...]

-	Interpretation when omitted

None

[Detailed description]

-	This option changes the name of a global symbol or section included in a module within the library that was specified by the -library option.

-	Specify the symbol name or section name to be changed as name1. Specify the symbol name or section name after changing as name2.

-	When you specify a C variable name, add "_" at the head of the definition name in the program.

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

-	If there are two or more files or modules with the same name, the priority depends on the input order.

-	If this option is specified more than once, all specifications will be valid.

-	An error will occur in any of the following cases.

-	When the specified name, file, or module cannot be found

-	When the parameter is omitted

[Example of use]

-	To change "_sym1" in b.lib to "_data", describe as:

>rlink a.obj -lib=b.lib,c.lib -lib_rename=b.lib(_sym1=_data)

[Remark]

-	If this option is specified together with the -form={object,library}, -extract or -strip option, an error will occur.

-	When the -form={absolute\|hexadecimal\|stype\|binary} option is specified, the -show=struct option cannot be specified together.

-	The section name of the input library cannot be changed.

-	Correct operation is not guaranteed if this option is used in combination with the compile option -Omerge_files.