2.2 Compiler command-line options listed by group

This topic lists the compiler command-line options, ordered by functional group.

Note

The following characters are interchangeable:
  • Nonprefix hyphens and underscores. For example, --version_number and --version-number.
  • Equals signs and spaces. For example, armcc --cpu=list and armcc --cpu list.
This applies to all tools provided with the compiler.
The compiler command-line options are as follows:
Help
  • --echo
  • --help
  • --show_cmdline
  • --version_number
  • --vsn
Source languages
  • --c90
  • --c99
  • --compile_all_input, --no_compile_all_input
  • --cpp
  • --strict, --no_strict
  • --strict_warnings
Search paths
  • -Idir[,dir,...]
  • -Jdir[,dir,...]
  • --kandr_include
  • --preinclude=filename
  • --reduce_paths, --no_reduce_paths
  • --sys_include
Precompiled headers
  • --create_pch=filename
  • --pch
  • --pch_dir=dir
  • --pch_messages, --no_pch_messages
  • --pch_verbose, --no_pch_verbose
  • --use_pch=filename
Preprocessor
  • -C
  • --code_gen, --no_code_gen
  • -Dname[(parm-list)][=def]
  • -E
  • -M
  • -Uname
C++
  • --anachronisms, --no_anachronisms
  • --dep_name, --no_dep_name
  • --force_new_nothrow, --no_force_new_nothrow
  • --friend_injection, --no_friend_injection
  • --guiding_decls, --no_guiding_decls
  • --implicit_include, --no_implicit_include
  • --implicit_include_searches, --no_implicit_include_searches
  • --implicit_typename, --no_implicit_typename
  • --nonstd_qualifier_deduction, --no_nonstd_qualifier_deduction
  • --old_specializations, --no_old_specializations
  • --parse_templates, --no_parse_templates
  • --pending_instantiations=n
  • --rtti, --no_rtti
  • --using_std, --no_using_std
  • --vfe, --no_vfe
Output format
  • --asm
  • -c
  • --default_extension=ext
  • --depend=filename
  • --depend_format=string
  • --depend_system_headers, --no_depend_system_headers
  • --info=totals
  • --interleave
  • --list
  • --md
  • -o filename
  • -S
  • --split_sections
Target architectures and processors
  • --arm
  • --compatible=name
  • --cpu=list
  • --cpu=name
  • --fpu=list
  • --fpu=name
  • --thumb
Floating-point support
  • --fp16_format=format
  • --fpmode=model
  • --fpu=list
  • --fpu=name
Debug
  • --debug, --no_debug
  • --debug_macros, --no_debug_macros
  • --dwarf2
  • --dwarf3
  • -g
  • --remove_unneeded_entities, --no_remove_unneeded_entities
Code generation
  • --allow_fpreg_for_nonfpdata, --no_allow_fpreg_for_nonfpdata
  • --alternative_tokens, --no_alternative_tokens
  • --bigend
  • --bss_threshold=num
  • --conditionalize, --no_conditionalize
  • --dollar, --no_dollar
  • --enum_is_int
  • --exceptions, --no_exceptions
  • --exceptions_unwind, --no_exceptions_unwind
  • --extended_initializers, --no_extended_initializers
  • --hide_all, --no_hide_all
  • --littleend
  • --locale=lang_country
  • --loose_implicit_cast
  • --message_locale=lang_country[.codepage]
  • --min_array_alignment=opt
  • --multibyte_chars, --no_multibyte_chars
  • --pointer_alignment=num
  • --protect_stack, --no_protect_stack
  • --restrict, --no_restrict
  • --signed_bitfields, --unsigned_bitfields
  • --signed_chars, --unsigned_chars
  • --split_ldm
  • --unaligned_access, --no_unaligned_access
  • --vla, --no_vla
  • --wchar16
  • --wchar32
Optimization
  • --autoinline, --no_autoinline
  • --data_reorder, --no_data_reorder
  • --forceinline
  • --fpmode=model
  • --inline, --no_inline
  • --library_interface=lib
  • --library_type=lib
  • --loop_optimization_level=opt
  • --lower_ropi, --no_lower_ropi
  • --lower_rwpi, --no_lower_rwpi
  • --multifile, --no_multifile
  • -Onum
  • -Ospace
  • -Otime
  • --retain=option

Note

Optimization options can limit the debug information generated by the compiler.
Diagnostics
  • --brief_diagnostics, --no_brief_diagnostics
  • --diag_error=tag[,tag,...]
  • --diag_remark=tag[,tag,...]
  • --diag_style={arm|ide|gnu}
  • --diag_suppress=tag[,tag,...]
  • --diag_suppress=optimizations
  • --diag_warning=tag[,tag,...]
  • --diag_warning=optimizations
  • --errors=filename
  • --remarks
  • -W
  • --wrap_diagnostics, --no_wrap_diagnostics
Command-line options in a text file
  • --via=filename
Linker feedback
  • --feedback=filename
Procedure call standard
  • --apcs=qualifier...qualifier
Passing options to other tools
  • -Aopt
  • -Lopt
Other options
  • --omf_browse
Related concepts
2.4 Order of compiler command-line options
Related reference
Compiler Command-line Options
Non-ConfidentialPDF file icon PDF versionARM DUI0375E
Copyright © 2007, 2008, 2011, 2012, 2014 ARM. All rights reserved.