Keil Logo

Technical Support

On-Line Manuals

Compiler Reference Guide

Preface Arm Compiler Tools Overview armclang Reference armlink Reference fromelf Reference fromelf Command-line Options --base [[object_file::]load_region_ID=]num --bin --bincombined --bincombined_base=address --bincombined_padding=size,num --cad --cadcombined --compare=option[,option,…] --continue_on_error --coprocN=value (fromelf) --cpu=list (fromelf) --cpu=name (fromelf) --datasymbols --debugonly --decode_build_attributes --diag_error=tag[,tag,…] (fromelf) --diag_remark=tag[,tag,…] (fromelf) --diag_style={arm|ide|gnu} (fromelf) --diag_suppress=tag[,tag,…] (fromelf) --diag_warning=tag[,tag,…] (fromelf) --disassemble --dump_build_attributes --elf --emit=option[,option,…] --expandarrays --extract_build_attributes --fieldoffsets --fpu=list (fromelf) --fpu=name (fromelf) --globalize=option[,option,…] --help (fromelf) --hide=option[,option,…] --hide_and_localize=option[,option,…] --i32 --i32combined --ignore_section=option[,option,…] --ignore_symbol=option[,option,…] --in_place --info=topic[,topic,…] (fromelf) input_file (fromelf) --interleave=option --linkview, --no_linkview --localize=option[,option,…] --m32 --m32combined --only=section_name --output=destination --privacy (fromelf) --qualify --relax_section=option[,option,…] --relax_symbol=option[,option,…] --rename=option[,option,…] --select=select_options --show=option[,option,…] --show_and_globalize=option[,option,…] --show_cmdline (fromelf) --source_directory=path --strip=option[,option,…] --symbolversions, --no_symbolversions --text --version_number (fromelf) --vhx --via=file (fromelf) --vsn (fromelf) -w --wide64bit --widthxbanks armar Reference armasm Legacy Assembler Reference Appendixes

--rename=option[,option,…]

D1.52 --rename=option[,option,…]

Renames the specified symbol in an output ELF object.

Restrictions

You must use --elf and --output with this option.

Syntax

--rename=option[,option,…]

Where option is one of:

object_name::old_symbol_name=new_symbol_name
This replaces all symbols in the ELF object object_name that have a symbol name matching old_symbol_name.
old_symbol_name=new_symbol_name
This replaces all symbols that have a symbol name matching old_symbol_name.

You can:

  • Use wildcard characters ? and * for symbolic names in old_symbol_name, new_symbol_name, and object_name arguments.
  • Specify multiple values in one option followed by a comma-separated list of arguments.

Example

This example renames the clock symbol in the timer.axf image to myclock, and creates a new file called mytimer.axf:

fromelf --elf --rename=clock=myclock --output=mytimer.axf timer.axf
Non-ConfidentialPDF file icon PDF version101754_0614_00_en
Copyright © 2019, 2020 Arm Limited or its affiliates. All rights reserved. 
  Arm logo
Important information

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies.

Change Settings

Privacy Policy Update

Arm’s Privacy Policy has been updated. By continuing to use our site, you consent to Arm’s Privacy Policy. Please review our Privacy Policy to learn more about our collection, use and transfers
of your data.