-delete


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

[Format]

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

[Description]

-

Deletes an external symbol name or library module.

-

Symbol names or modules in the specified file can be deleted.

-

For a C/C++ variable name or C function name, add an underscore (_) at the head of the definition name in the program. For a C++ function name, enclose the definition name in the program with double-quotes including the parameter strings. If the parameter is void, specify as "<function name>()". If there are several files or modules of the same name, the file that is input first is applied.

-

When a symbol is deleted using this option, the object is not deleted but the attribute is changed to the internal symbol.

[Examples]

delete=(_sym1)                ; Deletes the symbol _sym1 in all files.
delete=file1.obj(_sym2)       ; Deletes the symbol _sym2 in the file file1.obj.

[Remarks]

-

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

-

When form=library has been specified, this option deletes modules.

-

When form={absolute|relocate|hexadecimal|stype|binary} has been specified, this option deletes external symbols.

-

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