Manual Page Result
0
Command: stab | Section: 5 | Source: UNIX v10 | File: stab.5
STAB(5) File Formats Manual STAB(5)
NAME
stab - symbol table types
SYNOPSIS
#include <stab.h>
DESCRIPTION
The include file defines some values of the field of the symbol table
of object files; see a.out(5). These are the types for permanent sym-
bols used by the compilers cc(1) and f77(1) and the debugger pi(9.1).
Symbol table entries are produced by assembler directives:
.stabs specifies a name in quotes " ", a symbol type one char one
short and an unsigned long usually an address).
.stabd the same, referring to the current location without an explicit
name.
.stabn generates entries with no name.
The loader ld(1) preserves the order of symbol table entries produced
by these directives.
The low bits of the field place a symbol into at most one segment, ac-
cording to the following masks, defined in <a.out.h>.
#define N_UNDF 0x0 /* undefined */
#define N_ABS 0x2 /* absolute */
#define N_TEXT 0x4 /* text */
#define N_DATA 0x6 /* data */
#define N_BSS 0x8 /* bss */
#define N_EXT 0x1 /* external bit, or'ed in */
The field of a symbol is relocated by ld as an address within the ap-
propriate segment, or is unchanged for a symbol not in any segment. In
addition, the loader will discard certain symbols, according to rules
of its own, unless the field has one of the following bits set:
#define N_STAB 0xe0
This allows up to 112 symbol types, split among the various segments.
Some of these have already been claimed. Option -g of cc uses the fol-
lowing values, all 4 mod 16, for text symbols. Comments show the per-
tinent fields of the .stabs directive.
#define N_BFUN 0x24 /* procedure: name,,0,lineno,address */
#define N_FUN 0x24
#define N_NARGS 0x34 /* function call: ,,0,nbytes,address */
#define N_SLINE 0x44 /* src line: ,,0,lineno,address */
#define N_SO 0x64 /* source file: name,,0,lineno,address */
#define N_SOL 0x84 /* #include file: name,,0,lineno,address */
#define N_ESO 0x94 /* end source file: name,,0,lineno,address */
#define N_ENTRY 0xa4 /* alternate entry: name,,0,lineno,address */
#define N_RFUN 0xb4 /* return from function: ,,0,lineno,address */
#define N_LBRAC 0xc4 /* left bracket: ,,0,level,address */
#define N_RBRAC 0xd4 /* right bracket: ,,0,level,address */
#define N_EFUN 0xf4 /* end of function: name,,0,lineno,address */
These values, all 8 mod 16, are used for data symbols:
#define N_LCSYM 0x28 /* .lcomm symbol: name,,0,type,address */
#define N_ECOML 0xe8 /* end common (local name): ,,address */
And these for non-relocated symbols:
#define N_GSYM 0x20 /* global symbol: name,,0,type,0 */
#define N_FNAME 0x22 /* procedure name (f77 kludge): name,,0 */
#define N_STFUN 0x32 /* static function: name,,0,type,0 */
#define N_RSYM 0x40 /* register sym: name,,0,type,register */
#define N_BSTR 0x5c /* begin structure: name,,0,type,length */
#define N_ESTR 0x5e /* end structure: name,,0,type,length */
#define N_SSYM 0x60 /* structure elt: name,,0,type,offset */
#define N_SFLD 0x70 /* structure field: name,,0,type,offset */
#define N_LSYM 0x80 /* local sym: name,,0,type,offset */
#define N_PSYM 0xa0 /* parameter: name,,0,type,offset */
#define N_BCOMM 0xe2 /* begin common: name,, */
#define N_ECOMM 0xe4 /* end common: name,, */
#define N_VER 0xf0 /* symbol table version number */
#define N_TYID 0xfa /* struct, union, or enum name */
#define N_DIM 0xfc /* dimension for arrays */
Field holds a type specifier in the form used by cc(1), by up to 6
qualifiers, with q1 most significant:
struct desc {
short q6:2, q5:2, q4:2, q3:2, q2:2, q1:2;
short basic:5;
};
The qualifiers are coded thus: 0 none 1 pointer
2 function 3 array
The basic types are coded thus: 0 undefined 1 function ar-
gument 2 character 3 short 4 int 5 long
6 float 7 double 8 structure 9 union
10 enumeration 11 member of enumeration 12 unsigned
character 13 unsigned short 14 unsigned int 15 unsigned
long 16 void
The Pascal compiler, pc(A), uses the following value:
#define N_PC 0x30/* global pascal symbol: name,,0,subtype,line */
and uses the following subtypes to do type checking across separately
compiled files: 1 source file name 2 included file name
3 global label 4 global constant 5 global type
6 global variable 7 global function 8 global proce-
dure 9 external function 10 external procedure
SEE ALSO
a.out(5), pi(9.1), as(1), ld(1)
BUGS
The loader's relocation conventions limit the number of useful values.
STAB(5)