Return to db_sym.h CVS log

Up to [Net/2] / Net2 / ddb

Annotation of Net2/ddb/db_sym.h, revision 1.1.1.1

1.1       root        1: /* 
                      2:  * Mach Operating System
                      3:  * Copyright (c) 1991,1990 Carnegie Mellon University
                      4:  * All Rights Reserved.
                      5:  * 
                      6:  * Permission to use, copy, modify and distribute this software and its
                      7:  * documentation is hereby granted, provided that both the copyright
                      8:  * notice and this permission notice appear in all copies of the
                      9:  * software, derivative works or modified versions, and any portions
                     10:  * thereof, and that both notices appear in supporting documentation.
                     11:  * 
                     12:  * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS 
                     13:  * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
                     14:  * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
                     15:  * 
                     16:  * Carnegie Mellon requests users of this software to return to
                     17:  * 
                     18:  *  Software Distribution Coordinator  or  [email protected]
                     19:  *  School of Computer Science
                     20:  *  Carnegie Mellon University
                     21:  *  Pittsburgh PA 15213-3890
                     22:  * 
                     23:  * any improvements or extensions that they make and grant Carnegie the
                     24:  * rights to redistribute these changes.
                     25:  */
                     26: /*
                     27:  * HISTORY
                     28:  * $Log: db_sym.h,v $
                     29:  * Revision 1.1  1992/03/25  21:45:29  pace
                     30:  * Initial revision
                     31:  *
                     32:  * Revision 2.3  91/02/05  17:07:12  mrt
                     33:  *     Changed to new Mach copyright
                     34:  *     [91/01/31  16:19:27  mrt]
                     35:  * 
                     36:  * Revision 2.2  90/08/27  21:52:39  dbg
                     37:  *     Changed type of db_sym_t to char * - it's a better type for an
                     38:  *     opaque pointer.
                     39:  *     [90/08/22            dbg]
                     40:  * 
                     41:  *     Created.
                     42:  *     [90/08/19            af]
                     43:  * 
                     44:  */
                     45: /*
                     46:  *     Author: Alessandro Forin, Carnegie Mellon University
                     47:  *     Date:   8/90
                     48:  */
                     49: 
                     50: /*
                     51:  * This module can handle multiple symbol tables
                     52:  */
                     53: typedef struct {
                     54:        char            *name;          /* symtab name */
                     55:        char            *start;         /* symtab location */
                     56:        char            *end;
                     57:        char            *private;       /* optional machdep pointer */
                     58: } db_symtab_t;
                     59: 
                     60: extern db_symtab_t     *db_last_symtab; /* where last symbol was found */
                     61: 
                     62: /*
                     63:  * Symbol representation is specific to the symtab style:
                     64:  * BSD compilers use dbx' nlist, other compilers might use
                     65:  * a different one
                     66:  */
                     67: typedef        char *          db_sym_t;       /* opaque handle on symbols */
                     68: #define        DB_SYM_NULL     ((db_sym_t)0)
                     69: 
                     70: /*
                     71:  * Non-stripped symbol tables will have duplicates, for instance
                     72:  * the same string could match a parameter name, a local var, a
                     73:  * global var, etc.
                     74:  * We are most concern with the following matches.
                     75:  */
                     76: typedef int            db_strategy_t;  /* search strategy */
                     77: 
                     78: #define        DB_STGY_ANY     0                       /* anything goes */
                     79: #define DB_STGY_XTRN   1                       /* only external symbols */
                     80: #define DB_STGY_PROC   2                       /* only procedures */
                     81: 
                     82: extern boolean_t       db_qualify_ambiguous_names;
                     83:                                        /* if TRUE, check across symbol tables
                     84:                                         * for multiple occurrences of a name.
                     85:                                         * Might slow down quite a bit */
                     86: 
                     87: /*
                     88:  * Functions exported by the symtable module
                     89:  */
                     90: extern void    db_add_symbol_table();
                     91:                                        /* extend the list of symbol tables */
                     92: 
                     93: extern int     db_value_of_name(/* char*, db_expr_t* */);
                     94:                                        /* find symbol value given name */
                     95: 
                     96: extern db_sym_t        db_search_symbol(/* db_expr_t, db_strategy_t, int* */);
                     97:                                        /* find symbol given value */
                     98: 
                     99: extern void    db_symbol_values(/* db_sym_t, char**, db_expr_t* */);
                    100:                                        /* return name and value of symbol */
                    101: 
                    102: #define db_find_sym_and_offset(val,namep,offp) \
                    103:        db_symbol_values(db_search_symbol(val,DB_STGY_ANY,offp),namep,0)
                    104:                                        /* find name&value given approx val */
                    105: 
                    106: #define db_find_xtrn_sym_and_offset(val,namep,offp)    \
                    107:        db_symbol_values(db_search_symbol(val,DB_STGY_XTRN,offp),namep,0)
                    108:                                        /* ditto, but no locals */
                    109: 
                    110: extern int     db_eqname(/* char*, char*, char */);
                    111:                                        /* strcmp, modulo leading char */
                    112: 
                    113: extern void    db_printsym(/* db_expr_t, db_strategy_t */);
                    114:                                        /* print closest symbol to a value */

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.