gas/doc/c-score.texi

   1 @c Copyright (C) 2009-2019 Free Software Foundation, Inc.
   2 @c This is part of the GAS manual.
   3 @c For copying conditions, see the file as.texinfo.
   4 @ifset GENERIC
   5 @page
   6 @node SCORE-Dependent
   7 @chapter SCORE Dependent Features
   8 @end ifset
   9 @ifclear GENERIC
  10 @node Machine Dependencies
  11 @chapter SCORE Dependent Features
  12 @end ifclear
  13
  14 @cindex SCORE processor
  15 @menu
  16 * SCORE-Opts::          Assembler options
  17 * SCORE-Pseudo::        SCORE Assembler Directives
  18 * SCORE-Syntax::        Syntax
  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 @item -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 @item -SCORE5U
  52 Assemble code for target is SCORE5U
  53
  54 @item -SCORE7
  55 Assemble code for target is SCORE7, this is default setting
  56
  57 @item -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
 143
 144 @node SCORE-Syntax
 145 @section SCORE Syntax
 146 @menu
 147 * SCORE-Chars::                Special Characters
 148 @end menu
 149
 150 @node SCORE-Chars
 151 @subsection Special Characters
 152
 153 @cindex line comment character, SCORE
 154 @cindex SCORE line comment character
 155 The presence of a @samp{#} appearing anywhere on a line indicates the
 156 start of a comment that extends to the end of that line.
 157
 158 If a @samp{#} appears as the first character of a line then the whole
 159 line is treated as a comment, but in this case the line can also be a
 160 logical line number directive (@pxref{Comments}) or a preprocessor
 161 control command (@pxref{Preprocessing}).
 162
 163 @cindex line separator, SCORE
 164 @cindex statement separator, SCORE
 165 @cindex SCORE line separator
 166 The @samp{;} character can be used to separate statements on the same
 167 line.