xref: /freebsd/include/rpcsvc/nislib.h (revision 63a938566d524836885917d95bd491aa4400b181)
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  * $FreeBSD$
30  */
31 
32 /*
33  * Copyright (c) 1991, Sun Microsystems Inc.
34  */
35 
36 /*
37  * This file contains the interfaces that are visible in the SunOS 5.x
38  * implementation of NIS Plus.
39  */
40 
41 #ifndef	_RPCSVC_NISLIB_H
42 #define	_RPCSVC_NISLIB_H
43 
44 /* From: #pragma ident	"@(#)nislib.h	1.16	94/05/03 SMI" */
45 
46 #ifdef __cplusplus
47 extern "C" {
48 #endif
49 
50 struct signature {
51 	int signature_len;
52 	char *signature_val;
53 };
54 
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 #define	NUL '\0'
183 
184 #ifdef	__cplusplus
185 }
186 #endif
187 
188 #endif	/* _RPCSVC_NISLIB_H */
189