STAB(5) STAB(5) NAME stab - symbol table types SYNOPSIS #include <stab.h> DESCRIPTION The include file `<stab.h>' defines some values of the `n_type' field of the symbol table of object files; see a.out(5). These are the types for permanent symbols 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 (`n_type'), one char (`n_other'), one short (`n_desc),' and an unsigned long (`n_value', 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 `n_type' field place a symbol into at most one segment, according 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 `n_value' field of a symbol is relocated by ld as an address within the appropriate 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 `n_type' 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 following values, all 4 mod 16, for text symbols. Comments show the pertinent fields of the .stabs directive. #define N_BFUN 0x24 /* procedure: name,,0,lineno,address */ STAB(5) STAB(5) #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 `n_desc' 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 2 function 1 pointer 3 array The basic types are coded thus: 0 undefined 1 function argument 2 character 3 short STAB(5) STAB(5) 4 int 5 long 6 float 7 double STAB(5) STAB(5) 8 structure 9 union 10 enumeration 11 member of enumeration 12 unsigned character 13 unsigned short 14 unsigned int 15 unsigned long 16 void .C3 STAB(5) STAB(5) The Pascal compiler, pc(A), uses the following `n_type' 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 6 global variable 2 included file name 7 global function 3 global label 8 global procedure 4 global constant 9 external function 5 global type 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 use- ful `n_type' values.