开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 嵌入式/单片机编程 > 嵌入式Linux > 查看源码
arm-linux-as.1
资源名称：arm_cross-3.4.4.tar.gz　[点击查看]
上传用户：szlgq88
上传日期：2009-04-28
资源大小：48287k
文件大小：37k
源码类别：

嵌入式Linux

开发平台：

Unix_Linux

arm-linux-as.1：源码内容
  1. ." Automatically generated by Pod::Man v1.37, Pod::Parser v1.14
  2. ."
  3. ." Standard preamble:
  4. ." ========================================================================
  5. .de Sh " Subsection heading
  6. .br
  7. .if t .Sp
  8. .ne 5
  9. .PP
  10. fB\$1fR
  11. .PP
  12. ..
  13. .de Sp " Vertical space (when we can't use .PP)
  14. .if t .sp .5v
  15. .if n .sp
  16. ..
  17. .de Vb " Begin verbatim text
  18. .ft CW
  19. .nf
  20. .ne \$1
  21. ..
  22. .de Ve " End verbatim text
  23. .ft R
  24. .fi
  25. ..
  26. ." Set up some character translations and predefined strings.  *(-- will
  27. ." give an unbreakable dash, *(PI will give pi, *(L" will give a left
  28. ." double quote, and *(R" will give a right double quote.  | will give a
  29. ." real vertical bar.  *(C+ will give a nicer C++.  Capital omega is used to
  30. ." do unbreakable dashes and therefore won't be available.  *(C` and *(C'
  31. ." expand to `' in nroff, nothing in troff, for use with C<>.
  32. .tr (*W-|(bv*(Tr
  33. .ds C+ Cv'-.1v'h'-1p's-2+h'-1p'+s0v'.1v'h'-1p'
  34. .ie n {
  35. .    ds -- (*W-
  36. .    ds PI pi
  37. .    if (n(.H=4u)&(1m=24u) .ds -- (*Wh'-12u'(*Wh'-12u'-" diablo 10 pitch
  38. .    if (n(.H=4u)&(1m=20u) .ds -- (*Wh'-12u'(*Wh'-8u'-"  diablo 12 pitch
  39. .    ds L" ""
  40. .    ds R" ""
  41. .    ds C` ""
  42. .    ds C' ""
  43. 'br}
  44. .el{
  45. .    ds -- |(em|
  46. .    ds PI (*p
  47. .    ds L" ``
  48. .    ds R" ''
  49. 'br}
  50. ."
  51. ." If the F register is turned on, we'll generate index entries on stderr for
  52. ." titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
  53. ." entries marked with X<> in POD.  Of course, you'll have to process the
  54. ." output yourself in some meaningful fashion.
  55. .if nF {
  56. .    de IX
  57. .    tm Index:\$1t\n%t"\$2"
  58. ..
  59. .    nr % 0
  60. .    rr F
  61. .}
  62. ."
  63. ." For nroff, turn off justification.  Always turn off hyphenation; it makes
  64. ." way too many mistakes in technical documents.
  65. .hy 0
  66. ."
  67. ." Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  68. ." Fear.  Run.  Save yourself.  No user-serviceable parts.
  69. .    " fudge factors for nroff and troff
  70. .if n {
  71. .    ds #H 0
  72. .    ds #V .8m
  73. .    ds #F .3m
  74. .    ds #[ f1
  75. .    ds #] fP
  76. .}
  77. .if t {
  78. .    ds #H ((1u-(\\n(.fu%2u))*.13m)
  79. .    ds #V .6m
  80. .    ds #F 0
  81. .    ds #[ &
  82. .    ds #] &
  83. .}
  84. .    " simple accents for nroff and troff
  85. .if n {
  86. .    ds ' &
  87. .    ds ` &
  88. .    ds ^ &
  89. .    ds , &
  90. .    ds ~ ~
  91. .    ds /
  92. .}
  93. .if t {
  94. .    ds ' \k:h'-(\n(.wu*8/10-*(#H)''h"|\n:u"
  95. .    ds ` \k:h'-(\n(.wu*8/10-*(#H)'`h'|\n:u'
  96. .    ds ^ \k:h'-(\n(.wu*10/11-*(#H)'^h'|\n:u'
  97. .    ds , \k:h'-(\n(.wu*8/10)',h'|\n:u'
  98. .    ds ~ \k:h'-(\n(.wu-*(#H-.1m)'~h'|\n:u'
  99. .    ds / \k:h'-(\n(.wu*8/10-*(#H)'z(slh'|\n:u'
  100. .}
  101. .    " troff and (daisy-wheel) nroff accents
  102. .ds : \k:h'-(\n(.wu*8/10-*(#H+.1m+*(#F)'v'-*(#V'z.h'.2m+*(#F'.h'|\n:u'v'*(#V'
  103. .ds 8 h'*(#H'(*bh'-*(#H'
  104. .ds o \k:h'-(\n(.wu+w'(de'u-*(#H)/2u'v'-.3n'*(#[z(dev'.3n'h'|\n:u'*(#]
  105. .ds d- h'*(#H'(pdh'-w'~'u'v'-.25m'f2(hyfPv'.25m'h'-*(#H'
  106. .ds D- D\k:h'-w'D'u'v'-.11m'z(hyv'.11m'h'|\n:u'
  107. .ds th *(#[v'.3m's+1Is-1v'-.3m'h'-(w'I'u*2/3)'s-1os+1*(#]
  108. .ds Th *(#[s+2Is-2h'-w'I'u*3/5'v'-.3m'ov'.3m'*(#]
  109. .ds ae ah'-(w'a'u*4/10)'e
  110. .ds Ae Ah'-(w'A'u*4/10)'E
  111. .    " corrections for vroff
  112. .if v .ds ~ \k:h'-(\n(.wu*9/10-*(#H)'s-2u~ds+2h'|\n:u'
  113. .if v .ds ^ \k:h'-(\n(.wu*10/11-*(#H)'v'-.4m'^v'.4m'h'|\n:u'
  114. .    " for low resolution devices (crt and lpr)
  115. .if n(.H>23 .if n(.V>19 
  116. {
  117. .    ds : e
  118. .    ds 8 ss
  119. .    ds o a
  120. .    ds d- dh'-1'(ga
  121. .    ds D- Dh'-1'(hy
  122. .    ds th o'bp'
  123. .    ds Th o'LP'
  124. .    ds ae ae
  125. .    ds Ae AE
  126. .}
  127. .rm #[ #] #H #V #F C
  128. ." ========================================================================
  129. ."
  130. .IX Title "AS 1"
  131. .TH AS 1 "2005-05-02" "binutils-2.16" "GNU Development Tools"
  132. .SH "NAME"
  133. AS - the portable GNU assembler.
  134. .SH "SYNOPSIS"
  135. .IX Header "SYNOPSIS"
  136. as [fB-afR[fBcdhlnsfR][=fIfilefR]] [fB--alternatefR] [fB-DfR]
  137.  [fB--defsymfR fIsymfR=fIvalfR] [fB-ffR] [fB-gfR] [fB--gstabsfR] [fB--gstabs+fR]
  138.  [fB--gdwarf-2fR] [fB--helpfR] [fB-IfR fIdirfR] [fB-JfR] [fB-KfR] [fB-LfR]
  139.  [fB--listing-lhs-widthfR=fIs-1NUMs0fR] [fB--listing-lhs-width2fR=fIs-1NUMs0fR]
  140.  [fB--listing-rhs-widthfR=fIs-1NUMs0fR] [fB--listing-cont-linesfR=fIs-1NUMs0fR]
  141.  [fB--keep-localsfR] [fB-ofR fIobjfilefR] [fB-RfR] [fB--statisticsfR] [fB-vfR]
  142.  [fB-versionfR] [fB--versionfR] [fB-WfR] [fB--warnfR] [fB--fatal-warningsfR] 
  143.  [fB-wfR] [fB-xfR] [fB-ZfR] [fB--target-helpfR] [fItarget-optionsfR] 
  144.  [fB--fR|fIfilesfR ...]
  145. .PP
  146. &fITarget Alpha options:fR
  147.    [fB-mfRfIcpufR]
  148.    [fB-mdebugfR | fB-no-mdebugfR]
  149.    [fB-relaxfR] [fB-gfR] [fB-GfRfIsizefR]
  150.    [fB-FfR] [fB-32addrfR]
  151. .PP
  152. &fITarget s-1ARCs0 options:fR
  153.    [fB-marc[5|6|7|8]fR]
  154.    [fB-EBfR|fB-ELfR]
  155. .PP
  156. &fITarget s-1ARMs0 options:fR
  157.    [fB-mcpufR=fIprocessorfR[+fIextensionfR...]]
  158.    [fB-marchfR=fIarchitecturefR[+fIextensionfR...]]
  159.    [fB-mfpufR=fIfloating-point-formatfR]
  160.    [fB-mfloat-abifR=fIabifR]
  161.    [fB-meabifR=fIverfR]
  162.    [fB-mthumbfR]
  163.    [fB-EBfR|fB-ELfR]
  164.    [fB-mapcs-32fR|fB-mapcs-26fR|fB-mapcs-floatfR|
  165.     fB-mapcs-reentrantfR]
  166.    [fB-mthumb-interworkfR] [fB-kfR]
  167. .PP
  168. &fITarget s-1CRISs0 options:fR
  169.    [fB--underscorefR | fB--no-underscorefR]
  170.    [fB--picfR] [fB-NfR]
  171.    [fB--emulation=criselffR | fB--emulation=crisaoutfR]
  172.    [fB--march=v0_v10fR | fB--march=v10fR | fB--march=v32fR | fB--march=common_v10_v32fR]
  173. .PP
  174. &fITarget D10V options:fR
  175.    [fB-OfR]
  176. .PP
  177. &fITarget D30V options:fR
  178.    [fB-OfR|fB-nfR|fB-NfR]
  179. .PP
  180. &fITarget i386 options:fR
  181.    [fB--32fR|fB--64fR] [fB-nfR]
  182. .PP
  183. &fITarget i960 options:fR
  184.    [fB-ACAfR|fB-ACA_AfR|fB-ACBfR|fB-ACCfR|fB-AKAfR|fB-AKBfR|
  185.     fB-AKCfR|fB-AMCfR]
  186.    [fB-bfR] [fB-no-relaxfR]
  187. .PP
  188. &fITarget s-1IA-64s0 options:fR
  189.    [fB-mconstant-gpfR|fB-mauto-picfR]
  190.    [fB-milp32fR|fB-milp64fR|fB-mlp64fR|fB-mp64fR]
  191.    [fB-mlefR|fBmbefR]
  192.    [fB-munwind-check=warningfR|fB-munwind-check=errorfR]
  193.    [fB-mhint.b=okfR|fB-mhint.b=warningfR|fB-mhint.b=errorfR]
  194.    [fB-xfR|fB-xexplicitfR] [fB-xautofR] [fB-xdebugfR]
  195. .PP
  196. &fITarget s-1IP2Ks0 options:fR
  197.    [fB-mip2022fR|fB-mip2022extfR]
  198. .PP
  199. &fITarget M32R options:fR
  200.    [fB--m32rxfR|fB--[no-]warn-explicit-parallel-conflictsfR|
  201.    fB--W[n]pfR]
  202. .PP
  203. &fITarget M680X0 options:fR
  204.    [fB-lfR] [fB-m68000fR|fB-m68010fR|fB-m68020fR|...]
  205. .PP
  206. &fITarget M68HC11 options:fR
  207.    [fB-m68hc11fR|fB-m68hc12fR|fB-m68hcs12fR]
  208.    [fB-mshortfR|fB-mlongfR]
  209.    [fB-mshort-doublefR|fB-mlong-doublefR]
  210.    [fB--force-long-branchsfR] [fB--short-branchsfR]
  211.    [fB--strict-direct-modefR] [fB--print-insn-syntaxfR]
  212.    [fB--print-opcodesfR] [fB--generate-examplefR]
  213. .PP
  214. &fITarget s-1MCOREs0 options:fR
  215.    [fB-jsri2bsrfR] [fB-sifilterfR] [fB-relaxfR]
  216.    [fB-mcpu=[210|340]fR]
  217. .PP
  218. &fITarget s-1MIPSs0 options:fR
  219.    [fB-nocppfR] [fB-ELfR] [fB-EBfR] [fB-OfR[fIoptimization levelfR]]
  220.    [fB-gfR[fIdebug levelfR]] [fB-GfR fInumfR] [fB-KPICfR] [fB-call_sharedfR]
  221.    [fB-non_sharedfR] [fB-xgotfR]
  222.    [fB-mabifR=fIs-1ABIs0fR] [fB-32fR] [fB-n32fR] [fB-64fR] [fB-mfp32fR] [fB-mgp32fR]
  223.    [fB-marchfR=fIs-1CPUs0fR] [fB-mtunefR=fIs-1CPUs0fR] [fB-mips1fR] [fB-mips2fR]
  224.    [fB-mips3fR] [fB-mips4fR] [fB-mips5fR] [fB-mips32fR] [fB-mips32r2fR]
  225.    [fB-mips64fR] [fB-mips64r2fR]
  226.    [fB-construct-floatsfR] [fB-no-construct-floatsfR]
  227.    [fB-trapfR] [fB-no-breakfR] [fB-breakfR] [fB-no-trapfR]
  228.    [fB-mfix7000fR] [fB-mno-fix7000fR]
  229.    [fB-mips16fR] [fB-no-mips16fR]
  230.    [fB-mips3dfR] [fB-no-mips3dfR]
  231.    [fB-mdmxfR] [fB-no-mdmxfR]
  232.    [fB-mdebugfR] [fB-no-mdebugfR]
  233.    [fB-mpdrfR] [fB-mno-pdrfR]
  234. .PP
  235. &fITarget s-1MMIXs0 options:fR
  236.    [fB--fixed-special-register-namesfR] [fB--globalize-symbolsfR]
  237.    [fB--gnu-syntaxfR] [fB--relaxfR] [fB--no-predefined-symbolsfR]
  238.    [fB--no-expandfR] [fB--no-merge-gregsfR] [fB-xfR]
  239.    [fB--linker-allocated-gregsfR]
  240. .PP
  241. &fITarget s-1PDP11s0 options:fR
  242.    [fB-mpicfR|fB-mno-picfR] [fB-mallfR] [fB-mno-extensionsfR]
  243.    [fB-mfRfIextensionfR|fB-mno-fRfIextensionfR]
  244.    [fB-mfRfIcpufR] [fB-mfRfImachinefR]  
  245. .PP
  246. &fITarget picoJava options:fR
  247.    [fB-mbfR|fB-mefR]
  248. .PP
  249. &fITarget PowerPC options:fR
  250.    [fB-mpwrxfR|fB-mpwr2fR|fB-mpwrfR|fB-m601fR|fB-mppcfR|fB-mppc32fR|fB-m603fR|fB-m604fR|
  251.     fB-m403fR|fB-m405fR|fB-mppc64fR|fB-m620fR|fB-mppc64bridgefR|fB-mbookefR|
  252.     fB-mbooke32fR|fB-mbooke64fR]
  253.    [fB-mcomfR|fB-manyfR|fB-maltivecfR] [fB-membfR]
  254.    [fB-mregnamesfR|fB-mno-regnamesfR]
  255.    [fB-mrelocatablefR|fB-mrelocatable-libfR]
  256.    [fB-mlittlefR|fB-mlittle-endianfR|fB-mbigfR|fB-mbig-endianfR]
  257.    [fB-msolarisfR|fB-mno-solarisfR]
  258. .PP
  259. &fITarget s-1SPARCs0 options:fR
  260.    [fB-Av6fR|fB-Av7fR|fB-Av8fR|fB-AsparcletfR|fB-AsparclitefR
  261.     fB-Av8plusfR|fB-Av8plusafR|fB-Av9fR|fB-Av9afR]
  262.    [fB-xarch=v8plusfR|fB-xarch=v8plusafR] [fB-bumpfR]
  263.    [fB-32fR|fB-64fR]
  264. .PP
  265. &fITarget s-1TIC54Xs0 options:fR
  266.  [fB-mcpu=54[123589]fR|fB-mcpu=54[56]lpfR] [fB-mfar-modefR|fB-mffR] 
  267.  [fB-merrors-to-filefR fI<filename>fR|fB-mefR fI<filename>fR]
  268. .PP
  269. &fITarget Xtensa options:fR
  270.  [fB--[no-]text-section-literalsfR] [fB--[no-]absolute-literalsfR]
  271.  [fB--[no-]target-alignfR] [fB--[no-]longcallsfR]
  272.  [fB--[no-]transformfR]
  273.  [fB--rename-sectionfR fIoldnamefR=fInewnamefR]
  274. .SH "DESCRIPTION"
  275. .IX Header "DESCRIPTION"
  276. &s-1GNUs0 fBasfR is really a family of assemblers.
  277. If you use (or have used) the s-1GNUs0 assembler on one architecture, you
  278. should find a fairly similar environment when you use it on another
  279. architecture.  Each version has much in common with the others,
  280. including object file formats, most assembler directives (often called
  281. &fIpseudo-opsfR) and assembler syntax.
  282. .PP
  283. &fBasfR is primarily intended to assemble the output of the
  284. &s-1GNUs0 C compiler f(CW*(C`gcc*(C'fR for use by the linker
  285. &f(CW*(C`ld*(C'fR.  Nevertheless, we've tried to make fBasfR
  286. assemble correctly everything that other assemblers for the same
  287. machine would assemble.
  288. Any exceptions are documented explicitly.
  289. This doesn't mean fBasfR always uses the same syntax as another
  290. assembler for the same architecture; for example, we know of several
  291. incompatible versions of 680x0 assembly language syntax.
  292. .PP
  293. Each time you run fBasfR it assembles exactly one source
  294. program.  The source program is made up of one or more files.
  295. (The standard input is also a file.)
  296. .PP
  297. You give fBasfR a command line that has zero or more input file
  298. names.  The input files are read (from left file name to right).  A
  299. command line argument (in any position) that has no special meaning
  300. is taken to be an input file name.
  301. .PP
  302. If you give fBasfR no file names it attempts to read one input file
  303. from the fBasfR standard input, which is normally your terminal.  You
  304. may have to type fBctl-DfR to tell fBasfR there is no more program
  305. to assemble.
  306. .PP
  307. Use fB--fR if you need to explicitly name the standard input file
  308. in your command line.
  309. .PP
  310. If the source is empty, fBasfR produces a small, empty object
  311. file.
  312. .PP
  313. &fBasfR may write warnings and error messages to the standard error
  314. file (usually your terminal).  This should not happen when  a compiler
  315. runs fBasfR automatically.  Warnings report an assumption made so
  316. that fBasfR could keep assembling a flawed program; errors report a
  317. grave problem that stops the assembly.
  318. .PP
  319. If you are invoking fBasfR via the s-1GNUs0 C compiler,
  320. you can use the fB-WafR option to pass arguments through to the assembler.
  321. The assembler arguments must be separated from each other (and the fB-WafR)
  322. by commas.  For example:
  323. .PP
  324. .Vb 1
  325. &        gcc -c -g -O -Wa,-alh,-L file.c
  326. .Ve
  327. .PP
  328. This passes two options to the assembler: fB-alhfR (emit a listing to
  329. standard output with high-level and assembly source) and fB-LfR (retain
  330. local symbols in the symbol table).
  331. .PP
  332. Usually you do not need to use this fB-WafR mechanism, since many compiler
  333. command-line options are automatically passed to the assembler by the compiler.
  334. (You can call the s-1GNUs0 compiler driver with the fB-vfR option to see
  335. precisely what options it passes to each compilation pass, including the
  336. assembler.)
  337. .SH "OPTIONS"
  338. .IX Header "OPTIONS"
  339. .IP "fB-a[cdhlmns]fR" 4
  340. .IX Item "-a[cdhlmns]"
  341. Turn on listings, in any of a variety of ways:
  342. .RS 4
  343. .IP "fB-acfR" 4
  344. .IX Item "-ac"
  345. omit false conditionals
  346. .IP "fB-adfR" 4
  347. .IX Item "-ad"
  348. omit debugging directives
  349. .IP "fB-ahfR" 4
  350. .IX Item "-ah"
  351. include high-level source
  352. .IP "fB-alfR" 4
  353. .IX Item "-al"
  354. include assembly
  355. .IP "fB-amfR" 4
  356. .IX Item "-am"
  357. include macro expansions
  358. .IP "fB-anfR" 4
  359. .IX Item "-an"
  360. omit forms processing
  361. .IP "fB-asfR" 4
  362. .IX Item "-as"
  363. include symbols
  364. .IP "fB=filefR" 4
  365. .IX Item "=file"
  366. set the name of the listing file
  367. .RE
  368. .RS 4
  369. .Sp
  370. You may combine these options; for example, use fB-alnfR for assembly
  371. listing without forms processing.  The fB=filefR option, if used, must be
  372. the last one.  By itself, fB-afR defaults to fB-ahlsfR.
  373. .RE
  374. .IP "fB--alternatefR" 4
  375. .IX Item "--alternate"
  376. Begin in alternate macro mode, see f(CW@reffR{Altmacro,,f(CW*(C`.altmacro*(C'fR}.
  377. .IP "fB-DfR" 4
  378. .IX Item "-D"
  379. Ignored.  This option is accepted for script compatibility with calls to
  380. other assemblers.
  381. .IP "fB--defsymfR fIsymfRfB=fRfIvaluefR" 4
  382. .IX Item "--defsym sym=value"
  383. Define the symbol fIsymfR to be fIvaluefR before assembling the input file.
  384. &fIvaluefR must be an integer constant.  As in C, a leading fB0xfR
  385. indicates a hexadecimal value, and a leading fB0fR indicates an octal value.
  386. .IP "fB-ffR" 4
  387. .IX Item "-f"
  388. ``fast''---skip whitespace and comment preprocessing (assume source is
  389. compiler output).
  390. .IP "fB-gfR" 4
  391. .IX Item "-g"
  392. .PD 0
  393. .IP "fB--gen-debugfR" 4
  394. .IX Item "--gen-debug"
  395. .PD
  396. Generate debugging information for each assembler source line using whichever
  397. debug format is preferred by the target.  This currently means either s-1STABSs0,
  398. &s-1ECOFFs0 or s-1DWARF2s0.
  399. .IP "fB--gstabsfR" 4
  400. .IX Item "--gstabs"
  401. Generate stabs debugging information for each assembler line.  This
  402. may help debugging assembler code, if the debugger can handle it.
  403. .IP "fB--gstabs+fR" 4
  404. .IX Item "--gstabs+"
  405. Generate stabs debugging information for each assembler line, with s-1GNUs0
  406. extensions that probably only gdb can handle, and that could make other
  407. debuggers crash or refuse to read your program.  This
  408. may help debugging assembler code.  Currently the only s-1GNUs0 extension is
  409. the location of the current working directory at assembling time.
  410. .IP "fB--gdwarf-2fR" 4
  411. .IX Item "--gdwarf-2"
  412. Generate s-1DWARF2s0 debugging information for each assembler line.  This
  413. may help debugging assembler code, if the debugger can handle it.  Note---this
  414. option is only supported by some targets, not all of them.
  415. .IP "fB--helpfR" 4
  416. .IX Item "--help"
  417. Print a summary of the command line options and exit.
  418. .IP "fB--target-helpfR" 4
  419. .IX Item "--target-help"
  420. Print a summary of all target specific options and exit.
  421. .IP "fB-IfR fIdirfR" 4
  422. .IX Item "-I dir"
  423. Add directory fIdirfR to the search list for f(CW*(C`.include*(C'fR directives.
  424. .IP "fB-JfR" 4
  425. .IX Item "-J"
  426. Don't warn about signed overflow.
  427. .IP "fB-KfR" 4
  428. .IX Item "-K"
  429. Issue warnings when difference tables altered for long displacements.
  430. .IP "fB-LfR" 4
  431. .IX Item "-L"
  432. .PD 0
  433. .IP "fB--keep-localsfR" 4
  434. .IX Item "--keep-locals"
  435. .PD
  436. Keep (in the symbol table) local symbols.  On traditional a.out systems
  437. these start with fBLfR, but different systems have different local
  438. label prefixes.
  439. .IP "fB--listing-lhs-width=fRfInumberfR" 4
  440. .IX Item "--listing-lhs-width=number"
  441. Set the maximum width, in words, of the output data column for an assembler
  442. listing to fInumberfR.
  443. .IP "fB--listing-lhs-width2=fRfInumberfR" 4
  444. .IX Item "--listing-lhs-width2=number"
  445. Set the maximum width, in words, of the output data column for continuation
  446. lines in an assembler listing to fInumberfR.
  447. .IP "fB--listing-rhs-width=fRfInumberfR" 4
  448. .IX Item "--listing-rhs-width=number"
  449. Set the maximum width of an input source line, as displayed in a listing, to
  450. &fInumberfR bytes.
  451. .IP "fB--listing-cont-lines=fRfInumberfR" 4
  452. .IX Item "--listing-cont-lines=number"
  453. Set the maximum number of lines printed in a listing for a single line of input
  454. to fInumberfR + 1.
  455. .IP "fB-ofR fIobjfilefR" 4
  456. .IX Item "-o objfile"
  457. Name the object-file output from fBasfR fIobjfilefR.
  458. .IP "fB-RfR" 4
  459. .IX Item "-R"
  460. Fold the data section into the text section.
  461. .IP "fB--statisticsfR" 4
  462. .IX Item "--statistics"
  463. Print the maximum space (in bytes) and total time (in seconds) used by
  464. assembly.
  465. .IP "fB--strip-local-absolutefR" 4
  466. .IX Item "--strip-local-absolute"
  467. Remove local absolute symbols from the outgoing symbol table.
  468. .IP "fB-vfR" 4
  469. .IX Item "-v"
  470. .PD 0
  471. .IP "fB-versionfR" 4
  472. .IX Item "-version"
  473. .PD
  474. Print the fBasfR version.
  475. .IP "fB--versionfR" 4
  476. .IX Item "--version"
  477. Print the fBasfR version and exit.
  478. .IP "fB-WfR" 4
  479. .IX Item "-W"
  480. .PD 0
  481. .IP "fB--no-warnfR" 4
  482. .IX Item "--no-warn"
  483. .PD
  484. Suppress warning messages.
  485. .IP "fB--fatal-warningsfR" 4
  486. .IX Item "--fatal-warnings"
  487. Treat warnings as errors.
  488. .IP "fB--warnfR" 4
  489. .IX Item "--warn"
  490. Don't suppress warning messages or treat them as errors.
  491. .IP "fB-wfR" 4
  492. .IX Item "-w"
  493. Ignored.
  494. .IP "fB-xfR" 4
  495. .IX Item "-x"
  496. Ignored.
  497. .IP "fB-ZfR" 4
  498. .IX Item "-Z"
  499. Generate an object file even after errors.
  500. .IP "fB-- |fR fIfilesfR fB...fR" 4
  501. .IX Item "-- | files ..."
  502. Standard input, or source files to assemble.
  503. .PP
  504. The following options are available when as is configured for
  505. an s-1ARCs0 processor.
  506. .IP "fB-marc[5|6|7|8]fR" 4
  507. .IX Item "-marc[5|6|7|8]"
  508. This option selects the core processor variant.
  509. .IP "fB-EB | -ELfR" 4
  510. .IX Item "-EB | -EL"
  511. Select either big-endian (-EB) or little-endian (-EL) output.
  512. .PP
  513. The following options are available when as is configured for the s-1ARMs0
  514. processor family.
  515. .IP "fB-mcpu=fRfIprocessorfRfB[+fRfIextensionfRfB...]fR" 4
  516. .IX Item "-mcpu=processor[+extension...]"
  517. Specify which s-1ARMs0 processor variant is the target.
  518. .IP "fB-march=fRfIarchitecturefRfB[+fRfIextensionfRfB...]fR" 4
  519. .IX Item "-march=architecture[+extension...]"
  520. Specify which s-1ARMs0 architecture variant is used by the target.
  521. .IP "fB-mfpu=fRfIfloating-point-formatfR" 4
  522. .IX Item "-mfpu=floating-point-format"
  523. Select which Floating Point architecture is the target.
  524. .IP "fB-mfloat-abi=fRfIabifR" 4
  525. .IX Item "-mfloat-abi=abi"
  526. Select which floating point s-1ABIs0 is in use.
  527. .IP "fB-mthumbfR" 4
  528. .IX Item "-mthumb"
  529. Enable Thumb only instruction decoding.
  530. .IP "fB-mapcs-32 | -mapcs-26 | -mapcs-float | -mapcs-reentrantfR" 4
  531. .IX Item "-mapcs-32 | -mapcs-26 | -mapcs-float | -mapcs-reentrant"
  532. Select which procedure calling convention is in use.
  533. .IP "fB-EB | -ELfR" 4
  534. .IX Item "-EB | -EL"
  535. Select either big-endian (-EB) or little-endian (-EL) output.
  536. .IP "fB-mthumb-interworkfR" 4
  537. .IX Item "-mthumb-interwork"
  538. Specify that the code has been generated with interworking between Thumb and
  539. &s-1ARMs0 code in mind.
  540. .IP "fB-kfR" 4
  541. .IX Item "-k"
  542. Specify that s-1PICs0 code has been generated.
  543. .PP
  544. See the info pages for documentation of the CRIS-specific options.
  545. .PP
  546. The following options are available when as is configured for
  547. a D10V processor.
  548. .IP "fB-OfR" 4
  549. .IX Item "-O"
  550. Optimize output by parallelizing instructions.
  551. .PP
  552. The following options are available when as is configured for a D30V
  553. processor.
  554. .IP "fB-OfR" 4
  555. .IX Item "-O"
  556. Optimize output by parallelizing instructions.
  557. .IP "fB-nfR" 4
  558. .IX Item "-n"
  559. Warn when nops are generated.
  560. .IP "fB-NfR" 4
  561. .IX Item "-N"
  562. Warn when a nop after a 32-bit multiply instruction is generated.
  563. .PP
  564. The following options are available when as is configured for the
  565. Intel 80960 processor.
  566. .IP "fB-ACA | -ACA_A | -ACB | -ACC | -AKA | -AKB | -AKC | -AMCfR" 4
  567. .IX Item "-ACA | -ACA_A | -ACB | -ACC | -AKA | -AKB | -AKC | -AMC"
  568. Specify which variant of the 960 architecture is the target.
  569. .IP "fB-bfR" 4
  570. .IX Item "-b"
  571. Add code to collect statistics about branches taken.
  572. .IP "fB-no-relaxfR" 4
  573. .IX Item "-no-relax"
  574. Do not alter compare-and-branch instructions for long displacements;
  575. error if necessary.
  576. .PP
  577. The following options are available when as is configured for the
  578. Ubicom s-1IP2Ks0 series.
  579. .IP "fB-mip2022extfR" 4
  580. .IX Item "-mip2022ext"
  581. Specifies that the extended s-1IP2022s0 instructions are allowed.
  582. .IP "fB-mip2022fR" 4
  583. .IX Item "-mip2022"
  584. Restores the default behaviour, which restricts the permitted instructions to
  585. just the basic s-1IP2022s0 ones.
  586. .PP
  587. The following options are available when as is configured for the
  588. Renesas M32R (formerly Mitsubishi M32R) series.
  589. .IP "fB--m32rxfR" 4
  590. .IX Item "--m32rx"
  591. Specify which processor in the M32R family is the target.  The default
  592. is normally the M32R, but this option changes it to the M32RX.
  593. .IP "fB--warn-explicit-parallel-conflicts or --WpfR" 4
  594. .IX Item "--warn-explicit-parallel-conflicts or --Wp"
  595. Produce warning messages when questionable parallel constructs are
  596. encountered. 
  597. .IP "fB--no-warn-explicit-parallel-conflicts or --WnpfR" 4
  598. .IX Item "--no-warn-explicit-parallel-conflicts or --Wnp"
  599. Do not produce warning messages when questionable parallel constructs are 
  600. encountered. 
  601. .PP
  602. The following options are available when as is configured for the
  603. Motorola 68000 series.
  604. .IP "fB-lfR" 4
  605. .IX Item "-l"
  606. Shorten references to undefined symbols, to one word instead of two.
  607. .IP "fB-m68000 | -m68008 | -m68010 | -m68020 | -m68030fR" 4
  608. .IX Item "-m68000 | -m68008 | -m68010 | -m68020 | -m68030"
  609. .PD 0
  610. .IP "fB| -m68040 | -m68060 | -m68302 | -m68331 | -m68332fR" 4
  611. .IX Item "| -m68040 | -m68060 | -m68302 | -m68331 | -m68332"
  612. .IP "fB| -m68333 | -m68340 | -mcpu32 | -m5200fR" 4
  613. .IX Item "| -m68333 | -m68340 | -mcpu32 | -m5200"
  614. .PD
  615. Specify what processor in the 68000 family is the target.  The default
  616. is normally the 68020, but this can be changed at configuration time.
  617. .IP "fB-m68881 | -m68882 | -mno-68881 | -mno-68882fR" 4
  618. .IX Item "-m68881 | -m68882 | -mno-68881 | -mno-68882"
  619. The target machine does (or does not) have a floating-point coprocessor.
  620. The default is to assume a coprocessor for 68020, 68030, and cpu32.  Although
  621. the basic 68000 is not compatible with the 68881, a combination of the
  622. two can be specified, since it's possible to do emulation of the
  623. coprocessor instructions with the main processor.
  624. .IP "fB-m68851 | -mno-68851fR" 4
  625. .IX Item "-m68851 | -mno-68851"
  626. The target machine does (or does not) have a memory-management
  627. unit coprocessor.  The default is to assume an s-1MMUs0 for 68020 and up.
  628. .PP
  629. For details about the s-1PDP-11s0 machine dependent features options,
  630. see f(CW@reffR{PDP-11-Options}.
  631. .IP "fB-mpic | -mno-picfR" 4
  632. .IX Item "-mpic | -mno-pic"
  633. Generate position-independent (or position-dependent) code.  The
  634. default is fB-mpicfR.
  635. .IP "fB-mallfR" 4
  636. .IX Item "-mall"
  637. .PD 0
  638. .IP "fB-mall-extensionsfR" 4
  639. .IX Item "-mall-extensions"
  640. .PD
  641. Enable all instruction set extensions.  This is the default.
  642. .IP "fB-mno-extensionsfR" 4
  643. .IX Item "-mno-extensions"
  644. Disable all instruction set extensions.
  645. .IP "fB-mfRfIextensionfR fB| -mno-fRfIextensionfR" 4
  646. .IX Item "-mextension | -mno-extension"
  647. Enable (or disable) a particular instruction set extension.
  648. .IP "fB-mfRfIcpufR" 4
  649. .IX Item "-mcpu"
  650. Enable the instruction set extensions supported by a particular s-1CPUs0, and
  651. disable all other extensions.
  652. .IP "fB-mfRfImachinefR" 4
  653. .IX Item "-mmachine"
  654. Enable the instruction set extensions supported by a particular machine
  655. model, and disable all other extensions.
  656. .PP
  657. The following options are available when as is configured for
  658. a picoJava processor.
  659. .IP "fB-mbfR" 4
  660. .IX Item "-mb"
  661. Generate ``big endian'' format output.
  662. .IP "fB-mlfR" 4
  663. .IX Item "-ml"
  664. Generate ``little endian'' format output.
  665. .PP
  666. The following options are available when as is configured for the
  667. Motorola 68HC11 or 68HC12 series.
  668. .IP "fB-m68hc11 | -m68hc12 | -m68hcs12fR" 4
  669. .IX Item "-m68hc11 | -m68hc12 | -m68hcs12"
  670. Specify what processor is the target.  The default is
  671. defined by the configuration option when building the assembler.
  672. .IP "fB-mshortfR" 4
  673. .IX Item "-mshort"
  674. Specify to use the 16-bit integer s-1ABIs0.
  675. .IP "fB-mlongfR" 4
  676. .IX Item "-mlong"
  677. Specify to use the 32-bit integer s-1ABIs0.  
  678. .IP "fB-mshort-doublefR" 4
  679. .IX Item "-mshort-double"
  680. Specify to use the 32-bit double s-1ABIs0.  
  681. .IP "fB-mlong-doublefR" 4
  682. .IX Item "-mlong-double"
  683. Specify to use the 64-bit double s-1ABIs0.  
  684. .IP "fB--force-long-branchsfR" 4
  685. .IX Item "--force-long-branchs"
  686. Relative branches are turned into absolute ones. This concerns
  687. conditional branches, unconditional branches and branches to a
  688. sub routine.
  689. .IP "fB-S | --short-branchsfR" 4
  690. .IX Item "-S | --short-branchs"
  691. Do not turn relative branchs into absolute ones
  692. when the offset is out of range.
  693. .IP "fB--strict-direct-modefR" 4
  694. .IX Item "--strict-direct-mode"
  695. Do not turn the direct addressing mode into extended addressing mode
  696. when the instruction does not support direct addressing mode.
  697. .IP "fB--print-insn-syntaxfR" 4
  698. .IX Item "--print-insn-syntax"
  699. Print the syntax of instruction in case of error.
  700. .IP "fB--print-opcodesfR" 4
  701. .IX Item "--print-opcodes"
  702. print the list of instructions with syntax and then exit.
  703. .IP "fB--generate-examplefR" 4
  704. .IX Item "--generate-example"
  705. print an example of instruction for each possible instruction and then exit.
  706. This option is only useful for testing fBasfR.
  707. .PP
  708. The following options are available when fBasfR is configured
  709. for the s-1SPARCs0 architecture:
  710. .IP "fB-Av6 | -Av7 | -Av8 | -Asparclet | -AsparclitefR" 4
  711. .IX Item "-Av6 | -Av7 | -Av8 | -Asparclet | -Asparclite"
  712. .PD 0
  713. .IP "fB-Av8plus | -Av8plusa | -Av9 | -Av9afR" 4
  714. .IX Item "-Av8plus | -Av8plusa | -Av9 | -Av9a"
  715. .PD
  716. Explicitly select a variant of the s-1SPARCs0 architecture.
  717. .Sp
  718. &fB-Av8plusfR and fB-Av8plusafR select a 32 bit environment.
  719. &fB-Av9fR and fB-Av9afR select a 64 bit environment.
  720. .Sp
  721. &fB-Av8plusafR and fB-Av9afR enable the s-1SPARCs0 V9 instruction set with
  722. UltraSPARC extensions.
  723. .IP "fB-xarch=v8plus | -xarch=v8plusafR" 4
  724. .IX Item "-xarch=v8plus | -xarch=v8plusa"
  725. For compatibility with the Solaris v9 assembler.  These options are
  726. equivalent to -Av8plus and -Av8plusa, respectively.
  727. .IP "fB-bumpfR" 4
  728. .IX Item "-bump"
  729. Warn when the assembler switches to another architecture.
  730. .PP
  731. The following options are available when as is configured for the 'c54x
  732. architecture. 
  733. .IP "fB-mfar-modefR" 4
  734. .IX Item "-mfar-mode"
  735. Enable extended addressing mode.  All addresses and relocations will assume
  736. extended addressing (usually 23 bits).
  737. .IP "fB-mcpu=fRfIs-1CPU_VERSIONs0fR" 4
  738. .IX Item "-mcpu=CPU_VERSION"
  739. Sets the s-1CPUs0 version being compiled for.
  740. .IP "fB-merrors-to-filefR fIs-1FILENAMEs0fR" 4
  741. .IX Item "-merrors-to-file FILENAME"
  742. Redirect error output to a file, for broken systems which don't support such
  743. behaviour in the shell.
  744. .PP
  745. The following options are available when as is configured for
  746. a s-1MIPSs0 processor.
  747. .IP "fB-GfR fInumfR" 4
  748. .IX Item "-G num"
  749. This option sets the largest size of an object that can be referenced
  750. implicitly with the f(CW*(C`gp*(C'fR register.  It is only accepted for targets that
  751. use s-1ECOFFs0 format, such as a DECstation running Ultrix.  The default value is 8.
  752. .IP "fB-EBfR" 4
  753. .IX Item "-EB"
  754. Generate ``big endian'' format output.
  755. .IP "fB-ELfR" 4
  756. .IX Item "-EL"
  757. Generate ``little endian'' format output.
  758. .IP "fB-mips1fR" 4
  759. .IX Item "-mips1"
  760. .PD 0
  761. .IP "fB-mips2fR" 4
  762. .IX Item "-mips2"
  763. .IP "fB-mips3fR" 4
  764. .IX Item "-mips3"
  765. .IP "fB-mips4fR" 4
  766. .IX Item "-mips4"
  767. .IP "fB-mips5fR" 4
  768. .IX Item "-mips5"
  769. .IP "fB-mips32fR" 4
  770. .IX Item "-mips32"
  771. .IP "fB-mips32r2fR" 4
  772. .IX Item "-mips32r2"
  773. .IP "fB-mips64fR" 4
  774. .IX Item "-mips64"
  775. .IP "fB-mips64r2fR" 4
  776. .IX Item "-mips64r2"
  777. .PD
  778. Generate code for a particular s-1MIPSs0 Instruction Set Architecture level.
  779. &fB-mips1fR is an alias for fB-march=r3000fR, fB-mips2fR is an
  780. alias for fB-march=r6000fR, fB-mips3fR is an alias for
  781. &fB-march=r4000fR and fB-mips4fR is an alias for fB-march=r8000fR.
  782. &fB-mips5fR, fB-mips32fR, fB-mips32r2fR, fB-mips64fR, and
  783. &fB-mips64r2fR
  784. correspond to generic
  785. &fBs-1MIPSs0 VfR, fBs-1MIPS32s0fR, fBs-1MIPS32s0 Release 2fR, fBs-1MIPS64s0fR,
  786. and fBs-1MIPS64s0 Release 2fR
  787. &s-1ISAs0 processors, respectively.
  788. .IP "fB-march=fRfIs-1CPUs0fR" 4
  789. .IX Item "-march=CPU"
  790. Generate code for a particular s-1MIPSs0 cpu.
  791. .IP "fB-mtune=fRfIcpufR" 4
  792. .IX Item "-mtune=cpu"
  793. Schedule and tune for a particular s-1MIPSs0 cpu.
  794. .IP "fB-mfix7000fR" 4
  795. .IX Item "-mfix7000"
  796. .PD 0
  797. .IP "fB-mno-fix7000fR" 4
  798. .IX Item "-mno-fix7000"
  799. .PD
  800. Cause nops to be inserted if the read of the destination register
  801. of an mfhi or mflo instruction occurs in the following two instructions.
  802. .IP "fB-mdebugfR" 4
  803. .IX Item "-mdebug"
  804. .PD 0
  805. .IP "fB-no-mdebugfR" 4
  806. .IX Item "-no-mdebug"
  807. .PD
  808. Cause stabs-style debugging output to go into an ECOFF-style .mdebug
  809. section instead of the standard s-1ELFs0 .stabs sections.
  810. .IP "fB-mpdrfR" 4
  811. .IX Item "-mpdr"
  812. .PD 0
  813. .IP "fB-mno-pdrfR" 4
  814. .IX Item "-mno-pdr"
  815. .PD
  816. Control generation of f(CW*(C`.pdr*(C'fR sections.
  817. .IP "fB-mgp32fR" 4
  818. .IX Item "-mgp32"
  819. .PD 0
  820. .IP "fB-mfp32fR" 4
  821. .IX Item "-mfp32"
  822. .PD
  823. The register sizes are normally inferred from the s-1ISAs0 and s-1ABIs0, but these
  824. flags force a certain group of registers to be treated as 32 bits wide at
  825. all times.  fB-mgp32fR controls the size of general-purpose registers
  826. and fB-mfp32fR controls the size of floating-point registers.
  827. .IP "fB-mips16fR" 4
  828. .IX Item "-mips16"
  829. .PD 0
  830. .IP "fB-no-mips16fR" 4
  831. .IX Item "-no-mips16"
  832. .PD
  833. Generate code for the s-1MIPSs0 16 processor.  This is equivalent to putting
  834. &f(CW*(C`.set mips16*(C'fR at the start of the assembly file.  fB-no-mips16fR
  835. turns off this option.
  836. .IP "fB-mips3dfR" 4
  837. .IX Item "-mips3d"
  838. .PD 0
  839. .IP "fB-no-mips3dfR" 4
  840. .IX Item "-no-mips3d"
  841. .PD
  842. Generate code for the s-1MIPS-3Ds0 Application Specific Extension.
  843. This tells the assembler to accept s-1MIPS-3Ds0 instructions.
  844. &fB-no-mips3dfR turns off this option.
  845. .IP "fB-mdmxfR" 4
  846. .IX Item "-mdmx"
  847. .PD 0
  848. .IP "fB-no-mdmxfR" 4
  849. .IX Item "-no-mdmx"
  850. .PD
  851. Generate code for the s-1MDMXs0 Application Specific Extension.
  852. This tells the assembler to accept s-1MDMXs0 instructions.
  853. &fB-no-mdmxfR turns off this option.
  854. .IP "fB--construct-floatsfR" 4
  855. .IX Item "--construct-floats"
  856. .PD 0
  857. .IP "fB--no-construct-floatsfR" 4
  858. .IX Item "--no-construct-floats"
  859. .PD
  860. The fB--no-construct-floatsfR option disables the construction of
  861. double width floating point constants by loading the two halves of the
  862. value into the two single width floating point registers that make up
  863. the double width register.  By default fB--construct-floatsfR is
  864. selected, allowing construction of these floating point constants.
  865. .IP "fB--emulation=fRfInamefR" 4
  866. .IX Item "--emulation=name"
  867. This option causes fBasfR to emulate fBasfR configured
  868. for some other target, in all respects, including output format (choosing
  869. between s-1ELFs0 and s-1ECOFFs0 only), handling of pseudo-opcodes which may generate
  870. debugging information or store symbol table information, and default
  871. endianness.  The available configuration names are: fBmipsecofffR,
  872. &fBmipselffR, fBmipslecofffR, fBmipsbecofffR, fBmipslelffR,
  873. &fBmipsbelffR.  The first two do not alter the default endianness from that
  874. of the primary target for which the assembler was configured; the others change
  875. the default to little- or big-endian as indicated by the fBbfR or fBlfR
  876. in the name.  Using fB-EBfR or fB-ELfR will override the endianness
  877. selection in any case.
  878. .Sp
  879. This option is currently supported only when the primary target
  880. &fBasfR is configured for is a s-1MIPSs0 s-1ELFs0 or s-1ECOFFs0 target.
  881. Furthermore, the primary target or others specified with
  882. &fB--enable-targets=...fR at configuration time must include support for
  883. the other format, if both are to be available.  For example, the Irix 5
  884. configuration includes support for both.
  885. .Sp
  886. Eventually, this option will support more configurations, with more
  887. fine-grained control over the assembler's behavior, and will be supported for
  888. more processors.
  889. .IP "fB-nocppfR" 4
  890. .IX Item "-nocpp"
  891. &fBasfR ignores this option.  It is accepted for compatibility with
  892. the native tools.
  893. .IP "fB--trapfR" 4
  894. .IX Item "--trap"
  895. .PD 0
  896. .IP "fB--no-trapfR" 4
  897. .IX Item "--no-trap"
  898. .IP "fB--breakfR" 4
  899. .IX Item "--break"
  900. .IP "fB--no-breakfR" 4
  901. .IX Item "--no-break"
  902. .PD
  903. Control how to deal with multiplication overflow and division by zero.
  904. &fB--trapfR or fB--no-breakfR (which are synonyms) take a trap exception
  905. (and only work for Instruction Set Architecture level 2 and higher);
  906. &fB--breakfR or fB--no-trapfR (also synonyms, and the default) take a
  907. break exception.
  908. .IP "fB-nfR" 4
  909. .IX Item "-n"
  910. When this option is used, fBasfR will issue a warning every
  911. time it generates a nop instruction from a macro.
  912. .PP
  913. The following options are available when as is configured for
  914. an MCore processor.
  915. .IP "fB-jsri2bsrfR" 4
  916. .IX Item "-jsri2bsr"
  917. .PD 0
  918. .IP "fB-nojsri2bsrfR" 4
  919. .IX Item "-nojsri2bsr"
  920. .PD
  921. Enable or disable the s-1JSRIs0 to s-1BSRs0 transformation.  By default this is enabled.
  922. The command line option fB-nojsri2bsrfR can be used to disable it.
  923. .IP "fB-sifilterfR" 4
  924. .IX Item "-sifilter"
  925. .PD 0
  926. .IP "fB-nosifilterfR" 4
  927. .IX Item "-nosifilter"
  928. .PD
  929. Enable or disable the silicon filter behaviour.  By default this is disabled.
  930. The default can be overridden by the fB-sifilterfR command line option.
  931. .IP "fB-relaxfR" 4
  932. .IX Item "-relax"
  933. Alter jump instructions for long displacements.
  934. .IP "fB-mcpu=[210|340]fR" 4
  935. .IX Item "-mcpu=[210|340]"
  936. Select the cpu type on the target hardware.  This controls which instructions
  937. can be assembled.
  938. .IP "fB-EBfR" 4
  939. .IX Item "-EB"
  940. Assemble for a big endian target.
  941. .IP "fB-ELfR" 4
  942. .IX Item "-EL"
  943. Assemble for a little endian target.
  944. .PP
  945. See the info pages for documentation of the MMIX-specific options.
  946. .PP
  947. The following options are available when as is configured for
  948. an Xtensa processor.
  949. .IP "fB--text-section-literals | --no-text-section-literalsfR" 4
  950. .IX Item "--text-section-literals | --no-text-section-literals"
  951. With fB--text-section-literalsfR, literal pools are interspersed
  952. in the text section.  The default is
  953. &fB--no-text-section-literalsfR, which places literals in a
  954. separate section in the output file.  These options only affect literals
  955. referenced via PC-relative f(CW*(C`L32R*(C'fR instructions; literals for
  956. absolute mode f(CW*(C`L32R*(C'fR instructions are handled separately.
  957. .IP "fB--absolute-literals | --no-absolute-literalsfR" 4
  958. .IX Item "--absolute-literals | --no-absolute-literals"
  959. Indicate to the assembler whether f(CW*(C`L32R*(C'fR instructions use absolute
  960. or PC-relative addressing.  The default is to assume absolute addressing
  961. if the Xtensa processor includes the absolute f(CW*(C`L32R*(C'fR addressing
  962. option.  Otherwise, only the PC-relative f(CW*(C`L32R*(C'fR mode can be used.
  963. .IP "fB--target-align | --no-target-alignfR" 4
  964. .IX Item "--target-align | --no-target-align"
  965. Enable or disable automatic alignment to reduce branch penalties at the
  966. expense of some code density.  The default is fB--target-alignfR.
  967. .IP "fB--longcalls | --no-longcallsfR" 4
  968. .IX Item "--longcalls | --no-longcalls"
  969. Enable or disable transformation of call instructions to allow calls
  970. across a greater range of addresses.  The default is
  971. &fB--no-longcallsfR.
  972. .IP "fB--transform | --no-transformfR" 4
  973. .IX Item "--transform | --no-transform"
  974. Enable or disable all assembler transformations of Xtensa instructions.
  975. The default is fB--transformfR;
  976. &fB--no-transformfR should be used only in the rare cases when the
  977. instructions must be exactly as specified in the assembly source.
  978. .SH "SEE ALSO"
  979. .IX Header "SEE ALSO"
  980. &fIgccfR|(1), fIldfR|(1), and the Info entries for fIbinutilsfR and fIldfR.
  981. .SH "COPYRIGHT"
  982. .IX Header "COPYRIGHT"
  983. Copyright (C) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001, 2002 Free Software Foundation, Inc.
  984. .PP
  985. Permission is granted to copy, distribute and/or modify this document
  986. under the terms of the s-1GNUs0 Free Documentation License, Version 1.1
  987. or any later version published by the Free Software Foundation;
  988. with no Invariant Sections, with no Front-Cover Texts, and with no
  989. Back-Cover Texts.  A copy of the license is included in the
  990. section entitled ``s-1GNUs0 Free Documentation License''.