]>
Commit | Line | Data |
---|---|---|
d614a753 | 1 | /* Copyright (C) 1997-2020 Free Software Foundation, Inc. |
55c14926 | 2 | This file is part of the GNU C Library. |
d8cf93f4 | 3 | Contributed by Thorsten Kukuk <kukuk@suse.de>, 1997. |
55c14926 UD |
4 | |
5 | The GNU C Library is free software; you can redistribute it and/or | |
41bdb6e2 AJ |
6 | modify it under the terms of the GNU Lesser General Public |
7 | License as published by the Free Software Foundation; either | |
8 | version 2.1 of the License, or (at your option) any later version. | |
55c14926 UD |
9 | |
10 | The GNU C Library is distributed in the hope that it will be useful, | |
11 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
41bdb6e2 | 13 | Lesser General Public License for more details. |
55c14926 | 14 | |
41bdb6e2 | 15 | You should have received a copy of the GNU Lesser General Public |
59ba27a6 | 16 | License along with the GNU C Library; if not, see |
5a82c748 | 17 | <https://www.gnu.org/licenses/>. */ |
55c14926 UD |
18 | |
19 | #ifndef __RPCSVC_NISLIB_H__ | |
20 | #define __RPCSVC_NISLIB_H__ | |
21 | ||
cb765808 | 22 | #include <rpcsvc/nis.h> |
55c14926 UD |
23 | |
24 | __BEGIN_DECLS | |
25 | ||
26 | typedef const char *const_nis_name; | |
27 | ||
28 | /* nis_names: These functions are used to locate and manipulate all NIS+ | |
29 | * objects except the NIS+ entry objects. | |
30 | * | |
31 | * nis_lookup (name, flags) resolves a NIS+ name and returns a copy of | |
32 | * that object from a NIS+ server. | |
33 | * const nis_name name: name of the object to be resolved | |
a1129917 UD |
34 | * unsigned int flags: logically ORing zero or more flags (FOLLOW_LINKS, |
35 | * HARD_LOOKUP, [NO_CACHE], MASTER_ONLY, EXPAND_NAME) | |
55c14926 UD |
36 | * |
37 | * nis_add (name, obj) adds objects to the NIS+ namespace. | |
38 | * const nis_name name: fully qualified NIS+ name. | |
39 | * const nis_object *obj: object members zo_name and zo_domain will be | |
40 | * constructed from name. | |
41 | * | |
42 | * nis_remove (name, obj) removes objects from the NIS+ namespace. | |
43 | * const nis_name name: fully qualified NIS+ name. | |
44 | * const nis_object *obj: if not NULL, it is assumed to point to a copy | |
45 | * of the object being removed. In this case, if | |
46 | * the object on the server does not have the same | |
47 | * object identifier as the object being passed, | |
48 | * the operation will fail with the NIS_NOTSAMEOBJ | |
49 | * error. | |
50 | * | |
51 | * nis_modify (name, obj) can change specific attributes of an object | |
52 | * that already exists in the namespace. | |
53 | */ | |
d8cf93f4 UD |
54 | extern nis_result *nis_lookup (const_nis_name name, unsigned int flags) |
55 | __THROW; | |
56 | extern nis_result *nis_add (const_nis_name name, const nis_object *obj) | |
57 | __THROW; | |
58 | extern nis_result *nis_remove (const_nis_name name, | |
59 | const nis_object *obj) __THROW; | |
60 | extern nis_result *nis_modify (const_nis_name name, | |
61 | const nis_object *obj) __THROW; | |
55c14926 UD |
62 | |
63 | /* nis_tables: These functions are used to search and modify NIS+ tables. | |
64 | * | |
65 | * nis_list (table_name, flags, callback(table_name, obj, userdata), userdata) | |
66 | * search a table in the NIS+ namespace. | |
67 | * const nis_name table_name: indexed name ([xx=yy],table.dir) | |
a1129917 UD |
68 | * unsigned int flags: logically ORing one or more flags (FOLLOW_LINKS, |
69 | * [FOLLOW_PATH], HARD_LOOKUP, [ALL_RESULTS], [NO_CACHE], | |
70 | * MASTER_ONLY, EXPAND_NAME, RETURN_RESULT) | |
55c14926 UD |
71 | * callback(): callback is an optional pointer to a function that will |
72 | * process the ENTRY type objects that are returned from the | |
73 | * search. If this pointer is NULL, then all entries that match | |
74 | * the search criteria are returned in the nis_result structure, | |
75 | * otherwise this function will be called once for each | |
76 | * entry returned. | |
77 | * void *userdata: passed to callback function along with the returned | |
78 | * entry object. | |
79 | * | |
80 | * nis_add_entry (table_name, obj, flags) will add the NIS+ object to the | |
81 | * NIS+ table_name. | |
82 | * const nis_name table_name | |
83 | * const nis_object *obj | |
a1129917 | 84 | * unsigned int flags: 0, ADD_OVERWRITE, RETURN_RESULT |
55c14926 UD |
85 | * |
86 | * nis_modify_entry (name, obj, flags) modifies an object identified by name. | |
87 | * const nis_name name: object identifier | |
88 | * const nis_object *obj: should point to an entry with the EN_MODIFIED | |
89 | * flag set in each column that contains new | |
90 | * information. | |
a1129917 | 91 | * unsigned int flags: 0, MOD_SAMEOBJ, RETURN_RESULT |
55c14926 UD |
92 | * |
93 | * nis_remove_entry (table_name, obj, flags) removes a set of entries | |
94 | * identified by table_name from the table. | |
95 | * const nis_name table_name: indexed NIS+ name | |
96 | * const nis_object *obj: if obj is non-null, it is presumed to point to | |
97 | * a cached copy of the entry. When the removal is | |
98 | * attempted, and the object that would be removed | |
99 | * is not the same as the cached object pointed to | |
100 | * by object then the operation will fail with an | |
101 | * NIS_NOTSAMEOBJ error | |
a1129917 | 102 | * unsigned int flags: 0, REM_MULTIPLE |
55c14926 UD |
103 | * |
104 | * nis_first_entry (table_name) fetches entries from a table one at a time. | |
105 | * const nis_name table_name | |
106 | * | |
107 | * nis_next_entry (table_name, cookie) retrieves the "next" entry from a | |
108 | * table specified by table_name. | |
109 | * const nis_name table_name: | |
110 | * const netobj *cookie: The value of cookie from the nis_result structure | |
111 | * form the previous call. | |
112 | */ | |
d82a27f8 JJ |
113 | extern nis_result *nis_list (const_nis_name __name, unsigned int __flags, |
114 | int (*__callback)(const_nis_name __table_name, | |
115 | const nis_object *__obj, | |
116 | const void *__userdata), | |
117 | const void *__userdata) __THROW; | |
118 | extern nis_result *nis_add_entry (const_nis_name __table_name, | |
119 | const nis_object *__obj, | |
120 | unsigned int __flags) __THROW; | |
121 | extern nis_result *nis_modify_entry (const_nis_name __name, | |
122 | const nis_object *__obj, | |
123 | unsigned int __flags) __THROW; | |
124 | extern nis_result *nis_remove_entry (const_nis_name __table_name, | |
125 | const nis_object *__obj, | |
126 | unsigned int __flags) __THROW; | |
127 | extern nis_result *nis_first_entry (const_nis_name __table_name) __THROW; | |
128 | extern nis_result *nis_next_entry (const_nis_name __table_name, | |
129 | const netobj *__cookie) __THROW; | |
55c14926 UD |
130 | /* |
131 | ** nis_server | |
132 | */ | |
d82a27f8 JJ |
133 | extern nis_error nis_mkdir (const_nis_name __dirname, |
134 | const nis_server *__machine) __THROW; | |
135 | extern nis_error nis_rmdir (const_nis_name __dirname, | |
136 | const nis_server *__machine) __THROW; | |
137 | extern nis_error nis_servstate (const nis_server *__machine, | |
138 | const nis_tag *__tags, int __numtags, | |
139 | nis_tag **__result) __THROW; | |
140 | extern nis_error nis_stats (const nis_server *__machine, | |
141 | const nis_tag *__tags, int __numtags, | |
142 | nis_tag **__result) __THROW; | |
143 | extern void nis_freetags (nis_tag *__tags, int __numtags) __THROW; | |
144 | extern nis_server **nis_getservlist (const_nis_name __dirname) __THROW; | |
145 | extern void nis_freeservlist (nis_server **__machines) __THROW; | |
55c14926 UD |
146 | |
147 | /* | |
148 | ** nis_subr | |
149 | */ | |
d82a27f8 JJ |
150 | extern nis_name nis_leaf_of (const_nis_name __name) __THROW; |
151 | extern nis_name nis_leaf_of_r (const_nis_name __name, char *__buffer, | |
152 | size_t __buflen) __THROW; | |
153 | extern nis_name nis_name_of (const_nis_name __name) __THROW; | |
154 | extern nis_name nis_name_of_r (const_nis_name __name, char *__buffer, | |
155 | size_t __buflen) __THROW; | |
156 | extern nis_name nis_domain_of (const_nis_name __name) __THROW; | |
157 | extern nis_name nis_domain_of_r (const_nis_name __name, char *__buffer, | |
158 | size_t __buflen) __THROW; | |
159 | extern nis_name *nis_getnames (const_nis_name __name) __THROW; | |
160 | extern void nis_freenames (nis_name *__namelist) __THROW; | |
161 | extern name_pos nis_dir_cmp (const_nis_name __n1, const_nis_name __n2) __THROW; | |
162 | extern nis_object *nis_clone_object (const nis_object *__src, | |
163 | nis_object *__dest) __THROW; | |
164 | extern void nis_destroy_object (nis_object *__obj) __THROW; | |
165 | extern void nis_print_object (const nis_object *__obj) __THROW; | |
55c14926 UD |
166 | |
167 | /* | |
168 | ** nis_local_names | |
169 | */ | |
d8cf93f4 UD |
170 | extern nis_name nis_local_group (void) __THROW; |
171 | extern nis_name nis_local_directory (void) __THROW; | |
172 | extern nis_name nis_local_principal (void) __THROW; | |
173 | extern nis_name nis_local_host (void) __THROW; | |
55c14926 UD |
174 | |
175 | /* | |
176 | ** nis_error | |
177 | */ | |
d82a27f8 JJ |
178 | extern const char *nis_sperrno (const nis_error __status) __THROW; |
179 | extern void nis_perror (const nis_error __status, const char *__label) __THROW; | |
180 | extern void nis_lerror (const nis_error __status, const char *__label) __THROW; | |
181 | extern char *nis_sperror (const nis_error status, const char *__label) __THROW; | |
182 | extern char *nis_sperror_r (const nis_error __status, const char *__label, | |
183 | char *__buffer, size_t __buflen) __THROW; | |
55c14926 UD |
184 | /* |
185 | ** nis_groups | |
186 | */ | |
d82a27f8 JJ |
187 | extern bool_t nis_ismember (const_nis_name __principal, |
188 | const_nis_name __group) __THROW; | |
189 | extern nis_error nis_addmember (const_nis_name __member, | |
190 | const_nis_name __group) __THROW; | |
191 | extern nis_error nis_removemember (const_nis_name __member, | |
192 | const_nis_name __group) __THROW; | |
193 | extern nis_error nis_creategroup (const_nis_name __group, | |
194 | unsigned int __flags) __THROW; | |
195 | extern nis_error nis_destroygroup (const_nis_name __group) __THROW; | |
196 | extern void nis_print_group_entry (const_nis_name __group) __THROW; | |
197 | extern nis_error nis_verifygroup (const_nis_name __group) __THROW; | |
55c14926 UD |
198 | |
199 | /* | |
200 | ** nis_ping | |
201 | */ | |
d82a27f8 JJ |
202 | extern void nis_ping (const_nis_name __dirname, uint32_t __utime, |
203 | const nis_object *__dirobj) __THROW; | |
204 | extern nis_result *nis_checkpoint (const_nis_name __dirname) __THROW; | |
55c14926 UD |
205 | |
206 | /* | |
207 | ** nis_print (XXX INTERNAL FUNCTIONS, SHOULD NOT BE USED !!) | |
208 | */ | |
d82a27f8 JJ |
209 | extern void nis_print_result (const nis_result *__result) __THROW; |
210 | extern void nis_print_rights (unsigned int __rights) __THROW; | |
211 | extern void nis_print_directory (const directory_obj *__dirobj) __THROW; | |
212 | extern void nis_print_group (const group_obj *__grpobj) __THROW; | |
213 | extern void nis_print_table (const table_obj *__tblobj) __THROW; | |
214 | extern void nis_print_link (const link_obj *__lnkobj) __THROW; | |
215 | extern void nis_print_entry (const entry_obj *__enobj) __THROW; | |
55c14926 UD |
216 | |
217 | /* | |
218 | ** nis_file (XXX INTERNAL FUNCTIONS, SHOULD NOT BE USED !!) | |
219 | */ | |
d8cf93f4 | 220 | extern directory_obj *readColdStartFile (void) __THROW; |
d82a27f8 JJ |
221 | extern bool_t writeColdStartFile (const directory_obj *__dirobj) __THROW; |
222 | extern nis_object *nis_read_obj (const char *__obj) __THROW; | |
223 | extern bool_t nis_write_obj (const char *__file, const nis_object *__obj) __THROW; | |
55c14926 UD |
224 | |
225 | /* | |
226 | ** nis_clone - (XXX INTERNAL FUNCTIONS, SHOULD NOT BE USED !!) | |
227 | */ | |
d82a27f8 JJ |
228 | extern directory_obj *nis_clone_directory (const directory_obj *__src, |
229 | directory_obj *__dest) __THROW; | |
230 | extern nis_result *nis_clone_result (const nis_result *__src, | |
231 | nis_result *__dest) __THROW; | |
55c14926 UD |
232 | |
233 | /* nis_free - nis_freeresult */ | |
d82a27f8 | 234 | extern void nis_freeresult (nis_result *__result) __THROW; |
55c14926 | 235 | /* (XXX THE FOLLOWING ARE INTERNAL FUNCTIONS, SHOULD NOT BE USED !!) */ |
d82a27f8 JJ |
236 | extern void nis_free_request (ib_request *__req) __THROW; |
237 | extern void nis_free_directory (directory_obj *__dirobj) __THROW; | |
238 | extern void nis_free_object (nis_object *__obj) __THROW; | |
55c14926 UD |
239 | |
240 | /* (XXX INTERNAL FUNCTIONS, SHOULD NOT BE USED !!) */ | |
d8cf93f4 UD |
241 | extern nis_name __nis_default_owner (char *) __THROW; |
242 | extern nis_name __nis_default_group (char *) __THROW; | |
243 | extern uint32_t __nis_default_ttl (char *) __THROW; | |
244 | extern unsigned int __nis_default_access (char *, unsigned int) __THROW; | |
245 | extern fd_result *__nis_finddirectory (directory_obj *, const_nis_name) __THROW; | |
246 | extern void __free_fdresult (fd_result *) __THROW; | |
dfd2257a | 247 | |
55c14926 | 248 | /* NIS+ cache locking */ |
d8cf93f4 UD |
249 | extern int __nis_lock_cache (void) __THROW; |
250 | extern int __nis_unlock_cache (void) __THROW; | |
55c14926 | 251 | |
e852e889 UD |
252 | /* (XXX INTERNAL FUNCTIONS, ONLY FOR rpc.nisd AND glibc !!) */ |
253 | #if defined (NIS_INTERNAL) || defined (_LIBC) | |
254 | ||
255 | struct dir_binding | |
256 | { | |
257 | CLIENT *clnt; /* RPC CLIENT handle */ | |
258 | nis_server *server_val; /* List of servers */ | |
a1129917 UD |
259 | unsigned int server_len; /* # of servers */ |
260 | unsigned int server_used; /* Which server we are bind in the moment ? */ | |
261 | unsigned int current_ep; /* Which endpoint of the server are in use? */ | |
262 | unsigned int trys; /* How many server have we tried ? */ | |
263 | unsigned int class; /* From which class is server_val ? */ | |
e852e889 UD |
264 | bool_t master_only; /* Is only binded to the master */ |
265 | bool_t use_auth; /* Do we use AUTH ? */ | |
266 | bool_t use_udp; /* Do we use UDP ? */ | |
267 | struct sockaddr_in addr; /* Server's IP address */ | |
268 | int socket; /* Server's local socket */ | |
269 | }; | |
270 | typedef struct dir_binding dir_binding; | |
271 | ||
d8cf93f4 | 272 | extern nis_error __nisbind_create (dir_binding *, const nis_server *, |
697d37b1 JJ |
273 | unsigned int, unsigned int, unsigned int, |
274 | unsigned int) __THROW; | |
d8cf93f4 UD |
275 | extern nis_error __nisbind_connect (dir_binding *) __THROW; |
276 | extern nis_error __nisbind_next (dir_binding *) __THROW; | |
277 | extern void __nisbind_destroy (dir_binding *) __THROW; | |
697d37b1 JJ |
278 | extern nis_error __nisfind_server (const_nis_name, int, directory_obj **, |
279 | dir_binding *, unsigned int) __THROW; | |
e852e889 UD |
280 | |
281 | #endif | |
282 | ||
55c14926 UD |
283 | __END_DECLS |
284 | ||
285 | #endif /* __RPCSVC_NISLIB_H__ */ |