-

Interpretation when omitted

-

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.

-

By specifying file or module, you can change only the names of the external 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.

-

To change symbol name "_sym1" to "data", describe as:

-

To change section ".text" in library module "lib1" to "data" to section "P", describe as:

-

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 -Xmerge_files.