xref: /freebsd/include/rpcsvc/nislib.h (revision 3a31b7eb32ad60e1e05b2b2e184ff47e4afbb874)
1 /*
2  * Sun RPC is a product of Sun Microsystems, Inc. and is provided for
3  * unrestricted use provided that this legend is included on all tape
4  * media and as a part of the software program in whole or part.  Users
5  * may copy or modify Sun RPC without charge, but are not authorized
6  * to license or distribute it to anyone else except as part of a product or
7  * program developed by the user.
8  *
9  * SUN RPC IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING THE
10  * WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
11  * PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE.
12  *
13  * Sun RPC is provided with no support and without any obligation on the
14  * part of Sun Microsystems, Inc. to assist in its use, correction,
15  * modification or enhancement.
16  *
17  * SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE
18  * INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY SUN RPC
19  * OR ANY PART THEREOF.
20  *
21  * In no event will Sun Microsystems, Inc. be liable for any lost revenue
22  * or profits or other special, indirect and consequential damages, even if
23  * Sun has been advised of the possibility of such damages.
24  *
25  * Sun Microsystems, Inc.
26  * 2550 Garcia Avenue
27  * Mountain View, California  94043
28  */
29 
30 /*
31  * Copyright (c) 1991, Sun Microsystems Inc.
32  */
33 
34 /*
35  * This file contains the interfaces that are visible in the SunOS 5.x
36  * implementation of NIS Plus. When using C++ the defined __cplusplus and
37  * __STDC__ should both be true.
38  */
39 
40 #ifndef	_RPCSVC_NISLIB_H
41 #define	_RPCSVC_NISLIB_H
42 
43 /* From: #pragma ident	"@(#)nislib.h	1.16	94/05/03 SMI" */
44 
45 #ifdef __cplusplus
46 extern "C" {
47 #endif
48 
49 struct signature {
50 	int signature_len;
51 	char *signature_val;
52 };
53 
54 #ifdef __STDC__
55 extern void nis_freeresult(nis_result *);
56 extern nis_result * nis_lookup(nis_name, u_long);
57 extern nis_result * nis_list(nis_name, u_long,
58 	int (*)(nis_name, nis_object *, void *), void *);
59 extern nis_result * nis_add(nis_name, nis_object *);
60 extern nis_result * nis_remove(nis_name, nis_object *);
61 extern nis_result * nis_modify(nis_name, nis_object *);
62 
63 extern nis_result * nis_add_entry(nis_name, nis_object *, u_long);
64 extern nis_result * nis_remove_entry(nis_name, nis_object *, u_long);
65 extern nis_result * nis_modify_entry(nis_name, nis_object *, u_long);
66 extern nis_result * nis_first_entry(nis_name);
67 extern nis_result * nis_next_entry(nis_name, netobj *);
68 
69 extern nis_error nis_mkdir(nis_name, nis_server *);
70 extern nis_error nis_rmdir(nis_name, nis_server *);
71 extern name_pos nis_dir_cmp(nis_name, nis_name);
72 
73 extern nis_name * nis_getnames(nis_name);
74 extern void nis_freenames(nis_name *);
75 extern nis_name nis_domain_of(nis_name);
76 extern nis_name nis_leaf_of(nis_name);
77 extern nis_name nis_leaf_of_r(const nis_name, char *, size_t);
78 extern nis_name nis_name_of(nis_name);
79 extern nis_name nis_local_group(void);
80 extern nis_name nis_local_directory(void);
81 extern nis_name nis_local_principal(void);
82 extern nis_name nis_local_host(void);
83 
84 extern void nis_destroy_object(nis_object *);
85 extern nis_object * nis_clone_object(nis_object *, nis_object *);
86 extern void nis_print_object(nis_object *);
87 
88 extern char * nis_sperrno(nis_error);
89 extern void nis_perror(nis_error, char *);
90 extern char * nis_sperror(nis_error, char *);
91 extern void nis_lerror(nis_error, char *);
92 
93 extern void nis_print_group_entry(nis_name);
94 extern bool_t nis_ismember(nis_name, nis_name);
95 extern nis_error nis_creategroup(nis_name, u_long);
96 extern nis_error nis_destroygroup(nis_name);
97 extern nis_error nis_addmember(nis_name, nis_name);
98 extern nis_error nis_removemember(nis_name, nis_name);
99 extern nis_error nis_verifygroup(nis_name);
100 
101 extern void nis_freeservlist(nis_server **);
102 extern nis_server ** nis_getservlist(nis_name);
103 extern nis_error nis_stats(nis_server *, nis_tag *, int, nis_tag **);
104 extern nis_error nis_servstate(nis_server *, nis_tag *, int, nis_tag **);
105 extern void nis_freetags(nis_tag *, int);
106 
107 extern nis_result * nis_checkpoint(nis_name);
108 extern void nis_ping(nis_name, u_long, nis_object *);
109 
110 /*
111  * XXX: PLEASE NOTE THAT THE FOLLOWING FUNCTIONS ARE INTERNAL
112  * TO NIS+ AND SHOULD NOT BE USED BY ANY APPLICATION PROGRAM.
113  * THEIR SEMANTICS AND/OR SIGNATURE CAN CHANGE WITHOUT NOTICE.
114  * SO, PLEASE DO NOT USE THEM.  YOU ARE WARNED!!!!
115  */
116 
117 extern char ** __break_name(nis_name, int *);
118 extern int __name_distance(char **, char **);
119 extern nis_result * nis_make_error(nis_error, u_long, u_long, u_long, u_long);
120 extern nis_attr * __cvt2attr(int *, char **);
121 extern void nis_free_request(ib_request *);
122 extern nis_error nis_get_request(nis_name, nis_object *, netobj*, ib_request*);
123 extern nis_object * nis_read_obj(char *);
124 extern int nis_write_obj(char *, nis_object *);
125 extern int nis_in_table(nis_name, NIS_HASH_TABLE *, int *);
126 extern int nis_insert_item(NIS_HASH_ITEM *, NIS_HASH_TABLE *);
127 extern NIS_HASH_ITEM * nis_find_item(nis_name, NIS_HASH_TABLE *);
128 extern NIS_HASH_ITEM * nis_remove_item(nis_name, NIS_HASH_TABLE *);
129 extern void nis_insert_name(nis_name, NIS_HASH_TABLE *);
130 extern void nis_remove_name(nis_name, NIS_HASH_TABLE *);
131 extern CLIENT * nis_make_rpchandle(nis_server *, int, u_long, u_long, u_long,
132 								int, int);
133 extern void * nis_get_static_storage(struct nis_sdata *, u_long, u_long);
134 extern char * nis_data(char *);
135 extern void nis_print_rights(u_long);
136 extern void nis_print_directory(directory_obj *);
137 extern void nis_print_group(group_obj *);
138 extern void nis_print_table(table_obj *);
139 extern void nis_print_link(link_obj *);
140 extern void nis_print_entry(entry_obj *);
141 extern nis_object * nis_get_object(char *, char *, char *, u_long, u_long,
142 								    zotypes);
143 extern nis_server * __nis_init_callback(CLIENT *,
144     int (*)(nis_name, nis_object *, void *), void *);
145 extern int nis_getdtblsize(void);
146 extern int __nis_run_callback(netobj *, u_long, struct timeval *, CLIENT *);
147 
148 extern log_result *nis_dumplog(nis_server *, nis_name, u_long);
149 extern log_result *nis_dump(nis_server *, nis_name,
150     int (*)(nis_name, nis_object *, void *));
151 
152 extern bool_t __do_ismember(nis_name, nis_name,
153     nis_result *(*)(nis_name, u_long));
154 extern nis_name __nis_map_group(nis_name);
155 extern nis_name __nis_map_group_r(nis_name, char*, size_t);
156 
157 extern nis_error __nis_CacheBind(char *, directory_obj *);
158 extern nis_error __nis_CacheSearch(char *, directory_obj *);
159 extern bool_t __nis_CacheRemoveEntry(directory_obj *);
160 extern void __nis_CacheRestart(void);
161 extern void __nis_CachePrint(void);
162 extern void __nis_CacheDumpStatistics(void);
163 extern bool_t writeColdStartFile(directory_obj *);
164 
165 extern CLIENT * __get_ti_clnt(char *, CLIENT *, char **, pid_t *);
166 extern int __strcmp_case_insens(char *, char *);
167 extern int __strncmp_case_insens(char *, char *);
168 
169 extern fd_result * nis_finddirectory(directory_obj *, nis_name);
170 extern int __start_clock(int);
171 extern u_long __stop_clock(int);
172 
173 /*
174  * This particular function is part of the FreeBSD NIS+ implementation
175  * only. Ideally it should be somewhere else, but it is used by both
176  * rpc.nisd and nis_cachemgr, and there aren't that many headers common
177  * to both programs.
178  */
179 
180 extern struct signature *__nis_calculate_encrypted_cksum(unsigned char *, unsigned int, char *, int);
181 
182 #else
183 
184 /* Non-prototype definitions (old fashioned C) */
185 
186 extern void nis_freeresult();
187 extern nis_result * nis_lookup();
188 extern nis_result * nis_list();
189 extern nis_result * nis_add();
190 extern nis_result * nis_remove();
191 extern nis_result * nis_modify();
192 
193 extern nis_result * nis_add_entry();
194 extern nis_result * nis_remove_entry();
195 extern nis_result * nis_modify_entry();
196 extern nis_result * nis_first_entry();
197 extern nis_result * nis_next_entry();
198 
199 extern nis_error nis_mkdir();
200 extern nis_error nis_rmdir();
201 extern name_pos nis_dir_cmp();
202 
203 extern nis_name *nis_getnames();
204 extern void nis_freenames();
205 extern nis_name nis_domain_of();
206 extern nis_name nis_leaf_of();
207 extern nis_name nis_leaf_of_r();
208 extern nis_name nis_name_of();
209 extern nis_name nis_local_group();
210 extern nis_name nis_local_directory();
211 extern nis_name nis_local_principal();
212 extern nis_name nis_local_host();
213 
214 extern void nis_destroy_object();
215 extern nis_object * nis_clone_object();
216 extern void nis_print_object();
217 
218 extern char * nis_sperrno();
219 extern void nis_perror();
220 extern char * nis_sperror();
221 extern void nis_lerror();
222 
223 extern void nis_print_group_entry();
224 extern bool_t nis_ismember();
225 extern nis_error nis_creategroup();
226 extern nis_error nis_destroygroup();
227 extern nis_error nis_addmember();
228 extern nis_error nis_removemember();
229 extern nis_error nis_verifygroup();
230 
231 extern void nis_freeservlist();
232 extern nis_server ** nis_getservlist();
233 extern nis_error nis_stats();
234 extern nis_error nis_servstate();
235 extern void nis_freetags();
236 
237 extern nis_result * nis_checkpoint();
238 extern void nis_ping();
239 
240 /*
241  * XXX: PLEASE NOTE THAT THE FOLLOWING FUNCTIONS ARE INTERNAL
242  * TO NIS+ AND SHOULD NOT BE USED BY ANY APPLICATION PROGRAM.
243  * THEIR SEMANTICS AND/OR SIGNATURE CAN CHANGE WITHOUT NOTICE.
244  * SO, PLEASE DO NOT USE THEM.  YOU ARE WARNED!!!!
245  */
246 extern char ** __break_name();
247 extern int __name_distance();
248 extern nis_result * nis_make_error();
249 extern nis_attr * __cvt2attr();
250 extern void nis_free_request();
251 extern nis_error nis_get_request();
252 extern nis_object * nis_read_obj();
253 extern int nis_write_obj();
254 extern int nis_in_table();
255 extern int nis_insert_item();
256 extern NIS_HASH_ITEM * nis_find_item();
257 extern NIS_HASH_ITEM * nis_remove_item();
258 extern void nis_insert_name();
259 extern void nis_remove_name();
260 extern CLIENT * nis_make_rpchandle();
261 extern void * nis_get_static_storage();
262 extern char * nis_data();
263 
264 extern void nis_print_rights();
265 extern void nis_print_directory();
266 extern void nis_print_group();
267 extern void nis_print_table();
268 extern void nis_print_link();
269 extern void nis_print_entry();
270 extern nis_object * nis_get_object();
271 
272 extern nis_server * __nis_init_callback();
273 extern int nis_getdtblsize();
274 extern int __nis_run_callback();
275 
276 extern log_result * nis_dump();
277 extern log_result * nis_dumplog();
278 
279 extern bool_t __do_ismember();
280 extern nis_name __nis_map_group();
281 extern nis_name __nis_map_group_r();
282 
283 
284 extern nis_error __nis_CacheBind();
285 extern directory_obj * __nis_CacheSearch();
286 extern bool_t __nis_CacheRemoveEntry();
287 extern void __nis_CacheRestart();
288 extern void __nis_CachePrint();
289 extern void __nis_CacheDumpStatistics();
290 extern bool_t writeColdStartFile();
291 
292 extern CLIENT * __get_ti_clnt();
293 extern int __strcmp_case_insens();
294 extern int __strncmp_case_insens();
295 
296 extern fd_result * nis_finddirectory();
297 extern int __start_clock();
298 extern u_long __stop_clock();
299 
300 /*
301  * This particular function is part of the FreeBSD NIS+ implementation
302  * only. Ideally it should be somewhere else, but it is used by both
303  * rpc.nisd and nis_cachemgr, and there aren't that many headers common
304  * to both programs.
305  */
306 
307 extern struct signature *__nis_calculate_encrypted_cksum();
308 
309 #endif
310 
311 #define	NUL '\0'
312 
313 #ifdef	__cplusplus
314 }
315 #endif
316 
317 #endif	/* _RPCSVC_NISLIB_H */
318