3 * $Id: name.h,v 1.1 1997/07/21 13:47:46 mdw Exp $
5 * Looking up of names in symbol tables
10 /*----- Licencing notice --------------------------------------------------*
12 * This file is part of `become'
14 * `Become' is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU General Public License as published by
16 * the Free Software Foundation; either version 2 of the License, or
17 * (at your option) any later version.
19 * `Become' is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU General Public License for more details.
24 * You should have received a copy of the GNU General Public License
25 * along with `become'; if not, write to the Free Software
26 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
29 /*----- Revision history --------------------------------------------------*
32 * Revision 1.1 1997/07/21 13:47:46 mdw
44 /*----- Required headers --------------------------------------------------*/
54 /*----- Data structures ---------------------------------------------------*/
57 sym_base base
; /* Base block for symbol table */
58 classdef
*c
; /* Base class pointer */
61 /*----- Functions provided ------------------------------------------------*/
63 /* --- @name_init@ --- *
69 * Use: Initialises the name table. Requires the user database to
70 * be populated (see @userdb_local@ and @userdb_yp@).
73 extern void name_init(void);
75 /* --- @name_reinit@ --- *
81 * Use: Reinitialises the names table. It's cleared and then
82 * initialised with the current user and group ids as for
86 extern void name_reinit(void);
88 /* --- @name_find@ --- *
90 * Arguments: @const char *p@ = pointer to name to look up
91 * @unsigned create@ = whether to create the item
92 * @unsigned *f@ = whether the item was created
94 * Returns: Pointer to a @name@ block containing the symbol, or
95 * zero if it wasn't found and we didn't want to create a
98 * Use: Looks up a name in the symbol table and returns the
102 extern name
*name_find(const char */
*p*/
,
106 /* --- @name_dump@ --- *
108 * Arguments: @FILE *fp@ = stream to dump on
112 * Use: Dumps a complete listing of the symbol table.
115 extern void name_dump(FILE */
*fp*/
);
117 /*----- That's all, folks -------------------------------------------------*/