diff options
| author | Ian Lance Taylor <ian@airs.com> | 1995-12-13 17:36:52 +0000 |
|---|---|---|
| committer | Ian Lance Taylor <ian@airs.com> | 1995-12-13 17:36:52 +0000 |
| commit | 120e5e89125b8d2622a724e1ebb5a863504cec69 (patch) | |
| tree | fbb40dea6034114101920669c56268b0586fbb36 /gdb/doc/stabs.texinfo | |
| parent | 3920d9c92487cb27f4cd2130c1dd94ba34234a99 (diff) | |
| download | gdb-120e5e89125b8d2622a724e1ebb5a863504cec69.zip gdb-120e5e89125b8d2622a724e1ebb5a863504cec69.tar.gz gdb-120e5e89125b8d2622a724e1ebb5a863504cec69.tar.bz2 | |
* stabs.texinfo (Include Files): Document the values the SunOS4
linker creates for N_BINCL/N_EINCL/N_EXCL stabs.
Diffstat (limited to 'gdb/doc/stabs.texinfo')
| -rw-r--r-- | gdb/doc/stabs.texinfo | 18 |
1 files changed, 12 insertions, 6 deletions
diff --git a/gdb/doc/stabs.texinfo b/gdb/doc/stabs.texinfo index ca01bb7..0769272 100644 --- a/gdb/doc/stabs.texinfo +++ b/gdb/doc/stabs.texinfo @@ -463,11 +463,10 @@ the start of this one. To specify the main source file again, use an @findex N_EXCL The @code{N_BINCL} approach works as follows. An @code{N_BINCL} symbol specifies the start of an include file. In an object file, only the -string is significant; the Sun linker puts data into some of the -other fields. The end of the include file is marked by an -@code{N_EINCL} symbol (which has no string field). In an object -file, there is no significant data in the @code{N_EINCL} symbol; the Sun -linker puts data into some of the fields. @code{N_BINCL} and +string is significant; the Sun linker puts data into some of the other +fields. The end of the include file is marked by an @code{N_EINCL} +symbol (which has no string field). In an object file, there is no +significant data in the @code{N_EINCL} symbol. @code{N_BINCL} and @code{N_EINCL} can be nested. If the linker detects that two source files have identical stabs between @@ -476,7 +475,14 @@ for a header file), then it only puts out the stabs once. Each additional occurance is replaced by an @code{N_EXCL} symbol. I believe the Sun (SunOS4, not sure about Solaris) linker is the only one which supports this feature. -@c What do the fields of N_EXCL contain? -djm + +The SunOS4 linker sets the value of a @code{N_BINCL} symbol to the total +of all the characters in the stabs strings included in the header file, +omitting the file number. The value of an @code{N_EXCL} symbol is the +same as the value of the @code{N_BINCL} symbol it replaces. I do not +know if this information is used by anything. The @code{N_EINCL} value, +and the values of the other and description fields for all three, appear +to always be zero. @findex C_BINCL @findex C_EINCL |