@ifinfo
@format
START-INFO-DIR-ENTRY
-* Stabs: (stabs). The "stabs" debugging information format.
+* Stabs: (stabs). The "stabs" debugging information format.
END-INFO-DIR-ENTRY
@end format
@end ifinfo
regarded as a program in the language TeX).
@end ifinfo
-@setchapternewpage off
+@setchapternewpage odd
@settitle STABS
@titlepage
-@title{The "stabs" representation of debugging information.}
+@title The ``stabs'' debug format
@author Julia Menapace
@author Cygnus Support
@page
This document describes the GNU stabs debugging format in a.out files.
@menu
-* Overview:: Overview of stabs
-* Program structure:: Encoding of the structure of the program
+* Overview:: Overview of stabs
+* Program structure:: Encoding of the structure of the program
* Simple types::
-* Example:: A comprehensive example in C
+* Example:: A comprehensive example in C
* Variables::
* Aggregate types::
-* Symbol tables:: Symbol information in symbol tables
+* Symbol tables:: Symbol information in symbol tables
* GNU C++ stabs::
Appendixes:
-* Example2.c:: Source code for extended example
-* Example2.s:: Assembly code for extended example
-* Quick reference:: Various refernce tables
-* Expanded reference:: Reference information by stab type
-* Questions:: Questions and anomolies
-* xcoff-differences:: Differences between GNU stabs in a.out
- and GNU stabs in xcoff
-* Sun-differences:: Differences between GNU stabs and Sun
- native stabs
+* Example2.c:: Source code for extended example
+* Example2.s:: Assembly code for extended example
+* Quick reference:: Various refernce tables
+* Expanded reference:: Reference information by stab type
+* Questions:: Questions and anomolies
+* xcoff-differences:: Differences between GNU stabs in a.out
+ and GNU stabs in xcoff
+* Sun-differences:: Differences between GNU stabs and Sun
+ native stabs
@end menu
@end ifinfo
@node Overview
@chapter Overview of stabs
+@dfn{Stabs} refers to a format for information that describes a program
+to a debugger. This format was apparently invented by
+@c FIXME! <<name of inventor>> at
+the University of California at Berkeley, for the @code{pdx} Pascal
+debugger; the format has spread widely since then.
+
@menu
* Flow:: Overview of debugging information flow
* Stabs format:: Overview of stab format
@node Flow
@section Overview of debugging information flow
-GCC compiles C source in a .c file into assembly language in a .s
-file, which is translated by the assembler into a .o file, and then
-linked with other .o files and libraries to produce an executable
-file.
+The GNU C compiler compiles C source in a @file{.c} file into assembly
+language in a @file{.s} file, which is translated by the assembler into
+a @file{.o} file, and then linked with other @file{.o} files and
+libraries to produce an executable file.
-When using the -g option, GCC puts additional debugging information in
-the .s file, which is slightly transformed by the assembler and
+With the @samp{-g} option, GCC puts additional debugging information in
+the @file{.s} file, which is slightly transformed by the assembler and
linker, and carried through into the final executable. This debugging
information describes features of the source file like line numbers,
the types and scopes of variables, and functions, their parameters and
their scopes.
For some object file formats, the debugging information is
-encapsulated in pseudo-ops to the assembler known as `stab' (symbol
+encapsulated in assembler directives known collectively as `stab' (symbol
table) directives, interspersed with the generated code. Stabs are
the native format for debugging information in the a.out and xcoff
object file formats. The GNU tools can also emit stabs in the coff
and ecoff object file formats.
-The assembler adds the information from stabs to the symbol
-information it places by default in the symbol table and the string
-table of the .o file it is building. The linker consolidates the .o
-files into one executable file, with one symbol and one string table.
-Debuggers use the symbol and string tables in the executable as a
-source of debugging information about the program.
+The assembler adds the information from stabs to the symbol information
+it places by default in the symbol table and the string table of the
+@file{.o} file it is building. The linker consolidates the @file{.o}
+files into one executable file, with one symbol table and one string
+table. Debuggers use the symbol and string tables in the executable as
+a source of debugging information about the program.
@node Stabs format
@section Overview of stab format
There are three overall formats for stab assembler directives
-differentiated by the first word of the stab. The first word
-describes what combination of four possible data fields will follow.
-It is either .stabs (string), .stabn (number), or .stabd (dot).
+differentiated by the first word of the stab. The name of the directive
+describes what combination of four possible data fields will follow. It
+is either @code{.stabs} (string), @code{.stabn} (number), or
+@code{.stabd} (dot).
The overall format of each class of stab is:
@example
-.stabs "string",type,0,desc,value
-.stabn type,0,desc,value
-.stabd type,0,desc
+.stabs "@var{string}",@var{type},0,@var{desc},@var{value}
+.stabn @var{type},0,@var{desc},@var{value}
+.stabd @var{type},0,@var{desc}
@end example
-In general, in .stabs the string field contains name and type
-information. For .stabd the value field is implicit and has the value
+In general, in @code{.stabs} the @var{string} field contains name and type
+information. For @code{.stabd} the value field is implicit and has the value
of the current file location. Otherwise the value field often
contains a relocatable address, frame pointer offset, or register
number, that maps to the source code element described by the stab.
-The real key to decoding the meaning of a stab is the number in its
-type field. Each possible type number defines a different stab type.
-The stab type further defines the exact interpretation of, and
-possible values for, any remaining "string", desc, or value fields
-present in the stab. Table A lists in numeric order the possible type
-field values for stab directives. The reference section that follows
-Table A describes the meaning of the fields for each stab type in
-detail. The examples that follow this overview introduce the stab
-types in terms of the source code elements they describe.
+The real key to decoding the meaning of a stab is the number in its type
+field. Each possible type number defines a different stab type. The
+stab type further defines the exact interpretation of, and possible
+values for, any remaining @code{"@var{string}"}, @var{desc}, or
+@var{value} fields present in the stab. Table A (@pxref{Stab
+types,,Table A: Symbol types from stabs}) lists in numeric order
+the possible type field values for stab directives. The reference
+section that follows Table A describes the meaning of the fields for
+each stab type in detail. The examples that follow this overview
+introduce the stab types in terms of the source code elements they
+describe.
-For .stabs the "string" field holds the meat of the debugging
-information. The generally unstructured nature of this field is what
-makes stabs extensible. For some stab types the string field contains
-only a name. For other stab types the contents can be a great deal
-more complex.
+For @code{.stabs} the @code{"@var{string}"} field holds the meat of the
+debugging information. The generally unstructured nature of this field
+is what makes stabs extensible. For some stab types the string field
+contains only a name. For other stab types the contents can be a great
+deal more complex.
-The overall format is of the "string" field is:
+The overall format is of the @code{"@var{string}"} field is:
@example
-"name[:symbol_descriptor][type_number[=type_descriptor...]]"
+"@var{name}@r{[}:@var{symbol_descriptor}@r{]}
+ @r{[}@var{type_number}@r{[}=@var{type_descriptor} @r{@dots{}]]}"
@end example
-name is the name of the symbol represented by the stab.
+@var{name} is the name of the symbol represented by the stab.
-The symbol_descriptor following the : is an alphabetic character that
-tells more specifically what kind of symbol the stab represents. If
-the symbol_descriptor is omitted, but type information follows, then
-the stab represents a local variable. See Table C for a list of
-symbol_descriptors.
+The @var{symbol_descriptor} following the @samp{:} is an alphabetic
+character that tells more specifically what kind of symbol the stab
+represents. If the @var{symbol_descriptor} is omitted, but type
+information follows, then the stab represents a local variable. For a
+list of symbol_descriptors, see @ref{Symbol descriptors,,Table C: Symbol
+descriptors}.
-Type information it is either a type_number, or a type_number=. The
-type_number alone is a type reference, referring directly to a type
-that has already been defined.
+Type information is either a @var{type_number}, or a
+@samp{@var{type_number}=}. The @var{type_number} alone is a type
+reference, referring directly to a type that has already been defined.
-The type_number= is a type definition, where the number represents a
-new type which is about to be defined. The type definition may refer
-to other types by number, and those type numbers may be followed by =
-and nested definitions.
+The @samp{@var{type_number}=} is a type definition, where the number
+represents a new type which is about to be defined. The type definition
+may refer to other types by number, and those type numbers may be
+followed by @samp{=} and nested definitions.
In a type definition, if the character that follows the equals sign is
-non-numeric then it is a type_descriptor, and tells what kind of type
-is about to be defined. Any other values following the
-type_descriptor vary, depending on the type_descriptor. If a number
-follows the = then the number is a type_reference. This is described
-more thoroughly in the section on types. See Table D for a list of
-type_descriptors.
-
-All this can make the "string" field quite long. When the "string"
-part of a stab is more than 80 characters, we split the .stabs
-pseudo-op into two .stabs pseudo-ops, both stabs duplicate exactly all
-but the "string" field. The "string" field of the first stab contains
-the first part of the overlong string, marked as continued with a
-double-backslash at the end. The "string" field of the second stab
-holds the second half of the overlong string.
+non-numeric then it is a @var{type_descriptor}, and tells what kind of
+type is about to be defined. Any other values following the
+@var{type_descriptor} vary, depending on the @var{type_descriptor}. If
+a number follows the @samp{=} then the number is a @var{type_reference}.
+This is described more thoroughly in the section on types. @xref{Type
+Descriptors,,Table D: Type Descriptors}, for a list of
+@var{type_descriptor} values.
+
+@c FIXME! "too long" below introduced at J Gilmore's request; used to
+@c say "more than 80 chars". Why is vaguer better?
+All this can make the @code{"@var{string}"} field quite long. When the
+@code{"@var{string}"} part of a stab is too long, the compiler splits
+the @code{.stabs} directive into two @code{.stabs} directives. Both
+stabs duplicate exactly all but the @code{"@var{string}"} field. The
+@code{"@var{string}"} field of the first stab contains the first part of
+the overlong string, marked as continued with a double-backslash at the
+end. The @code{"@var{string}"} field of the second stab holds the
+second half of the overlong string.
@node C example
@section A simple example in C source
@example
main()
@{
- printf("Hello world");
+ printf("Hello world");
@}
@end example
-When compiled with -g, the program above yields the following .s file.
-Line numbers have been added so it will be easier to refer to parts of
-the .s file in the description of the stabs that follows.
+When compiled with @samp{-g}, the program above yields the following
+@file{.s} file. Line numbers have been added to make it easier to refer
+to parts of the @file{.s} file in the description of the stabs that
+follows.
@node Assembly code
@section The simple example at the assembly level
18 .stabs "double:t13=r1;8;0;",128,0,0,0
19 .stabs "long double:t14=r1;8;0;",128,0,0,0
20 .stabs "void:t15=15",128,0,0,0
-21 .align 4
+21 .align 4
22 LC0:
-23 .ascii "Hello, world!\12\0"
-24 .align 4
-25 .global _main
-26 .proc 1
+23 .ascii "Hello, world!\12\0"
+24 .align 4
+25 .global _main
+26 .proc 1
27 _main:
28 .stabn 68,0,4,LM1
29 LM1:
-30 !#PROLOGUE# 0
-31 save %sp,-136,%sp
-32 !#PROLOGUE# 1
-33 call ___main,0
-34 nop
+30 !#PROLOGUE# 0
+31 save %sp,-136,%sp
+32 !#PROLOGUE# 1
+33 call ___main,0
+34 nop
35 .stabn 68,0,5,LM2
36 LM2:
37 LBB2:
-38 sethi %hi(LC0),%o1
-39 or %o1,%lo(LC0),%o0
-40 call _printf,0
-41 nop
+38 sethi %hi(LC0),%o1
+39 or %o1,%lo(LC0),%o0
+40 call _printf,0
+41 nop
42 .stabn 68,0,6,LM3
43 LM3:
44 LBE2:
45 .stabn 68,0,6,LM4
46 LM4:
47 L1:
-48 ret
-49 restore
+48 ret
+49 restore
50 .stabs "main:F1",36,0,0,_main
51 .stabn 192,0,0,LBB2
52 .stabn 224,0,0,LBE2
@end example
-This simple hello world example, demonstrates several of the stab
+This simple ``hello world'' example demonstrates several of the stab
types used to describe C language source files.
@node Program structure
-@chapter Encoding of the structure of the program
+@chapter Encoding for the structure of the program
@menu
* Source file:: The path and name of the source file
@node Source file
@section The path and name of the source file
-@example
-.stabs, stab type N_SO
-@end example
+@table @strong
+@item Directive:
+@code{.stabs}
+@item Type:
+@code{N_SO}
+@end table
The first stabs in the .s file contain the name and path of the source
file that was compiled to produce the .s file. This information is
@example
2 .stabs "/cygint/s1/users/jcm/play/",100,0,0,Ltext0
3 .stabs "hello.c",100,0,0,Ltext0
-4 .text
+4 .text
5 Ltext0:
@end example
@node Line numbers
@section Line Numbers
-@example
-.stabn, stab type N_SLINE
-@end example
+@table @strong
+@item Directive:
+@code{.stabn}
+@item Type:
+@code{N_SLINE}
+@end table
-The start of source lines is represented by the N_SLINE (68) stab
+The start of source lines is represented by the @code{N_SLINE} (68) stab
type.
@example
- .stabn N_SLINE, NIL, source_line_number,
- code_address_for_start_of_source_line
+.stabn N_SLINE, NIL, @var{line}, @var{address}
@end example
+@var{line} is a source line number; @var{address} represents the code
+address for the start of that source line.
+
@example
27 _main:
28 .stabn 68,0,4,LM1
29 LM1:
-30 !#PROLOGUE# 0
+30 !#PROLOGUE# 0
@end example
@node Procedures
@section Procedures
-@example
-.stabs, stab type N_FUN,
- symbol descriptors f (local), F (global)
-@end example
+@table @strong
+@item Directive:
+@code{.stabs}
+@item Type:
+@code{N_FUN}
+@item Symbol Descriptors:
+@code{f} (local), @code{F} (global)
+@end table
-Procedures are described by the N_FUN stab type. The symbol
-descriptor for a procedure is F if the proc is globally scoped and f
-if the procedure is static (locally scoped).
+Procedures are described by the @code{N_FUN} stab type. The symbol
+descriptor for a procedure is @samp{F} if the procedure is globally
+scoped and @samp{f} if the procedure is static (locally scoped).
-The N_FUN stab representing a procedure is located immediatly
-following the code of the procedure. The N_FUN stab is in turn
+The @code{N_FUN} stab representing a procedure is located immediately
+following the code of the procedure. The @code{N_FUN} stab is in turn
directly followed by a group of other stabs describing elements of the
procedure. These other stabs describe the procedure's parameters, its
block local variables and its block structure.
@example
-48 ret
-49 restore
+48 ret
+49 restore
@end example
+The @code{.stabs} entry after this code fragment shows the @var{name} of
+the procedure (@code{main}); the type descriptor @var{desc} (@code{F},
+for a global procedure); a reference to the predefined type @code{int}
+for the return type; and the starting @var{address} of the procedure.
+
+Here is an exploded summary (with whitespace introduced for clarity),
+followed by line 50 of our sample assembly output, which has this form:
+
@example
- .stabs "procedure_name:symbol_desc(global proc)return_type_ref(int)",
- N_FUN, NIL, NIL, Code_address_of_procedure_start
+.stabs "@var{name}:
+ @var{desc} @r{(global proc @samp{F})}
+ @var{return_type_ref} @r{(int)}
+ ",N_FUN, NIL, NIL,
+ @var{address}
@end example
@example
@node Block Structure
@section Block Structure
-@example
-.stabn, stab types N_LBRAC, N_RRAC
-@end example
+@table @strong
+@item Directive:
+@code{.stabn}
+@item Types:
+@code{N_LBRAC}, @code{N_RBRAC}
+@end table
-The program's block structure is represented by the N_LBRAC (left
-brace) and the N_RBRAC (right brace) stab types. The following code
-range, which is the body of main, is labeled with LBB2: at the
-beginning and LBE2: at the end.
+The program's block structure is represented by the @code{N_LBRAC} (left
+brace) and the @code{N_RBRAC} (right brace) stab types. The following code
+range, which is the body of @code{main}, is labeled with @samp{LBB2:} at the
+beginning and @samp{LBE2:} at the end.
@example
37 LBB2:
-38 sethi %hi(LC0),%o1
-39 or %o1,%lo(LC0),%o0
-40 call _printf,0
-41 nop
+38 sethi %hi(LC0),%o1
+39 or %o1,%lo(LC0),%o0
+40 call _printf,0
+41 nop
42 .stabn 68,0,6,LM3
43 LM3:
44 LBE2:
@end example
-The N_LBRAC and N_RBRAC stabs that describe the block scope of the
-procedure are located after the N_FUNC stab that represents the
-procedure itself. The N_LBRAC uses the LBB2 label as the code address
-in its value field and the N_RBRAC uses the LBE2.
+The @code{N_LBRAC} and @code{N_RBRAC} stabs that describe the block
+scope of the procedure are located after the @code{N_FUNC} stab that
+represents the procedure itself. The @code{N_LBRAC} uses the
+@code{LBB2} label as the code address in its value field, and the
+@code{N_RBRAC} uses @code{LBE2}.
@example
50 .stabs "main:F1",36,0,0,_main
@end example
@example
- .stabn N_LBRAC, NIL, NIL, Code_Address_for_left_brace
- .stabn N_RBRAC, NIL, NIL, Code_Address_for_right_brace
+ .stabn N_LBRAC, NIL, NIL, @var{left-brace-address}
+ .stabn N_RBRAC, NIL, NIL, @var{right-brace-address}
@end example
@example
@chapter Simple types
@menu
-* Basic types::
+* Basic types:: Basic type definitions
* Range types:: Range types defined by min and max value
* Bit-ranges:: Range type defined by number of bits
@end menu
@node Basic types
@section Basic type definitions
-@example
-.stabs, stab type N_LSYM,
- symbol descriptor t
-@end example
+@table @strong
+@item Directive:
+@code{.stabs}
+@item Type:
+@code{N_LSYM}
+@item Symbol Descriptor:
+@code{t}
+@end table
-The basic types for the language are described using the N_LSYM stab
+The basic types for the language are described using the @code{N_LSYM} stab
type. They are boilerplate and are emited by the compiler for each
compilation unit. Basic type definitions are not always a complete
description of the type and are sometimes circular. The debugger
@node Range types
@section Range types defined by min and max value
-type descriptor r
+@table @strong
+@item Type Descriptor:
+@code{r}
+@end table
When defining a range type, if the number after the first semicolon is
smaller than the number after the second one, then the two numbers
4 .text
5 Ltext0:
- .stabs "name:sym_descriptor(type)type_def(1)=type_desc(range)type_ref(1);\
- "low_bound;high_bound;",N_LSYM, NIL, NIL, NIL
+.stabs "@var{name}:
+ @var{descriptor} @r{(type)}
+ @var{type-def}=
+ @var{type-desc}
+ @var{type-ref};
+ @var{low-bound};
+ @var{high-bound};
+ ",
+ N_LSYM, NIL, NIL, NIL
6 .stabs "int:t1=r1;-2147483648;2147483647;",128,0,0,0
7 .stabs "char:t2=r2;0;127;",128,0,0,0
@end example
-Here the integer type (1) is defined as a range of the integer type
-(1). Likewise char is a range of char. This part of the definition
-is circular, but at least the high and low bound values of the range
-hold more information about the type.
+Here the integer type (@code{1}) is defined as a range of the integer
+type (@code{1}). Likewise @code{char} is a range of @code{char}. This
+part of the definition is circular, but at least the high and low bound
+values of the range hold more information about the type.
Here short unsigned int is defined as type number 8 and described as a
-range of type int, with a minimum value of 0 and a maximum of 65535.
+range of type @code{int}, with a minimum value of 0 and a maximum of 65535.
@example
13 .stabs "short unsigned int:t8=r1;0;65535;",128,0,0,0
@node Bit-ranges
@section Range type defined by number of bits
-type descriptor r
+@table @strong
+@item Type Descriptor:
+@code{r}
+@end table
In a range definition, if the number after the second semicolon is 0,
then the number after the first semicolon is the number of bits needed
to represent the type.
@example
- .stabs "name:sym_desc(type)type_def(12)=type_desc(range)type_ref(int)\
- ";number_of_bytes;0;", N_LSYM, NIL, NIL, NIL
+.stabs "@var{name}:
+ @var{desc}
+ @var{type-def}=
+ @var{type-desc}
+ @var{type-ref};
+ @var{bit-count};
+ 0;
+ ",
+ N_LSYM, NIL, NIL, NIL
17 .stabs "float:t12=r1;4;0;",128,0,0,0
18 .stabs "double:t13=r1;8;0;",128,0,0,0
19 .stabs "long double:t14=r1;8;0;",128,0,0,0
@end example
-Cosmically enough, the void type is defined directly in terms of
+Cosmically enough, the @code{void} type is defined directly in terms of
itself.
@example
- .stabs "name:symbol_desc(type)type_def(15)=type_ref(15)",N_LSYM,NIL,NIL,NIL
-@end example
+.stabs "@var{name}:
+ @var{symbol-desc}
+ @var{type-def}=
+ @var{type-ref}
+ ",N_LSYM,NIL,NIL,NIL
-@example
20 .stabs "void:t15=15",128,0,0,0
@end example
@node Example
@chapter A Comprehensive Example in C
-Now we'll examine a second program, example2, which builds on the
+Now we'll examine a second program, @code{example2}, which builds on the
first example to introduce the rest of the stab types, symbol
descriptors, and type descriptors used in C.
-@xref{Example2.c} for the complete .c source,
-and @pxref{Example2.s} for the .s assembly code.
+@xref{Example2.c} for the complete @file{.c} source,
+and @pxref{Example2.s} for the @file{.s} assembly code.
This description includes parts of those files.
@section Flow of control and nested scopes
-@code{.stabn}, stab types @code{N_SLINE}, @code{N_LBRAC}, @code{N_RBRAC} (cont.)
+@table strong
+@item Directive:
+@code{.stabn}
+@item Types:
+@code{N_SLINE}, @code{N_LBRAC}, @code{N_RBRAC} (cont.)
+@end table
Consider the body of @code{main}, from @file{example2.c}. It shows more
about how @code{N_SLINE}, @code{N_RBRAC}, and @code{N_LBRAC} stabs are used.
@example
20 @{
21 static float s_flap;
-22 int times;
-23 for (times=0; times < s_g_repeat; times++)@{
-24 int inner;
-25 printf ("Hello world\n");
-26 @}
+22 int times;
+23 for (times=0; times < s_g_repeat; times++)@{
+24 int inner;
+25 printf ("Hello world\n");
+26 @}
27 @};
@end example
@code{N_SLINE} stab with the same line number proceeds each block of
non-contiguous code generated from the same source line.
-The example also shows nested scopes. The @code{N_LBRAC} and @code{N_LBRAC} stabs
-that describe block structure are nested in the same order as the
-corresponding code blocks, those of the for loop inside those for the
-body of main.
+The example also shows nested scopes. The @code{N_LBRAC} and
+@code{N_LBRAC} stabs that describe block structure are nested in the
+same order as the corresponding code blocks, those of the for loop
+inside those for the body of main.
-@example
-@exdent Label for the @code{N_LBRAC} (left brace) stab marking the start of @code{main}.
+@noindent
+This is the label for the @code{N_LBRAC} (left brace) stab marking the
+start of @code{main}.
+@example
57 LBB2:
+@end example
+
+@noindent
+In the first code range for C source line 23, the @code{for} loop
+initialize and test, @code{N_SLINE} (68) records the line number:
-@exdent First code range for source line 23,`for' loop initialize and test
-@exdent <68> N_SLINE - source line number associated with this code
-@exdent .stabn N_SLINE, NIL, line_number, code_address_of_line_start
+@example
+.stabn N_SLINE, NIL,
+ @var{line},
+ @var{address}
58 .stabn 68,0,23,LM2
59 LM2:
-60 st %g0,[%fp-20]
+60 st %g0,[%fp-20]
61 L2:
-62 sethi %hi(_s_g_repeat),%o0
-63 ld [%fp-20],%o1
-64 ld [%o0+%lo(_s_g_repeat)],%o0
-65 cmp %o1,%o0
-66 bge L3
-67 nop
+62 sethi %hi(_s_g_repeat),%o0
+63 ld [%fp-20],%o1
+64 ld [%o0+%lo(_s_g_repeat)],%o0
+65 cmp %o1,%o0
+66 bge L3
+67 nop
-@exdent label for the N_LBRAC (start block) marking the start of `for' loop
+@exdent label for the @code{N_LBRAC} (start block) marking the start of @code{for} loop
68 LBB3:
69 .stabn 68,0,25,LM3
70 LM3:
-71 sethi %hi(LC0),%o1
-72 or %o1,%lo(LC0),%o0
-73 call _printf,0
-74 nop
+71 sethi %hi(LC0),%o1
+72 or %o1,%lo(LC0),%o0
+73 call _printf,0
+74 nop
75 .stabn 68,0,26,LM4
76 LM4:
-@exdent label for the N_RBRAC (end block) stab marking the end of the for loop
+@exdent label for the @code{N_RBRAC} (end block) stab marking the end of the @code{for} loop
77 LBE3:
+@end example
-@exdent Second code range for source line 23, 'for' loop increment and return
-
-@exdent <68> N_SLINE - source line number associated with this code
+@noindent
+Now we come to the second code range for source line 23, the @code{for}
+loop increment and return. Once again, @code{N_SLINE} (68) records the
+source line number:
-@exdent .stabn, SLINE, NIL, line_number, code_address_of_line_continuation.
+@example
+.stabn, N_SLINE, NIL,
+ @var{line},
+ @var{address}
78 .stabn 68,0,23,LM5
79 LM5:
80 L4:
-81 ld [%fp-20],%o0
-82 add %o0,1,%o1
-83 st %o1,[%fp-20]
-84 b,a L2
+81 ld [%fp-20],%o0
+82 add %o0,1,%o1
+83 st %o1,[%fp-20]
+84 b,a L2
85 L3:
86 .stabn 68,0,27,LM6
87 LM6:
-@exdent label for the N_RBRAC (end block) stab marking the end of the for loop
+@exdent label for the @code{N_RBRAC} (end block) stab marking the end of the @code{for} loop
88 LBE2:
89 .stabn 68,0,27,LM7
90 LM7:
91 L1:
-92 ret
-93 restore
+92 ret
+93 restore
94 .stabs "main:F1",36,0,0,_main
95 .stabs "argc:p1",160,0,0,68
96 .stabs "argv:p20=*21=*2",160,0,0,72
97 .stabs "s_flap:V12",40,0,0,_s_flap.0
98 .stabs "times:1",128,0,0,-20
+@end example
+
+@noindent
+Here is an illustration of stabs describing nested scopes. The scope
+nesting is reflected in the nested bracketing stabs (@code{N_LBRAC},
+192, appears here).
-@exdent stabs describing nested scopes, the stabs are nested like the scopes are.
-@exdent <192> N_LBRAC - left brace, begin lexical block (scope)
-@exdent .stabn N_LBRAC,NIL,NIL,code_addr_of_block_start
+@example
+.stabn N_LBRAC,NIL,NIL,
+ @var{block-start-address}
99 .stabn 192,0,0,LBB2 ## begin proc label
100 .stabs "inner:1",128,0,0,-24
101 .stabn 192,0,0,LBB3 ## begin for label
+@end example
-@exdent <224> N_RBRAC - right brace, end lexical block (scope)
-@exdent .stabn N_RBRAC,NIL,NIL,code_addr_of_block_end
+@noindent
+@code{N_RBRAC} (224), ``right brace'' ends a lexical block (scope).
+
+@example
+.stabn N_RBRAC,NIL,NIL,
+ @var{block-end-address}
102 .stabn 224,0,0,LBE3 ## end for label
103 .stabn 224,0,0,LBE2 ## end proc label
@node Automatic variables
@section Locally scoped automatic variables
-@example
-.stabs, stab type N_LSYM,
- symbol descriptor none
-@end example
+@table @strong
+@item Directive:
+@code{.stabs}
+@item Type:
+@code{N_LSYM}
+@item Symbol Descriptor:
+none
+@end table
-In addition to describing types, the N_LSYM stab type also describes
-locally scoped automatic variables. Refer again to the body of main
-in example2.c. It allocates two automatic variables, 'times' is
-scoped to the body of main and 'inner' is scoped to the body of the
-for loop. 's_flap' is locally scoped by not automatic and will be
-discussed later.
+In addition to describing types, the @code{N_LSYM} stab type also
+describes locally scoped automatic variables. Refer again to the body
+of @code{main} in @file{example2.c}. It allocates two automatic
+variables: @samp{times} is scoped to the body of @code{main}, and
+@samp{inner} is scoped to the body of the @code{for} loop.
+@samp{s_flap} is locally scoped but not automatic, and will be discussed
+later.
@example
20 @{
21 static float s_flap;
-22 int times;
-23 for (times=0; times < s_g_repeat; times++)@{
-24 int inner;
-25 printf ("Hello world\n");
-26 @}
+22 int times;
+23 for (times=0; times < s_g_repeat; times++)@{
+24 int inner;
+25 printf ("Hello world\n");
+26 @}
27 @};
@end example
-The N_LSYM stab for an automatic variable is located just before the
-N_LBRAC stab describing the open brace of the block to which it is
+The @code{N_LSYM} stab for an automatic variable is located just before the
+@code{N_LBRAC} stab describing the open brace of the block to which it is
scoped.
@example
- <128> N_LSYM - automatic variable, scoped locally to main
- .stabs "name:type_ref(int)", N_LSYM, NIL, NIL, frame_pointer_offset
+@exdent @code{N_LSYM} (128): automatic variable, scoped locally to @code{main}
+
+.stabs "@var{name}:
+ @var{type-ref}",
+ N_LSYM, NIL, NIL,
+ @var{frame-pointer-offset}
98 .stabs "times:1",128,0,0,-20
99 .stabn 192,0,0,LBB2 ## begin `main' N_LBRAC
- <128> N_LSYM - automatic variable, scoped locally to the for loop
- .stabs "name:type_ref(int)", N_LSYM, NIL, NIL, frame_pointer_offset
+@exdent @code{N_LSYM} (128): automatic variable, scoped locally to the @code{for} loop
+
+.stabs "@var{name}:
+ @var{type-ref}",
+ N_LSYM, NIL, NIL,
+ @var{frame-pointer-offset}
100 .stabs "inner:1",128,0,0,-24
101 .stabn 192,0,0,LBB3 ## begin `for' loop N_LBRAC
Since the character in the string field following the colon is not a
letter, there is no symbol descriptor. This means that the stab
describes a local variable, and that the number after the colon is a
-type reference. In this case it a a reference to the basic type int.
+type reference. In this case it a a reference to the basic type @code{int}.
Notice also that the frame pointer offset is negative number for
automatic variables.
@node Global Variables
@section Global Variables
-@example
-.stabs, stab type N_GSYM,
- symbol descriptor G
-@end example
+@table @strong
+@item Directive:
+@code{.stabs}
+@item Type:
+@code{N_GSYM}
+@item Symbol Descriptor:
+@code{G}
+@end table
-Global variables are represented by the N_GSYM stab type. The symbol
-descriptor, following the colon in the string field, is G. Following
-the G is a type reference or type definition. In this example it is a
-type reference to the basic C type, char. The first source line in
-example2.c
+Global variables are represented by the @code{N_GSYM} stab type. The symbol
+descriptor, following the colon in the string field, is @samp{G}. Following
+the @samp{G} is a type reference or type definition. In this example it is a
+type reference to the basic C type, @code{char}. The first source line in
+@file{example2.c},
@example
1 char g_foo = 'c';
@end example
-yields the following stab. The stab immediatly preceeds the code that
+@noindent
+yields the following stab. The stab immediately precedes the code that
allocates storage for the variable it describes.
@example
- <32> N_GSYM - global symbol
- "name:sym_descriptor(Global)type_ref(char)", N_GSYM, NIL, NIL, NIL
-@end example
+@exdent @code{N_GSYM} (32): global symbol
+
+.stabs "@var{name}:
+ @var{descriptor}
+ @var{type-ref}",
+ N_GSYM, NIL, NIL, NIL
-@example
21 .stabs "g_foo:G2",32,0,0,0
-22 .global _g_foo
-23 .data
+22 .global _g_foo
+23 .data
24 _g_foo:
-25 .byte 99
+25 .byte 99
@end example
-The address of the variable represented by the N_GSYM is not contained
-in the N_GSYM stab. The debugger gets this information from the
+The address of the variable represented by the @code{N_GSYM} is not contained
+in the @code{N_GSYM} stab. The debugger gets this information from the
external symbol for the global variable.
@node Register variables
-@section Register variables
-
-@example
-.stabs, stab type N_RSYM,
- symbol descriptor r
-@end example
+@section Global register variables
+
+@table @strong
+@item Directive:
+@code{.stabs}
+@item Type:
+@code{N_RSYM}
+@item Symbol Descriptor:
+@code{r}
+@end table
-The following source line defines a global variable, g_bar, which is
-allocated in global register %g5.
+The following source line defines a global variable, @code{g_bar}, which is
+explicitly allocated in global register @code{%g5}.
@example
2 register int g_bar asm ("%g5");
@end example
-Register variables have their own stab type, N_RSYM, and their own
-symbol descriptor, r. The stab's value field contains the number of
+Register variables have their own stab type, @code{N_RSYM}, and their own
+symbol descriptor, @code{r}. The stab's value field contains the number of
the register where the variable data will be stored. Since the
variable was not initialized in this compilation unit, the stab is
emited at the end of the object file, with the stabs for other
-uninitialized globals (bcc).
+uninitialized globals (@code{bcc}).
@example
- <64> N_RSYM - register variable
- .stabs "name:sym_desc(reg_var)type_ref(int), N_RSYM, NIL, NIL, reg_num
+@exdent @code{N_RSYM} (64): register variable
+
+.stabs "@var{name}:
+ @var{descriptor}
+ @var{type-ref}",
+ N_RSYM, NIL, NIL,
+ @var{register}
133 .stabs "g_bar:r1",64,0,0,5
@end example
@node Initialized statics
@section Initialized static variables
-@example
-.stabs, stab type N_STSYM,
- symbol descriptors S (file scope), V (procedure scope)
-@end example
+@table @strong
+@item Directive:
+@code{.stabs}
+@item Type:
+@code{N_STSYM}
+@item Symbol Descriptors:
+@code{S} (file scope), @code{V} (procedure scope)
+@end table
-Initialized static variables are represented by the N_STSYM stab type.
-The symbol descriptor part of the string field shows if the variable
-is file scope static (S) or procedure scope static (V). The source
-line:
+Initialized static variables are represented by the @code{N_STSYM} stab
+type. The symbol descriptor part of the string field shows if the
+variable is file scope static (@samp{S}) or procedure scope static
+(@samp{V}). The source line
@example
3 static int s_g_repeat = 2;
@end example
-yields the following code. The stab is located immediatly preceeding
+@noindent
+yields the following code. The stab is located immediately preceding
the storage for the variable it represents. Since the variable in
-this example is file scope static the symbol descriptor is S.
+this example is file scope static the symbol descriptor is @samp{S}.
@example
- <38> N_STSYM - initialized static variable (data seg w/internal linkage)
- .stabs "name:sym_desc(static_global)type_ref(int)",N_STSYM,NIL,NIL,var_addr
-@end example
-
-@example
+@exdent @code{N_STSYM} (38): initialized static variable (data seg w/internal linkage)
+
+.stabs "@var{name}:
+ @var{descriptor}
+ @var{type-ref}",
+ N_STSYM,NIL,NIL,
+ @var{address}
+
26 .stabs "s_g_repeat:S1",38,0,0,_s_g_repeat
-27 .align 4
+27 .align 4
28 _s_g_repeat:
-29 .word 2
+29 .word 2
@end example
@node Un-initialized statics
@section Un-initialized static variables
-@example
-.stabs, stab type N_LCSYM,
- symbol descriptors S (file scope), V (procedure scope)
-@end example
+@table @strong
+@item Directive:
+@code{.stabs}
+@item Type:
+@code{N_LCSYM}
+@item Symbol Descriptors:
+@code{S} (file scope), @code{V} (procedure scope)
+@end table
-Un-initilized static variables are represeted by the N_LCSYM stab
-type. The symbol descriptor part of the string shows if the variable
-is file scope static (S) or procedure scope static (V). In this
-example it is procedure scope static. The source line allocating
-s_flap immediatly follows the open brace for the procedure main.
+Un-initialized static variables are represented by the @code{N_LCSYM}
+stab type. The symbol descriptor part of the string shows if the
+variable is file scope static (@samp{S}) or procedure scope static
+(@samp{V}). In this example it is procedure scope static. The source
+line allocating @code{s_flap} immediately follows the open brace for the
+procedure @code{main}.
@example
20 @{
21 static float s_flap;
@end example
-
-The code that reserves storage for the variable s_flap preceeds the
-body of body of main.
+The code that reserves storage for the variable @code{s_flap} precedes the
+body of body of @code{main}.
@example
-39 .reserve _s_flap.0,4,"bss",4
+39 .reserve _s_flap.0,4,"bss",4
@end example
-But since s_flap is scoped locally to main, its stab is located with
-the other stabs representing symbols local to main. The stab for
-s_flap is located just before the N_LBRAC for main.
+But since @code{s_flap} is scoped locally to @code{main}, its stab is
+located with the other stabs representing symbols local to @code{main}.
+The stab for @code{s_flap} is located just before the @code{N_LBRAC} for
+@code{main}.
@example
- <40> N_LCSYM - un-initialized static var (BSS seg w/internal linkage)
- .stabs "name:sym_desc(static_local)type_ref(float)", N_LCSYM,
- NIL, NIL, data_addr
-@end example
+@exdent @code{N_LCSYM} (40): uninitialized static var (BSS seg w/internal linkage)
+
+.stabs "@var{name}:
+ @var{descriptor}
+ @var{type-ref}",
+ N_LCSYM, NIL, NIL,
+ @var{address}
-@example
97 .stabs "s_flap:V12",40,0,0,_s_flap.0
98 .stabs "times:1",128,0,0,-20
-99 .stabn 192,0,0,LBB2 # N_LBRAC for main.
+99 .stabn 192,0,0,LBB2 # N_LBRAC for main.
@end example
+@c ............................................................
+
@node Parameters
@section Parameters
-@example
-.stabs, stab type N_PSYM,
- symbol descriptor p
-@end example
+@table @strong
+@item Directive:
+@code{.stabs}
+@item Type:
+@code{N_PSYM}
+@item Symbol Descriptor:
+@code{p}
+@end table
Procedure parameters are represented by the N_PSYM stab type. The
following source lines show the parameters of the main routine.
The N_PSYM stabs describing parameters to a function directly follow
the N_FUN stab that represents the procedure itself. The N_FUN stab
-immediatly follows the code of the procedure it describes. Following
+immediately follows the code of the procedure it describes. Following
the N_PSYM parameter stabs are any N_LSYM stabs representing local
variables.
@node Arrays
@section Array types
-.stabs, stab types N_GSYM, N_LSYM,
-
- symbol descriptor T, type descriptor ar
+@table @strong
+@item Directive:
+@code{.stabs}
+@item Types:
+@code{N_GSYM}, @code{N_LSYM}
+@item Symbol Descriptor:
+@code{T}
+@item Type Descriptor:
+@code{ar}
+@end table
As an example of an array type consider the global variable below.
@exdent N_GSYM, NIL, NIL, NIL
32 .stabs "char_vec:G19=ar1;0;2;2",32,0,0,0
-33 .global _char_vec
-34 .align 4
+33 .global _char_vec
+34 .align 4
35 _char_vec:
-36 .byte 97
-37 .byte 98
-38 .byte 99
+36 .byte 97
+37 .byte 98
+38 .byte 99
@end example
@node Enumerations
@section Enumerations
-@display
-.stabs, stab type N_LSYM,
- symbol descriptor T, type descriptor e
-@end display
+@table @strong
+@item Directive:
+@code{.stabs}
+@item Type:
+@code{N_LSYM}
+@item Symbol Descriptor:
+@code{T}
+@item Type Descriptor:
+@code{e}
+@end table
The source line below declares an enumeration type. It is defined at
file scope between the bodies of main and s_proc in example2.c.
<128> N_LSYM - local symbol
.stab "name:sym_dec(type)type_def(22)=sym_desc(enum)
enum_name:value(0),enum_name:value(3),enum_name:value(4),;",
- N_LSYM, NIL, NIL, NIL
+ N_LSYM, NIL, NIL, NIL
@end display
@example
@node Structure tags
@section Structure Tags
-@display
-.stabs, stab type N_LSYM,
- symbol descriptor T, type descriptor s
-@end display
+@table @strong
+@item Directive:
+@code{.stabs}
+@item Type:
+@code{N_LSYM}
+@item Symbol Descriptor:
+@code{T}
+@item Type Descriptor:
+@code{s}
+@end table
The following source code declares a structure tag and defines an
instance of the structure in global scope. Then a typedef equates the
@example
<128> N_LSYM - type definition
.stabs "name:sym_desc(struct tag) Type_def(16)=type_desc(struct type)
- struct_bytes
+ struct_bytes
elem_name:type_ref(int),bit_offset,field_bits;
- elem_name:type_ref(float),bit_offset,field_bits;
- elem_name:type_def(17)=type_desc(dynamic array) index_type(int);NIL;
- high_bound(7);element_type(char),bit_offset,field_bits;;",
- N_LSYM,NIL,NIL,NIL
+ elem_name:type_ref(float),bit_offset,field_bits;
+ elem_name:type_def(17)=type_desc(dynamic array) index_type(int);NIL;
+ high_bound(7);element_type(char),bit_offset,field_bits;;",
+ N_LSYM,NIL,NIL,NIL
30 .stabs "s_tag:T16=s20s_int:1,0,32;s_float:12,32,32;
- s_char_vec:17=ar1;0;7;2,64,64;s_next:18=*16,128,32;;",128,0,0,0
+ s_char_vec:17=ar1;0;7;2,64,64;s_next:18=*16,128,32;;",128,0,0,0
@end example
In this example, two of the structure elements are previously defined
@node Typedefs
@section Typedefs
-@display
-.stabs, stab type N_LSYM,
- symbol descriptor t
-@end display
+@table @strong
+@item Directive:
+@code{.stabs}
+@item Type:
+@code{N_LSYM}
+@item Symbol Descriptor:
+@code{t}
+@end table
Here is the stab for the typedef equating the structure tag with a
type.
@example
136 .stabs "g_an_s:G16",32,0,0,0
-137 .common _g_an_s,20,"bss"
+137 .common _g_an_s,20,"bss"
@end example
Notice that the structure tag has the same type number as the typedef
@node Unions
@section Unions
-@display
-.stabs, stab type N_LSYM,
- symbol descriptor T, type descriptor u
-@end display
+@table @strong
+@item Directive:
+@code{.stabs}
+@item Type:
+@code{N_LSYM}
+@item Symbol Descriptor:
+@code{T}
+@item Type Descriptor:
+@code{u}
+@end table
Next let's look at unions. In example2 this union type is declared
locally to a procedure and an instance of the union is defined.
This code generates a stab for the union tag and a stab for the union
variable. Both use the N_LSYM stab type. Since the union variable is
scoped locally to the procedure in which it is defined, its stab is
-located immediatly preceeding the N_LBRAC for the procedure's block
+located immediately preceding the N_LBRAC for the procedure's block
start.
-The stab for the union tag, however is located preceeding the code for
+The stab for the union tag, however is located preceding the code for
the procedure in which it is defined. The stab type is N_LSYM. This
would seem to imply that the union type is file scope, like the struct
type s_tag. This is not true. The contents and position of the stab
@display
<32> N_GSYM - global variable
.stabs "name:sym_desc(global)type_def(24)=ptr_to(25)=
- type_def(func)type_ref(int)
+ type_def(func)type_ref(int)
@end display
@example
134 .stabs "g_pf:G24=*25=f1",32,0,0,0
-135 .common _g_pf,4,"bss"
+135 .common _g_pf,4,"bss"
@end example
Since the variable is global, the stab type is N_GSYM and the symbol
@example
struct internal_nlist @{
- unsigned long n_strx; /* index into string table of name */
- unsigned char n_type; /* type of symbol */
- unsigned char n_other; /* misc info (usually empty) */
- unsigned short n_desc; /* description field */
- bfd_vma n_value; /* value of symbol */
+ unsigned long n_strx; /* index into string table of name */
+ unsigned char n_type; /* type of symbol */
+ unsigned char n_other; /* misc info (usually empty) */
+ unsigned short n_desc; /* description field */
+ bfd_vma n_value; /* value of symbol */
@};
@end example
@display
.stabs "struct_name:sym_desc(type)type_def(17)=type_desc(struct)struct_bytes(8)
- elem_name(delta):type_ref(short int),bit_offset(0),field_bits(16);
- elem_name(index):type_ref(short int),bit_offset(16),field_bits(16);
- elem_name(pfn):type_def(18)=type_desc(ptr to)type_ref(void),
- bit_offset(32),field_bits(32);
- elem_name(delta2):type_def(short int);bit_offset(32),field_bits(16);;"
- N_LSYM, NIL, NIL
+ elem_name(delta):type_ref(short int),bit_offset(0),field_bits(16);
+ elem_name(index):type_ref(short int),bit_offset(16),field_bits(16);
+ elem_name(pfn):type_def(18)=type_desc(ptr to)type_ref(void),
+ bit_offset(32),field_bits(32);
+ elem_name(delta2):type_def(short int);bit_offset(32),field_bits(16);;"
+ N_LSYM, NIL, NIL
@end display
-
+
@smallexample
.stabs "$vtbl_ptr_type:t17=s8
- delta:6,0,16;index:6,16,16;pfn:18=*15,32,32;delta2:6,32,16;;"
- ,128,0,0,0
+ delta:6,0,16;index:6,16,16;pfn:18=*15,32,32;delta2:6,32,16;;"
+ ,128,0,0,0
@end smallexample
@display
@example
class baseA @{
public:
- int Adat;
- int Ameth(int in, char other);
+ int Adat;
+ int Ameth(int in, char other);
@};
@end example
@display
.stabs "class_name:sym_desc(type)type_def(20)=type_desc(struct)struct_bytes(4)
- field_name(Adat):type(int),bit_offset(0),field_bits(32);
+ field_name(Adat):type(int),bit_offset(0),field_bits(32);
- method_name(Ameth)::type_def(21)=type_desc(method)return_type(int);
- :arg_types(int char);
- protection(public)qualifier(normal)virtual(no);;"
- N_LSYM,NIL,NIL,NIL
+ method_name(Ameth)::type_def(21)=type_desc(method)return_type(int);
+ :arg_types(int char);
+ protection(public)qualifier(normal)virtual(no);;"
+ N_LSYM,NIL,NIL,NIL
@end display
@smallexample
@example
main () @{
- baseA AbaseA;
+ baseA AbaseA;
@}
@end example
int
baseA::Ameth(int in, char other)
@{
- return in;
+ return in;
@};
@end example
@example
.stabs "name:symbol_desriptor(global function)return_type(int)",
- N_FUN, NIL, NIL, code_addr_of_method_start
+ N_FUN, NIL, NIL, code_addr_of_method_start
.stabs "Ameth__5baseAic:F1",36,0,0,_Ameth__5baseAic
@end example
@example
.stabs "name:sym_desc(register param)type_def(19)=
- type_desc(ptr to)type_ref(baseA)=
+ type_desc(ptr to)type_ref(baseA)=
type_desc(cross-reference to)baseA:",N_RSYM,NIL,NIL,register_number
.stabs "$t:P19=*20=xsbaseA:",64,0,0,8
@example
.stabs "name:sym_desc(value parameter)type_ref(int)",
- N_PSYM,NIL,NIL,offset_from_arg_ptr
+ N_PSYM,NIL,NIL,offset_from_arg_ptr
.stabs "in:p1",160,0,0,72
@end example
@example
class all_data @{
-private:
- int priv_dat;
+private:
+ int priv_dat;
protected:
- char prot_dat;
+ char prot_dat;
public:
- float pub_dat;
+ float pub_dat;
@};
@end example
@display
.stabs "class_name:sym_desc(type)type_def(19)=type_desc(struct)struct_bytes
- data_name:/protection(private)type_ref(int),bit_offset,num_bits;
- data_name:/protection(protected)type_ref(char),bit_offset,num_bits;
- data_name:(/num omited, private)type_ref(float),bit_offset,num_bits;;"
- N_LSYM,NIL,NIL,NIL
+ data_name:/protection(private)type_ref(int),bit_offset,num_bits;
+ data_name:/protection(protected)type_ref(char),bit_offset,num_bits;
+ data_name:(/num omited, private)type_ref(float),bit_offset,num_bits;;"
+ N_LSYM,NIL,NIL,NIL
@end display
@smallexample
.stabs "all_data:t19=s12
- priv_dat:/01,0,32;prot_dat:/12,32,8;pub_dat:12,64,32;;",128,0,0,0
+ priv_dat:/01,0,32;prot_dat:/12,32,8;pub_dat:12,64,32;;",128,0,0,0
@end smallexample
Protections for member functions are signified by one digit embeded in
@example
class all_methods @{
private:
- int priv_meth(int in)@{return in;@};
+ int priv_meth(int in)@{return in;@};
protected:
- char protMeth(char in)@{return in;@};
+ char protMeth(char in)@{return in;@};
public:
- float pubMeth(float in)@{return in;@};
+ float pubMeth(float in)@{return in;@};
@};
@end example
@display
.stabs "class_name:sym_desc(struct tag&type)type_def(21)=
- sym_desc(struct)struct_bytes(1)
- meth_name::type_def(22)=sym_desc(method)returning(int);
- :args(int);protection(private)modifier(normal)virtual(no);
- meth_name::type_def(23)=sym_desc(method)returning(char);
- :args(char);protection(protected)modifier(normal)virual(no);
- meth_name::type_def(24)=sym_desc(method)returning(float);
- :args(float);protection(public)modifier(normal)virtual(no);;",
- N_LSYM,NIL,NIL,NIL
+ sym_desc(struct)struct_bytes(1)
+ meth_name::type_def(22)=sym_desc(method)returning(int);
+ :args(int);protection(private)modifier(normal)virtual(no);
+ meth_name::type_def(23)=sym_desc(method)returning(char);
+ :args(char);protection(protected)modifier(normal)virual(no);
+ meth_name::type_def(24)=sym_desc(method)returning(float);
+ :args(float);protection(public)modifier(normal)virtual(no);;",
+ N_LSYM,NIL,NIL,NIL
@end display
-
+
@smallexample
.stabs "all_methods:Tt21=s1priv_meth::22=##1;:i;0A.;protMeth::23=##2;:c;1A.;
- pubMeth::24=##12;:f;2A.;;",128,0,0,0
+ pubMeth::24=##12;:f;2A.;;",128,0,0,0
@end smallexample
@node Method Modifiers
@example
class A @{
public:
- int ConstMeth (int arg) const @{ return arg; @};
- char VolatileMeth (char arg) volatile @{ return arg; @};
- float ConstVolMeth (float arg) const volatile @{return arg; @};
+ int ConstMeth (int arg) const @{ return arg; @};
+ char VolatileMeth (char arg) volatile @{ return arg; @};
+ float ConstVolMeth (float arg) const volatile @{return arg; @};
@};
@end example
@display
.stabs "class(A):sym_desc(struct)type_def(20)=type_desc(struct)struct_bytes(1)
- meth_name(ConstMeth)::type_def(21)sym_desc(method)
- returning(int);:arg(int);protection(public)modifier(const)virtual(no);
- meth_name(VolatileMeth)::type_def(22)=sym_desc(method)
- returning(char);:arg(char);protection(public)modifier(volatile)virt(no)
- meth_name(ConstVolMeth)::type_def(23)=sym_desc(method)
- returning(float);:arg(float);protection(public)modifer(const volatile)
- virtual(no);;", @dots{}
+ meth_name(ConstMeth)::type_def(21)sym_desc(method)
+ returning(int);:arg(int);protection(public)modifier(const)virtual(no);
+ meth_name(VolatileMeth)::type_def(22)=sym_desc(method)
+ returning(char);:arg(char);protection(public)modifier(volatile)virt(no)
+ meth_name(ConstVolMeth)::type_def(23)=sym_desc(method)
+ returning(float);:arg(float);protection(public)modifer(const volatile)
+ virtual(no);;", @dots{}
@end display
-
+
@example
.stabs "A:T20=s1ConstMeth::21=##1;:i;2B.;VolatileMeth::22=##2;:c;2C.;
- ConstVolMeth::23=##12;:f;2D.;;",128,0,0,0
+ ConstVolMeth::23=##12;:f;2D.;;",128,0,0,0
@end example
@node Virtual Methods
@example
class A @{
public:
- int Adat;
- virtual int A_virt (int arg) @{ return arg; @};
+ int Adat;
+ virtual int A_virt (int arg) @{ return arg; @};
@};
@end example
@display
.stabs "class_name(A):type_def(20)=sym_desc(struct)struct_bytes(8)
- field_name(Adat):type_ref(int),bit_offset(0),field_bits(32);
- field_name(A virt func ptr):type_def(21)=type_desc(ptr to)type_def(22)=
- sym_desc(array)index_type_ref(int);NIL;elem_type_ref(vtbl elem type);
- bit_offset(32);
- meth_name(A_virt)::typedef(23)=sym_desc(method)returning(int);
- :arg_type(int),protection(public)normal(yes)virtual(yes)
- vtable_index(1);class_first_defining(A);;;~%first_base(A);",
- N_LSYM,NIL,NIL,NIL
+ field_name(Adat):type_ref(int),bit_offset(0),field_bits(32);
+ field_name(A virt func ptr):type_def(21)=type_desc(ptr to)type_def(22)=
+ sym_desc(array)index_type_ref(int);NIL;elem_type_ref(vtbl elem type);
+ bit_offset(32);
+ meth_name(A_virt)::typedef(23)=sym_desc(method)returning(int);
+ :arg_type(int),protection(public)normal(yes)virtual(yes)
+ vtable_index(1);class_first_defining(A);;;~%first_base(A);",
+ N_LSYM,NIL,NIL,NIL
@end display
@example
@example
class A @{
public:
- int Adat;
- virtual int A_virt (int arg) @{ return arg; @};
+ int Adat;
+ virtual int A_virt (int arg) @{ return arg; @};
@};
class B @{
public:
- int B_dat;
- virtual int B_virt (int arg) @{return arg; @};
+ int B_dat;
+ virtual int B_virt (int arg) @{return arg; @};
@};
class C @{
public:
- int Cdat;
- virtual int C_virt (int arg) @{return arg; @};
+ int Cdat;
+ virtual int C_virt (int arg) @{return arg; @};
@};
class D : A, virtual B, public C @{
public:
- int Ddat;
- virtual int A_virt (int arg ) @{ return arg+1; @};
- virtual int B_virt (int arg) @{ return arg+2; @};
- virtual int C_virt (int arg) @{ return arg+3; @};
- virtual int D_virt (int arg) @{ return arg; @};
+ int Ddat;
+ virtual int A_virt (int arg ) @{ return arg+1; @};
+ virtual int B_virt (int arg) @{ return arg+2; @};
+ virtual int C_virt (int arg) @{ return arg+3; @};
+ virtual int D_virt (int arg) @{ return arg; @};
@};
@end example
@display
.stabs "derived_class_name:symbol_descriptors(struct tag&type)=
- type_descriptor(struct)struct_bytes(32)!num_bases(3),
- base_virtual(no)inheritence_public(no)base_offset(0),
- base_class_type_ref(A);
- base_virtual(yes)inheritence_public(no)base_offset(NIL),
- base_class_type_ref(B);
- base_virtual(no)inheritence_public(yes)base_offset(64),
- base_class_type_ref(C); @dots{}
+ type_descriptor(struct)struct_bytes(32)!num_bases(3),
+ base_virtual(no)inheritence_public(no)base_offset(0),
+ base_class_type_ref(A);
+ base_virtual(yes)inheritence_public(no)base_offset(NIL),
+ base_class_type_ref(B);
+ base_virtual(no)inheritence_public(yes)base_offset(64),
+ base_class_type_ref(C); @dots{}
@end display
-
+
@c FIXME! fake linebreaks.
@smallexample
.stabs "D:Tt31=s32!3,000,20;100,25;0264,28;$vb25:24,128;Ddat:
19 char* argv[];
20 @{
21 static float s_flap;
-22 int times;
-23 for (times=0; times < s_g_repeat; times++)@{
-24 int inner;
-25 printf ("Hello world\n");
-26 @}
+22 int times;
+23 for (times=0; times < s_g_repeat; times++)@{
+24 int inner;
+25 printf ("Hello world\n");
+26 @}
27 @};
28
29 enum e_places @{first,second=3,last@};
1 gcc2_compiled.:
2 .stabs "/cygint/s1/users/jcm/play/",100,0,0,Ltext0
3 .stabs "example2.c",100,0,0,Ltext0
-4 .text
+4 .text
5 Ltext0:
6 .stabs "int:t1=r1;-2147483648;2147483647;",128,0,0,0
7 .stabs "char:t2=r2;0;127;",128,0,0,0
19 .stabs "long double:t14=r1;8;0;",128,0,0,0
20 .stabs "void:t15=15",128,0,0,0
21 .stabs "g_foo:G2",32,0,0,0
-22 .global _g_foo
-23 .data
+22 .global _g_foo
+23 .data
24 _g_foo:
-25 .byte 99
+25 .byte 99
26 .stabs "s_g_repeat:S1",38,0,0,_s_g_repeat
-27 .align 4
+27 .align 4
28 _s_g_repeat:
-29 .word 2
+29 .word 2
@c FIXME! fake linebreak in line 30
30 .stabs "s_tag:T16=s20s_int:1,0,32;s_float:12,32,32;s_char_vec:
17=ar1;0;7;2,64,64;s_next:18=*16,128,32;;",128,0,0,0
31 .stabs "s_typedef:t16",128,0,0,0
32 .stabs "char_vec:G19=ar1;0;2;2",32,0,0,0
-33 .global _char_vec
-34 .align 4
+33 .global _char_vec
+34 .align 4
35 _char_vec:
-36 .byte 97
-37 .byte 98
-38 .byte 99
-39 .reserve _s_flap.0,4,"bss",4
-40 .text
-41 .align 4
+36 .byte 97
+37 .byte 98
+38 .byte 99
+39 .reserve _s_flap.0,4,"bss",4
+40 .text
+41 .align 4
42 LC0:
-43 .ascii "Hello world\12\0"
-44 .align 4
-45 .global _main
-46 .proc 1
+43 .ascii "Hello world\12\0"
+44 .align 4
+45 .global _main
+46 .proc 1
47 _main:
48 .stabn 68,0,20,LM1
49 LM1:
-50 !#PROLOGUE# 0
-51 save %sp,-144,%sp
-52 !#PROLOGUE# 1
-53 st %i0,[%fp+68]
-54 st %i1,[%fp+72]
-55 call ___main,0
-56 nop
+50 !#PROLOGUE# 0
+51 save %sp,-144,%sp
+52 !#PROLOGUE# 1
+53 st %i0,[%fp+68]
+54 st %i1,[%fp+72]
+55 call ___main,0
+56 nop
57 LBB2:
58 .stabn 68,0,23,LM2
59 LM2:
-60 st %g0,[%fp-20]
+60 st %g0,[%fp-20]
61 L2:
-62 sethi %hi(_s_g_repeat),%o0
-63 ld [%fp-20],%o1
-64 ld [%o0+%lo(_s_g_repeat)],%o0
-65 cmp %o1,%o0
-66 bge L3
-67 nop
+62 sethi %hi(_s_g_repeat),%o0
+63 ld [%fp-20],%o1
+64 ld [%o0+%lo(_s_g_repeat)],%o0
+65 cmp %o1,%o0
+66 bge L3
+67 nop
68 LBB3:
69 .stabn 68,0,25,LM3
70 LM3:
-71 sethi %hi(LC0),%o1
-72 or %o1,%lo(LC0),%o0
-73 call _printf,0
-74 nop
+71 sethi %hi(LC0),%o1
+72 or %o1,%lo(LC0),%o0
+73 call _printf,0
+74 nop
75 .stabn 68,0,26,LM4
76 LM4:
77 LBE3:
78 .stabn 68,0,23,LM5
79 LM5:
80 L4:
-81 ld [%fp-20],%o0
-82 add %o0,1,%o1
-83 st %o1,[%fp-20]
-84 b,a L2
+81 ld [%fp-20],%o0
+82 add %o0,1,%o1
+83 st %o1,[%fp-20]
+84 b,a L2
85 L3:
86 .stabn 68,0,27,LM6
87 LM6:
89 .stabn 68,0,27,LM7
90 LM7:
91 L1:
-92 ret
-93 restore
+92 ret
+93 restore
94 .stabs "main:F1",36,0,0,_main
95 .stabs "argc:p1",160,0,0,68
96 .stabs "argv:p20=*21=*2",160,0,0,72
@c FIXME: fake linebreak in line 105
105 .stabs "u_tag:T23=u4u_int:1,0,32;u_float:12,0,32;u_char:21,0,32;;",
128,0,0,0
-106 .align 4
-107 .proc 1
+106 .align 4
+107 .proc 1
108 _s_proc:
109 .stabn 68,0,35,LM8
110 LM8:
-111 !#PROLOGUE# 0
-112 save %sp,-120,%sp
-113 !#PROLOGUE# 1
-114 mov %i0,%o0
-115 st %i1,[%fp+72]
-116 st %i2,[%fp+76]
+111 !#PROLOGUE# 0
+112 save %sp,-120,%sp
+113 !#PROLOGUE# 1
+114 mov %i0,%o0
+115 st %i1,[%fp+72]
+116 st %i2,[%fp+76]
117 LBB4:
118 .stabn 68,0,41,LM9
119 LM9:
121 .stabn 68,0,41,LM10
122 LM10:
123 L5:
-124 ret
-125 restore
+124 ret
+125 restore
126 .stabs "s_proc:f1",36,0,0,_s_proc
127 .stabs "s_arg:p16",160,0,0,0
128 .stabs "s_ptr_arg:p18",160,0,0,72
132 .stabn 224,0,0,LBE4
133 .stabs "g_bar:r1",64,0,0,5
134 .stabs "g_pf:G24=*25=f1",32,0,0,0
-135 .common _g_pf,4,"bss"
+135 .common _g_pf,4,"bss"
136 .stabs "g_an_s:G16",32,0,0,0
-137 .common _g_an_s,20,"bss"
+137 .common _g_an_s,20,"bss"
@end example
type type #define used to describe
dec hex name source program feature
------------------------------------------------
-32 0x20 N_GYSM global symbol
-34 0X22 N_FNAME function name (for BSD Fortran)
-36 0x24 N_FUN function name or text segment variable for C
-38 0x26 N_STSYM static symbol (data segment w/internal linkage)
-40 0x28 N_LCSYM .lcomm symbol(BSS-seg variable w/internal linkage)
-42 0x2a N_MAIN Name of main routine (not used in C)
-48 0x30 N_PC global symbol (for Pascal)
-50 0x32 N_NSYMS number of symbols (according to Ultrix V4.0)
-52 0x34 N_NOMAP no DST map for sym (according to Ultrix V4.0)
-64 0x40 N_RSYM register variable
-66 0x42 N_M2C Modula-2 compilation unit
-68 0x44 N_SLINE line number in text segment
-70 0x46 N_DSLINE line number in data segment
-
-72 0x48 N_BSLINE line number in bss segment
-72 0x48 N_BROWS Sun source code browser, path to .cb file
-
-74 0x4a N_DEFD GNU Modula2 definition module dependency
-
-80 0x50 N_EHDECL GNU C++ exception variable
-80 0x50 N_MOD2 Modula2 info "for imc" (according to Ultrix V4.0)
-
-84 0x54 N_CATCH GNU C++ "catch" clause
-96 0x60 N_SSYM structure of union element
-100 0x64 N_SO path and name of source file
-128 0x80 N_LSYM automatic var in the stack (also used for type desc.)
-130 0x82 N_BINCL beginning of an include file (Sun only)
-132 0x84 N_SOL Name of sub-source (#include) file.
-160 0xa0 N_PSYM parameter variable
-162 0xa2 N_EINCL end of an include file
-164 0xa4 N_ENTRY alternate entry point
-192 0xc0 N_LBRAC beginning of a lexical block
-194 0xc2 N_EXCL place holder for a deleted include file
-196 0xc4 N_SCOPE modula2 scope information (Sun linker)
-224 0xe0 N_RBRAC end of a lexical block
-226 0xe2 N_BCOMM begin named common block
-228 0xe4 N_ECOMM end named common block
-232 0xe8 N_ECOML end common (local name)
+32 0x20 N_GYSM global symbol
+34 0X22 N_FNAME function name (for BSD Fortran)
+36 0x24 N_FUN function name or text segment variable for C
+38 0x26 N_STSYM static symbol (data segment w/internal linkage)
+40 0x28 N_LCSYM .lcomm symbol(BSS-seg variable w/internal linkage)
+42 0x2a N_MAIN Name of main routine (not used in C)
+48 0x30 N_PC global symbol (for Pascal)
+50 0x32 N_NSYMS number of symbols (according to Ultrix V4.0)
+52 0x34 N_NOMAP no DST map for sym (according to Ultrix V4.0)
+64 0x40 N_RSYM register variable
+66 0x42 N_M2C Modula-2 compilation unit
+68 0x44 N_SLINE line number in text segment
+70 0x46 N_DSLINE line number in data segment
+
+72 0x48 N_BSLINE line number in bss segment
+72 0x48 N_BROWS Sun source code browser, path to .cb file
+
+74 0x4a N_DEFD GNU Modula2 definition module dependency
+
+80 0x50 N_EHDECL GNU C++ exception variable
+80 0x50 N_MOD2 Modula2 info "for imc" (according to Ultrix V4.0)
+
+84 0x54 N_CATCH GNU C++ "catch" clause
+96 0x60 N_SSYM structure of union element
+100 0x64 N_SO path and name of source file
+128 0x80 N_LSYM automatic var in the stack
+ (also used for type desc.)
+130 0x82 N_BINCL beginning of an include file (Sun only)
+132 0x84 N_SOL Name of sub-source (#include) file.
+160 0xa0 N_PSYM parameter variable
+162 0xa2 N_EINCL end of an include file
+164 0xa4 N_ENTRY alternate entry point
+192 0xc0 N_LBRAC beginning of a lexical block
+194 0xc2 N_EXCL place holder for a deleted include file
+196 0xc4 N_SCOPE modula2 scope information (Sun linker)
+224 0xe0 N_RBRAC end of a lexical block
+226 0xe2 N_BCOMM begin named common block
+228 0xe4 N_ECOMM end named common block
+232 0xe8 N_ECOML end common (local name)
<< used on Gould systems for non-base registers syms >>
-240 0xf0 N_NBTEXT ??
-242 0xf2 N_NBDATA ??
-244 0xf4 N_NBBSS ??
-246 0xf6 N_NBSTS ??
-248 0xf8 N_NBLCS ??
+240 0xf0 N_NBTEXT ??
+242 0xf2 N_NBDATA ??
+244 0xf4 N_NBBSS ??
+246 0xf6 N_NBSTS ??
+248 0xf8 N_NBLCS ??
@end smallexample
@node Assembler types
/include/aout/aout64.h
@smallexample
-dec hex #define
-n_type n_type name used to describe
+dec hex #define
+n_type n_type name used to describe
------------------------------------------
-1 0x0 N_UNDF undefined symbol
-2 0x2 N_ABS absolute symbol -- defined at a particular address
-3 0x3 extern " (vs. file scope)
-4 0x4 N_TEXT text symbol -- defined at offset in text segment
-5 0x5 extern " (vs. file scope)
-6 0x6 N_DATA data symbol -- defined at offset in data segment
-7 0x7 extern " (vs. file scope)
-8 0x8 N_BSS BSS symbol -- defined at offset in zero'd segment
-9 extern " (vs. file scope)
-
-12 0x0C N_FN_SEQ func name for Sequent compilers (stab exception)
-
-49 0x12 N_COMM common sym -- visable after shared lib dynamic link
-31 0x1f N_FN file name of a .o file
+1 0x0 N_UNDF undefined symbol
+2 0x2 N_ABS absolute symbol -- defined at a particular address
+3 0x3 extern " (vs. file scope)
+4 0x4 N_TEXT text symbol -- defined at offset in text segment
+5 0x5 extern " (vs. file scope)
+6 0x6 N_DATA data symbol -- defined at offset in data segment
+7 0x7 extern " (vs. file scope)
+8 0x8 N_BSS BSS symbol -- defined at offset in zero'd segment
+9 extern " (vs. file scope)
+
+12 0x0C N_FN_SEQ func name for Sequent compilers (stab exception)
+
+49 0x12 N_COMM common sym -- visable after shared lib dynamic link
+31 0x1f N_FN file name of a .o file
@end smallexample
@node Symbol descriptors
@section Table C: Symbol descriptors
@example
-descriptor meaning
+descriptor meaning
-------------------------------------------------
-(empty) local variable
- f local function
- F global function
- G global variable
- p value parameter
- r register variable
- S static global variable
- t type name
- T enumeration, struct or type tag
- V static local variable
+(empty) local variable
+ f local function
+ F global function
+ G global variable
+ p value parameter
+ r register variable
+ S static global variable
+ t type name
+ T enumeration, struct or type tag
+ V static local variable
@end example
@node Type Descriptors
@section Table D: Type Descriptors
@example
-descriptor meaning
+descriptor meaning
-------------------------------------
-(empty) type reference
- a array type
- e enumeration type
- f function type
- r range type
- s structure type
- u union specifications
- * pointer type
+(empty) type reference
+ a array type
+ e enumeration type
+ f function type
+ r range type
+ s structure type
+ u union specifications
+ * pointer type
@end example
@end menu
@node N_GSYM
-@section 32 - 0x20 - N_GYSM
+@section 32 - 0x20 - N_GYSM
@display
Global variable.
@example
"name" -> "symbol_name:#type"
- # -> G
+ # -> G
@end example
Only the "name" field is significant. the location of the variable is
obtained from the corresponding extern symbol.
@node N_FUN
-@section 36 - 0x24 - N_FUN
+@section 36 - 0x24 - N_FUN
Function name or text segment variable for C.
@display
@example
@exdent @emph{For functions:}
"name" -> "proc_name:#return_type"
- # -> F (global function)
- f (local function)
+ # -> F (global function)
+ f (local function)
desc -> line num for proc start. (GCC doesn't set and DBX doesn't miss it.)
value -> Code address of proc start.
@example
"name" -> "symbol_name#type"
- # -> S (scope global to compilation unit)
- -> V (scope local to a procedure)
+ # -> S (scope global to compilation unit)
+ -> V (scope local to a procedure)
value -> Data Address
@end example
@example
"name" -> "symbol_name#type"
- # -> S (scope global to compilation unit)
- -> V (scope local to procedure)
+ # -> S (scope global to compilation unit)
+ -> V (scope local to procedure)
value -> BSS Address
@end example
@node N_MAIN
-@section 42 - 0x2a - N_MAIN
+@section 42 - 0x2a - N_MAIN
Name of main routine (not used in C)
@display
@end example
@node N_PC
-@section 48 - 0x30 - N_PC
+@section 48 - 0x30 - N_PC
Global symbol (for Pascal)
@display
@end display
@node N_NSYMS
-@section 50 - 0x32 - N_NSYMS
+@section 50 - 0x32 - N_NSYMS
Number of symbols (according to Ultrix V4.0)
@display
- 0, files,,funcs,lines (stab.def)
+ 0, files,,funcs,lines (stab.def)
@end display
@node N_NOMAP
no DST map for sym (according to Ultrix V4.0)
@display
- name, ,0,type,ignored (stab.def)
+ name, ,0,type,ignored (stab.def)
@end display
@node N_RSYM
-@section 64 - 0x40 - N_RSYM
+@section 64 - 0x40 - N_RSYM
register variable
@display
@end display
@node N_M2C
-@section 66 - 0x42 - N_M2C
+@section 66 - 0x42 - N_M2C
Modula-2 compilation unit
@display
"name" -> "unit_name,unit_time_stamp[,code_time_stamp]
desc -> unit_number
value -> 0 (main unit)
- 1 (any other unit)
+ 1 (any other unit)
@end example
@node N_SLINE
-@section 68 - 0x44 - N_SLINE
+@section 68 - 0x44 - N_SLINE
Line number in text segment
@display
See comment for N_SLINE above.
@node N_BROWS
-@section 72 - 0x48 - N_BROWS
+@section 72 - 0x48 - N_BROWS
Sun source code browser, path to .cb file
<<?>>
Note: type field value overlaps with N_BSLINE
@node N_DEFD
-@section 74 - 0x4a - N_DEFD
+@section 74 - 0x4a - N_DEFD
GNU Modula2 definition module dependency
GNU Modula-2 definition module dependency. Value is the modification
are caught here.
@node N_SSYM
-@section 96 - 0x60 - N_SSYM
+@section 96 - 0x60 - N_SSYM
Structure or union element
Value is offset in the structure.
<<?looking at structs and unions in C I didn't see these>>
@node N_SO
-@section 100 - 0x64 - N_SO
+@section 100 - 0x64 - N_SO
Path and name of source file containing main routine
@display
N_SO contains the terminal name of the source file itself.
@node N_LSYM
-@section 128 - 0x80 - N_LSYM
+@section 128 - 0x80 - N_LSYM
Automatic var in the stack (also used for type descriptors.)
@display
@exdent @emph{For type descriptors:}
"name" -> "name_of_the_type:#type"
- # -> t
+ # -> t
-type -> type_ref (or) type_def
+type -> type_ref (or) type_def
type_ref -> type_number
type_def -> type_number=type_desc etc.
section on types for what data follows each type descriptor.
@node N_BINCL
-@section 130 - 0x82 - N_BINCL
+@section 130 - 0x82 - N_BINCL
Beginning of an include file (Sun only)
<<?>>
@node N_PSYM
-@section 160 - 0xa0 - N_PSYM
+@section 160 - 0xa0 - N_PSYM
Parameter variable
@example
"name" -> "param_name:#type"
- # -> p (value parameter)
- -> i (value parameter by reference, indirect access)
- -> v (variable parameter by reference)
- -> C ( read-only parameter, conformant array bound)
- -> x (confomant array value parameter)
- -> pP (<<??>>)
- -> pF (<<??>>)
- -> X (function result variable)
- -> b (based variable)
+ # -> p (value parameter)
+ -> i (value parameter by reference, indirect access)
+ -> v (variable parameter by reference)
+ -> C ( read-only parameter, conformant array bound)
+ -> x (confomant array value parameter)
+ -> pP (<<??>>)
+ -> pF (<<??>>)
+ -> X (function result variable)
+ -> b (based variable)
value -> offset from the argument pointer (positive).
@end example
<<?>>
@node N_RBRAC
-@section 224 - 0xe0 - N_RBRAC
+@section 224 - 0xe0 - N_RBRAC
End of a lexical block (right brace)
@end example
@node N_BCOMM
-@section 226 - 0xe2 - N_BCOMM
+@section 226 - 0xe2 - N_BCOMM
Begin named common block.
<<?>>
@node N_ECOMM
-@section 228 - 0xe4 - N_ECOMM
+@section 228 - 0xe4 - N_ECOMM
End named common block.
<<?>>
@example
-240 0xf0 N_NBTEXT ??
-242 0xf2 N_NBDATA ??
-244 0xf4 N_NBBSS ??
-246 0xf6 N_NBSTS ??
-248 0xf8 N_NBLCS ??
+240 0xf0 N_NBTEXT ??
+242 0xf2 N_NBDATA ??
+244 0xf4 N_NBBSS ??
+246 0xf6 N_NBSTS ??
+248 0xf8 N_NBLCS ??
@end example
@node N_LENG
(symbol descriptor t) defined at file scope from types defined locally
to a procedure or other more local scope. They all use the N_LSYM
stab type. Types defined at procedure scope are emited after the
-N_RBRAC of the preceeding function and before the code of the
+N_RBRAC of the preceding function and before the code of the
procedure in which they are defined. This is exactly the same as
types defined in the source file between the two procedure bodies.
GDB overcompensates by placing all types in block #1 the block for
Table E: mapping a.out stab types to xcoff storage classes
@example
-stab type storage class
+stab type storage class
-------------------------------
-N_GSYM C_GSYM
-N_FNAME unknown
-N_FUN C_FUN
-N_STSYM C_STSYM
-N_LCSYM C_STSYM
-N_MAIN unkown
-N_PC unknown
-N_RSYM C_RSYM
-N_RPSYM (0x8e) C_RPSYM
-N_M2C unknown
-N_SLINE unknown
-N_DSLINE unknown
-N_BSLINE unknown
-N_BROWSE unchanged
-N_CATCH unknown
-N_SSYM unknown
-N_SO unknown
-N_LSYM C_LSYM
-N_DECL (0x8c) C_DECL
-N_BINCL unknown
-N_SOL unknown
-N_PSYM C_PSYM
-N_EINCL unknown
-N_ENTRY C_ENTRY
-N_LBRAC unknown
-N_EXCL unknown
-N_SCOPE unknown
-N_RBRAC unknown
-N_BCOMM C_BCOMM
-N_ECOMM C_ECOMM
-N_ECOML C_ECOML
-
-N_LENG unknown
+N_GSYM C_GSYM
+N_FNAME unknown
+N_FUN C_FUN
+N_STSYM C_STSYM
+N_LCSYM C_STSYM
+N_MAIN unkown
+N_PC unknown
+N_RSYM C_RSYM
+N_RPSYM (0x8e) C_RPSYM
+N_M2C unknown
+N_SLINE unknown
+N_DSLINE unknown
+N_BSLINE unknown
+N_BROWSE unchanged
+N_CATCH unknown
+N_SSYM unknown
+N_SO unknown
+N_LSYM C_LSYM
+N_DECL (0x8c) C_DECL
+N_BINCL unknown
+N_SOL unknown
+N_PSYM C_PSYM
+N_EINCL unknown
+N_ENTRY C_ENTRY
+N_LBRAC unknown
+N_EXCL unknown
+N_SCOPE unknown
+N_RBRAC unknown
+N_BCOMM C_BCOMM
+N_ECOMM C_ECOMM
+N_ECOML C_ECOML
+
+N_LENG unknown
@end example
@node Sun-differences
projects / binutils-gdb.git / commitdiff