OS Manuals

/usr/arm-none-eabi/bin/as

GNU Binutils built as a cross toolchain for the bare-metal ARM EABI target (arm-none-eabi). It provides target-prefixed tools: arm-none-eabi-as, -ld, -ld.bfd, -objcopy, -objdump, -nm, -ar, -ranlib, -strip, -readelf, -size, -strings, -addr2line, -c++filt, -elfedit and -gprof. They assemble, link, inspect and convert ARM/Thumb object files for Cortex-M/R/A embedded firmware development. The package is built from the same binutils-gdb source as Wolfi's native binutils, configured with --target=arm-none-eabi.

From binutils-arm-none-eabi 2.47-r2 (enterprise-packages), captured 2026-11-08 by running as --help (exit 0). permalink

Usage: /usr/arm-none-eabi/bin/as [option...] [asmfile...]
Options:
  -a[sub-option...]	  turn on listings
                      	  Sub-options [default hls]:
                      	  c      omit false conditionals
                      	  d      omit debugging directives
                      	  g      include general info
                      	  h      include high-level source
                      	  i      include ginsn and synthesized CFI info
                      	  l      include assembly
                      	  m      include macro expansions
                      	  n      omit forms processing
                      	  s      include symbols
                      	  =FILE  list to FILE (must be last sub-option)
  --alternate             initially turn on alternate macro syntax
  --compress-debug-sections[={none|zlib|zlib-gnu|zlib-gabi|zstd}]
                          compress DWARF debug sections
		            Default: none
  --nocompress-debug-sections
                          don't compress DWARF debug sections
  -D                      produce assembler debugging messages
  --dump-config           display how the assembler is configured and then exit
  --debug-prefix-map OLD=NEW
                          map OLD to NEW in debug information
  --defsym SYM=VAL        define symbol SYM to given value
  --execstack             require executable stack for this object
  --noexecstack           don't require executable stack for this object
  --size-check=[error|warning]
			  ELF .size directive check (default --size-check=error)
  --elf-stt-common=[no|yes] (default: no)
                          generate ELF common symbols with STT_COMMON type
  --sectname-subst        enable section name substitution sequences
  --generate-missing-build-notes=[no|yes] (default: no)
                          generate GNU Build notes if none are present in the input
  --gsframe[={no|yes}]    whether to generate SFrame stack trace information
                          (default: no)
			  Default version emitted is V3
  --gsframe-<N>           generate SFrame version <N> information. 3 == <N>
  --reloc-section-sym=[all|internal|none]
                          adjust eligible relocations to use section symbols
                          (default: all)
  -f                      skip whitespace and comment preprocessing
  -g, --gen-debug         generate debugging information
  --gstabs                generate STABS debugging information
  --gstabs+               generate STABS debug info with GNU extensions
  --gdwarf-<N>            generate DWARF<N> debugging information. 2 <= <N> <= 5
  --gdwarf-cie-version=<N> generate version 1, 3 or 4 DWARF CIEs
  --gdwarf-sections       generate per-function section names for DWARF line information
  --hash-size=<N>         ignored
  --help                  show all assembler options
  --target-help           show target specific options
  -I DIR                  add DIR to search list for .include directives
  -J                      don't warn about signed overflow
  -K                      warn when differences altered for long displacements
  -L, --keep-locals       keep local symbols (e.g. starting with `L')
  -M, --mri               assemble in MRI compatibility mode
  --MD FILE               write dependency information in FILE (default none)
  --multibyte-handling=<method>
                          what to do with multibyte characters encountered in the input
  -nocpp                  ignored
  -no-pad-sections        do not pad the end of sections to alignment boundaries
  -o OBJFILE              name the object-file output OBJFILE (default a.out)
  -R                      fold data section into text section
  --reduce-memory-overheads ignored
  --statistics            print various measured statistics from execution
  --strip-local-absolute  strip local absolute symbols
  --traditional-format    Use same format as native assembler when possible
  --version               print assembler version number and exit
  -W, --no-warn           suppress warnings
  --warn                  don't suppress warnings
  --fatal-warnings        treat warnings as errors
  --no-info               suppress information messages
  --info                  don't suppress information messages
  -w                      ignored
  -X                      ignored
  -Z                      generate object file even after errors
  --listing-lhs-width     set the width in words of the output data column of
                          the listing
  --listing-lhs-width2    set the width in words of the continuation lines
                          of the output data column; ignored if smaller than
                          the width of the first line
  --listing-rhs-width     set the max width in characters of the lines from
                          the source file
  --listing-cont-lines    set the maximum number of continuation lines used
                          for the output data column of the listing
  @FILE                   read options from FILE
 ARM-specific assembler options:
  -k                      generate PIC code
  -mthumb                 assemble Thumb code
  -mthumb-interwork       support ARM/Thumb interworking
  -mapcs-32               code uses 32-bit program counter
  -mapcs-26               code uses 26-bit program counter
  -mapcs-float            floating point args are in fp regs
  -mapcs-reentrant        re-entrant code
  -matpcs                 code is ATPCS conformant
  -mbig-endian            assemble for big-endian
  -mlittle-endian         assemble for little-endian
  -mapcs-frame            use frame pointer
  -mapcs-stack-check      use stack size checking
  -mno-warn-deprecated    do not warn on use of deprecated feature
  -mwarn-restrict-it      warn about performance deprecated IT instructions in ARMv8-A and ARMv8-R
  -mwarn-syms             warn about symbols that match instruction names [default]
  -mno-warn-syms          disable warnings about symobls that match instructions
  -mcpu=<cpu name>	  assemble for CPU <cpu name>
  -march=<arch name>	  assemble for architecture <arch name>
  -mfpu=<fpu name>	  assemble for FPU architecture <fpu name>
  -mfloat-abi=<abi>	  assemble for floating point ABI <abi>
  -meabi=<ver>		  assemble for eabi version <ver>
  -mimplicit-it=<mode>	  controls implicit insertion of IT instructions
  -mccs			  TI CodeComposer Studio syntax compatibility mode
  -mfp16-format=[ieee|alternative]
                          set the encoding for half precision floating point numbers to IEEE
                          or Arm alternative format.
  -EB                     assemble code for a big-endian cpu
  -EL                     assemble code for a little-endian cpu
  --fix-v4bx              Allow BX in ARMv4 code
  --fdpic                 generate an FDPIC object file

Report bugs to <https://sourceware.org/bugzilla/>
Options (80)
OptionDescriptionSource
-a sub-option...turn on listings Sub-options [default hls]: c omit false conditionals d omit debugging directives g include general info h include high-level source i include ginsn and synthesized CFI info l include…help
--alternateinitially turn on alternate macro syntaxhelp
--compress-debug-sections none|zlib|zlib-gnu|zlib-gabi|zstdcompress DWARF debug sections Default: nonehelp
--nocompress-debug-sectionsdon't compress DWARF debug sectionshelp
-Dproduce assembler debugging messageshelp
--dump-configdisplay how the assembler is configured and then exithelp
--debug-prefix-map OLD=NEWmap OLD to NEW in debug informationhelp
--defsym SYM=VALdefine symbol SYM to given valuehelp
--execstackrequire executable stack for this objecthelp
--noexecstackdon't require executable stack for this objecthelp
--size-check error|warningELF .size directive check (default --size-check=error)help
--sectname-substenable section name substitution sequenceshelp
--gsframe no|yeswhether to generate SFrame stack trace information (default: no) Default version emitted is V3help
--gsframe- Ngenerate SFrame version <N> information.help
--reloc-section-sym all|internal|noneadjust eligible relocations to use section symbols (default: all)help
-fskip whitespace and comment preprocessinghelp
-g, --gen-debuggenerate debugging informationhelp
--gstabsgenerate STABS debugging informationhelp
--gstabs+generate STABS debug info with GNU extensionshelp
--gdwarf- Ngenerate DWARF<N> debugging information.help
--gdwarf-sectionsgenerate per-function section names for DWARF line informationhelp
--hash-size Nignoredhelp
--helpshow all assembler optionshelp
--target-helpshow target specific optionshelp
-I DIRadd DIR to search list for .include directiveshelp
-Jdon't warn about signed overflowhelp
-Kwarn when differences altered for long displacementshelp
-L, --keep-localskeep local symbols (e.g. starting with `L')help
-M, --mriassemble in MRI compatibility modehelp
--MD FILEwrite dependency information in FILE (default none)help
--multibyte-handling methodwhat to do with multibyte characters encountered in the inputhelp
-nocppignoredhelp
-no-pad-sectionsdo not pad the end of sections to alignment boundarieshelp
-o OBJFILEname the object-file output OBJFILE (default a.out)help
-Rfold data section into text sectionhelp
--reduce-memory-overheads ignoredhelp
--statisticsprint various measured statistics from executionhelp
--strip-local-absolutestrip local absolute symbolshelp
--traditional-formatUse same format as native assembler when possiblehelp
--versionprint assembler version number and exithelp
-W, --no-warnsuppress warningshelp
--warndon't suppress warningshelp
--fatal-warningstreat warnings as errorshelp
--no-infosuppress information messageshelp
--infodon't suppress information messageshelp
-wignoredhelp
-Xignoredhelp
-Zgenerate object file even after errorshelp
--listing-lhs-widthset the width in words of the output data column of the listinghelp
--listing-lhs-width2set the width in words of the continuation lines of the output data column;help
--listing-rhs-widthset the max width in characters of the lines from the source filehelp
--listing-cont-linesset the maximum number of continuation lines used for the output data column of the listinghelp
-kgenerate PIC codehelp
-mthumbassemble Thumb codehelp
-mthumb-interworksupport ARM/Thumb interworkinghelp
-mapcs-32code uses 32-bit program counterhelp
-mapcs-26code uses 26-bit program counterhelp
-mapcs-floatfloating point args are in fp regshelp
-mapcs-reentrantre-entrant codehelp
-matpcscode is ATPCS conformanthelp
-mbig-endianassemble for big-endianhelp
-mlittle-endianassemble for little-endianhelp
-mapcs-frameuse frame pointerhelp
-mapcs-stack-checkuse stack size checkinghelp
-mno-warn-deprecateddo not warn on use of deprecated featurehelp
-mwarn-restrict-itwarn about performance deprecated IT instructions in ARMv8-A and ARMv8-Rhelp
-mwarn-symswarn about symbols that match instruction names [default]help
-mno-warn-symsdisable warnings about symobls that match instructionshelp
-mcpu cpuassemble for CPU <cpu name>help
-march archassemble for architecture <arch name>help
-mfpu fpuassemble for FPU architecture <fpu name>help
-mfloat-abi abiassemble for floating point ABI <abi>help
-meabi verassemble for eabi version <ver>help
-mimplicit-it modecontrols implicit insertion of IT instructionshelp
-mccsTI CodeComposer Studio syntax compatibility modehelp
-mfp16-format ieee|alternativeset the encoding for half precision floating point numbers to IEEE or Arm alternative format.help
-EBassemble code for a big-endian cpuhelp
-ELassemble code for a little-endian cpuhelp
--fix-v4bxAllow BX in ARMv4 codehelp
--fdpicgenerate an FDPIC object filehelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.