bfd/
[deliverable/binutils-gdb.git] / gas / doc / c-v850.texi
index 5e4c8b396e13120cc00d2ec189ab0854cce58e28..5fd4bacb28666f5e197df0a2981e93a99df15822 100644 (file)
@@ -1,4 +1,4 @@
-@c Copyright (C) 1997, 1998 Free Software Foundation, Inc.
+@c Copyright 1997, 2003 Free Software Foundation, Inc.
 @c This is part of the GAS manual.
 @c For copying conditions, see the file as.texinfo.
 
@@ -45,19 +45,16 @@ Specifies that the assembled code should be marked as being targeted at
 the V850 processor.  This allows the linker to detect attempts to link
 such code with code assembled for other processors.
 
-@c start-sanitize-v850e
 @cindex @code{-mv850e} command line option, V850
 @item -mv850e
 Specifies that the assembled code should be marked as being targeted at
 the V850E processor.  This allows the linker to detect attempts to link
 such code with code assembled for other processors.
-@c end-sanitize-v850e
 
-@c start-sanitize-v850e
-@cindex @code{-mv850ea} command line option, V850
-@item -mv850ea
+@cindex @code{-mv850e1} command line option, V850
+@item -mv850e1
 Specifies that the assembled code should be marked as being targeted at
-the V850EA processor.  This allows the linker to detect attempts to link
+the V850E1 processor.  This allows the linker to detect attempts to link
 such code with code assembled for other processors.
 
 @cindex @code{-mv850any} command line option, V850
@@ -68,10 +65,16 @@ extended variants of the process.  This allows the production of
 binaries that contain target specific code, but which are also intended
 to be used in a generic fashion.  For example libgcc.a contains generic
 routines used by the code produced by GCC for all versions of the v850
-architecture, together with support routines only used by the V850E and
-V850EA architectures.
+architecture, together with support routines only used by the V850E
+architecture.
 
-@c end-sanitize-v850e
+@cindex @code{-mrelax} command line option, V850
+@item -mrelax
+Enables relaxation.  This allows the .longcall and .longjump pseudo
+ops to be used in the assembler source code.  These ops label sections
+of code which are either a long function call or a long branch.  The
+assembler will then flag these sections of code and the linker will
+attempt to relax them.
 
 @end table
 
@@ -184,7 +187,6 @@ ecr
 @cindex @code{psw} register, V850
 @item system register 5
 psw
-@c start-sanitize-v850e
 @cindex @code{ctpc} register, V850
 @item system register 16
 ctpc
@@ -200,7 +202,6 @@ dbpsw
 @cindex @code{ctbp} register, V850
 @item system register 20
 ctbp
-@c end-sanitize-v850e
 @end table
 
 @node V850 Floating Point
@@ -232,21 +233,17 @@ Specifies that the assembled code should be marked as being targeted at
 the V850 processor.  This allows the linker to detect attempts to link
 such code with code assembled for other processors.
 
-@c start-sanitize-v850e
 @cindex @code{.v850e} directive, V850
 @item .v850e
 Specifies that the assembled code should be marked as being targeted at
 the V850E processor.  This allows the linker to detect attempts to link
 such code with code assembled for other processors.
-@c end-sanitize-v850e
 
-@c start-sanitize-v850e
-@cindex @code{.v850ea} directive, V850
-@item .v850ea
+@cindex @code{.v850e1} directive, V850
+@item .v850e1
 Specifies that the assembled code should be marked as being targeted at
-the V850EA processor.  This allows the linker to detect attempts to link
+the V850E1 processor.  This allows the linker to detect attempts to link
 such code with code assembled for other processors.
-@c end-sanitize-v850e
 
 @end table
 
@@ -296,7 +293,7 @@ address of the label 'here' and store it into register 6:
     @samp{movea lo(here), r6, r6}
 
 The reason for this special behaviour is that movea performs a sign
-extention on its immediate operand.  So for example if the address of
+extension on its immediate operand.  So for example if the address of
 'here' was 0xFFFFFFFF then without the special behaviour of the hi()
 pseudo-op the movhi instruction would put 0xFFFF0000 into r6, then the
 movea instruction would takes its immediate operand, 0xFFFF, sign extend
@@ -306,7 +303,6 @@ in the top bit of the lo() pseudo op, the movhi instruction actually
 stores 0 into r6 (0xFFFF + 1 = 0x0000), so that the movea instruction
 stores 0xFFFFFFFF into r6 - the right value.
 
-@c start-sanitize-v850e
 @cindex @code{hilo} pseudo-op, V850
 @item hilo()
 Computes the 32 bit value of the given expression and stores it into
@@ -317,7 +313,6 @@ mov instruction).  For example:
 
 computes the absolute address of label 'here' and puts the result into
 register 6.  
-@c end-sanitize-v850e
 
 @cindex @code{sdaoff} pseudo-op, V850
 @item sdaoff()
@@ -340,11 +335,7 @@ command line option].
 @item tdaoff()
 Computes the offset of the named variable from the start of the Tiny
 Data Area (whoes address is held in register 30, the EP register) and
-stores the result as a
-@c start-sanitize-v850e
-4,5,
-@c end-sanitize-v850e
-7 or 8 bit unsigned value in the immediate
+stores the result as a 4,5, 7 or 8 bit unsigned value in the immediate
 operand field of the given instruction.  For example:
 
       @samp{sld.w tdaoff(_a_variable)[ep],r6}
@@ -370,7 +361,6 @@ that the label is somewhere within the first 32K of memory.  (Strictly
 speaking it also possible to access the last 32K of memory as well, as
 the offsets are signed).
 
-@c start-sanitize-v850e
 @cindex @code{ctoff} pseudo-op, V850
 @item ctoff()
 Computes the offset of the named variable from the start of the Call
@@ -383,7 +373,20 @@ example:
 
 will put the call the function whoes address is held in the call table
 at the location labeled 'table_func1'.
-@c end-sanitize-v850e
+
+@cindex @code{longcall} pseudo-op, V850
+@item .longcall @code{name}
+Indicates that the following sequence of instructions is a long call
+to function @code{name}.  The linker will attempt to shorten this call
+sequence if @code{name} is within a 22bit offset of the call.  Only
+valid if the @code{-mrelax} command line switch has been enabled.
+
+@cindex @code{longjump} pseudo-op, V850
+@item .longjump @code{name}
+Indicates that the following sequence of instructions is a long jump
+to label @code{name}.  The linker will attempt to shorten this code
+sequence if @code{name} is within a 22bit offset of the jump.  Only
+valid if the @code{-mrelax} command line switch has been enabled.
 
 @end table
 
@@ -391,4 +394,3 @@ at the location labeled 'table_func1'.
 For information on the V850 instruction set, see @cite{V850
 Family 32-/16-Bit single-Chip Microcontroller Architecture Manual} from NEC.
 Ltd.
-
This page took 0.025274 seconds and 4 git commands to generate.