From a946d7e38e4e55fb6b71f71d896e83c39ac404fa Mon Sep 17 00:00:00 2001 From: Nick Clifton Date: Thu, 23 Jul 2009 10:19:20 +0000 Subject: PR binutils/10379 * doc/c-mips.texi (MIPS insn): Document the special behaviour of the .global directive for MIPS ports. --- gas/doc/c-mips.texi | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) (limited to 'gas/doc') diff --git a/gas/doc/c-mips.texi b/gas/doc/c-mips.texi index 695176b..9c5c522 100644 --- a/gas/doc/c-mips.texi +++ b/gas/doc/c-mips.texi @@ -527,6 +527,32 @@ when loading the address of a label which precedes instructions, @code{@value{AS}} automatically adds 1 to the value, so that jumping to the loaded address will do the right thing. +@kindex @code{.global} +The @code{.global} and @code{.globl} directives supported by +@code{@value{AS}} will by default mark the symbol as pointing to a +region of data not code. This means that, for example, any +instructions following such a symbol will not be disassembled by +@code{@value{objdump}} as it will regard them as data. To change this +behaviour an optional section name can be placed after the symbol name +in the @code{.global} directive. If this section exists and is known +to be a code section, then the symbol will be marked as poiting at +code not data. Ie the syntax for the directive is: + + @code{.global @var{symbol}[ @var{section}][, @var{symbol}[ @var{section}]] ...}, + +Here is a short example: + +@example + .global foo .text, bar, baz .data +foo: + nop +bar: + .word 0x0 +baz: + .word 0x1 + +@end example + @node MIPS option stack @section Directives to save and restore options -- cgit v1.1