3 * $Id: netg.h,v 1.1 1997/08/07 09:45:00 mdw Exp $
5 * A local database of netgroups
10 /*----- Licensing 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 Foundation,
26 * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
29 /*----- Revision history --------------------------------------------------*
32 * Revision 1.1 1997/08/07 09:45:00 mdw
33 * New source file added to maintain a netgroups database.
44 /*----- Required headers --------------------------------------------------*/
50 /*----- Type definitions --------------------------------------------------*/
52 typedef sym_iter netg_iter
;
53 typedef struct netg__sym netg
;
55 /*----- Functions provided ------------------------------------------------*/
57 /* --- @netg_iterate@, @netg_iterate_r@ --- *
59 * Arguments: @netg_iter *i@ = pointer to a netgroup iterator object
63 * Use: Starts iterating over the netgroups.
66 extern void netg_iterate(void);
67 extern void netg_iterate_r(netg_iter */
*i*/
);
69 /* --- @netg_next@, @netg_next_r@ --- *
71 * Arguments: @netg_iter *i@ = pointer to a netgroup iterator object
73 * Returns: An opaque pointer to the next item, or null.
75 * Use: Returns the next netgroup.
78 extern netg
*netg_next(void);
79 extern netg
*netg_next_r(netg_iter */
*i*/
);
81 /* --- @netg_name@ --- *
83 * Arguments: @netg *n@ = netgroup handle returned by @netg_next@.
85 * Returns: A pointer to the name; you may not modify this string.
87 * Use: Returns the name of a netgroup.
90 extern const char *netg_name(netg */
*n*/
);
92 /* --- @netg_scan@ --- *
94 * Arguments: @netg *n@ = a netgroup handle returned by @netg_next@
95 * @int (*proc)(netg *n, const char *host, const char *user,@
96 * @const char *domain, void *ctx)@ = function to call
98 * @void *ctx@ = context pointer to pass to @proc@.
100 * Returns: Zero if all went well, or the nonzero return value from
103 * Use: Passes all the members of the netgroup to a given function.
104 * The function is given the names, directly from the NIS
105 * netgroup map, except that any empty entries are passed as
106 * null pointers rather than empty strings. You may not modify
107 * any of the strings. The enumeration function, @proc@, may
108 * return nonzero to stop itself from being called any more;
109 * if this happens, the value it returns becomes the result of
110 * this function. If all the items are enumerated OK, this
111 * function returns zero.
114 extern int netg_scan(netg */
*n*/
,
115 int (*/
*proc*/
)(netg */
*n*/
, const char */
*host*/
,
116 const char */
*user*/
,
117 const char */
*domain*/
, void */
*ctx*/
),
120 /* --- @netg_init@ --- *
126 * Use: Reads the netgroup database and turns it into something nice.
129 extern void netg_init(void);
131 /* --- @netg_reinit@ --- *
137 * Use: Forces a re-read of the netgroups file.
140 extern void netg_reinit(void);
142 /*----- That's all, folks -------------------------------------------------*/