contrib/binutils-2.20/gas/doc/c-score.texi

   1 @c Copyright 2009
   2 @c Free Software Foundation, Inc.
   3 @c This is part of the GAS manual.
   4 @c For copying conditions, see the file as.texinfo.
   5 @ifset GENERIC
   6 @page
   7 @node SCORE-Dependent
   8 @chapter SCORE Dependent Features
   9 @end ifset
  10 @ifclear GENERIC
  11 @node Machine Dependencies
  12 @chapter SCORE Dependent Features
  13 @end ifclear
  14
  15 @cindex SCORE processor
  16 @menu
  17 * SCORE-Opts::          Assembler options
  18 * SCORE-Pseudo::        SCORE Assembler Directives
  19 @end menu
  20
  21 @node SCORE-Opts
  22 @section Options
  23
  24 @cindex options for SCORE
  25 @cindex SCORE options
  26 @cindex architectures, SCORE
  27 @cindex SCORE architectures
  28
  29 The following table lists all available SCORE options.
  30
  31 @table @code
  32 @item -G @var{num}
  33 This option sets the largest size of an object that can be referenced
  34 implicitly with the @code{gp} register. The default value is 8.
  35
  36 @item -EB
  37 Assemble code for a big-endian cpu
  38
  39 @itemx -EL
  40 Assemble code for a little-endian cpu
  41
  42 @item -FIXDD
  43 Assemble code for fix data dependency
  44
  45 @item -NWARN
  46 Assemble code for no warning message for fix data dependency
  47
  48 @item -SCORE5
  49 Assemble code for target is SCORE5
  50
  51 @itemx -SCORE5U
  52 Assemble code for target is SCORE5U
  53
  54 @itemx -SCORE7
  55 Assemble code for target is SCORE7, this is default setting
  56
  57 @itemx -SCORE3
  58 Assemble code for target is SCORE3
  59
  60 @item -march=score7
  61 Assemble code for target is SCORE7, this is default setting
  62
  63 @item -march=score3
  64 Assemble code for target is SCORE3
  65
  66 @item -USE_R1
  67 Assemble code for no warning message when using temp register r1
  68
  69 @item -KPIC
  70 Generate code for PIC.  This option tells the assembler to generate
  71 score position-independent macro expansions.  It also tells the
  72 assembler to mark the output file as PIC.
  73
  74 @item -O0
  75 Assembler will not perform any optimizations
  76
  77 @item -V
  78 Sunplus release version
  79
  80 @end table
  81
  82 @node SCORE-Pseudo
  83 @section SCORE Assembler Directives
  84
  85 @cindex directives for SCORE
  86 @cindex SCORE directives
  87 A number of assembler directives are available for SCORE.  The
  88 following table is far from complete.
  89
  90 @table @code
  91 @item .set nwarn
  92 Let the assembler not to generate warnings if the source machine
  93 language instructions happen data dependency.
  94
  95 @item .set fixdd
  96 Let the assembler to insert bubbles (32 bit nop instruction /
  97 16 bit nop! Instruction) if the source machine language instructions
  98 happen data dependency.
  99
 100 @item .set nofixdd
 101 Let the assembler to generate warnings if the source machine
 102 language instructions happen data dependency. (Default)
 103
 104 @item .set r1
 105 Let the assembler not to generate warnings if the source program
 106 uses r1. allow user to use r1
 107
 108 @item set nor1
 109 Let the assembler to generate warnings if the source program uses
 110 r1. (Default)
 111
 112 @item .sdata
 113 Tell the assembler to add subsequent data into the sdata section
 114
 115 @item .rdata
 116 Tell the assembler to add subsequent data into the rdata section
 117
 118 @item .frame "frame-register", "offset", "return-pc-register"
 119 Describe a stack frame. "frame-register" is the frame register,
 120 "offset" is the distance from the frame register to the virtual
 121 frame pointer, "return-pc-register" is the return program register.
 122 You must use ".ent" before ".frame" and only one ".frame" can be
 123 used per ".ent".
 124
 125 @item .mask "bitmask", "frameoffset"
 126 Indicate which of the integer registers are saved in the current
 127 function's stack frame, this is for the debugger to explain the
 128 frame chain.
 129
 130 @item .ent "proc-name"
 131 Set the beginning of the procedure "proc_name". Use this directive
 132 when you want to generate information for the debugger.
 133
 134 @item .end proc-name
 135 Set the end of a procedure. Use this directive to generate information
 136 for the debugger.
 137
 138 @item .bss
 139 Switch the destination of following statements into the bss section,
 140 which is used for data that is uninitialized anywhere.
 141
 142 @end table