-REName | CS+ V8.01.00

-REName

This option changes an external symbol name or a section name.

[Specification format]

-REName=suboption[, ...]

  suboption := {(names)|file(names)|module(names)}

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

-	Interpretation when omitted

None

[Detailed description]

-	This option changes an external symbol name or a section name.

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

-	By specifying file, you can change only the names of the sections included in file.

-	When the output of library files is selected (with -form=library), you can specify module so that only the names of the sections included in module within the input library will be changed.

To change section names within the input library in other cases, use the -lib_rename option.

-	By specifying file or module, you can change only the names of the global symbols included in file or module.

-	When a C variable name is specified, 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 the following case.

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

[Example of use]

-	To change symbol name "_sym1" to "_data", describe as:

>rlink a.obj b.obj -rename=(_sym1=_data)

-	To change section ".SEC1" in library module "lib1" to section ".SEC2", describe as:

>rlink -form=library -library=lib1.lib -rename=(.SEC1=.SEC2)

[Remark]

-	If this option is specified together with the -extract option or -strip option, an error will occur.

-	When the -form={absolute\|hexadecimal\|stype\|binary} option is specified, the section name of the input library cannot be changed.

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