1 + l=J76o |?_I|+2 /* Copyright (C) 1997, 1998, 1999, 2006, 2007, 2009 Free Software Foundation, Inc. This file is part of the GNU C Library. Contributed by Thorsten Kukuk , 1997. The GNU C Library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. The GNU C Library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with the GNU C Library; if not, see . */ #ifndef __RPCSVC_NISLIB_H__ #define __RPCSVC_NISLIB_H__ #include __BEGIN_DECLS typedef const char *const_nis_name; /* nis_names: These functions are used to locate and manipulate all NIS+ * objects except the NIS+ entry objects. * * nis_lookup (name, flags) resolves a NIS+ name and returns a copy of * that object from a NIS+ server. * const nis_name name: name of the object to be resolved * unsigned int flags: logically ORing zero or more flags (FOLLOW_LINKS, * HARD_LOOKUP, [NO_CACHE], MASTER_ONLY, EXPAND_NAME) * * nis_add (name, obj) adds objects to the NIS+ namespace. * const nis_name name: fully qualified NIS+ name. * const nis_object *obj: object members zo_name and zo_domain will be * constructed from name. * * nis_remove (name, obj) removes objects from the NIS+ namespace. * const nis_name name: fully qualified NIS+ name. * const nis_object *obj: if not NULL, it is assumed to point to a copy * of the object being removed. In this case, if * the object on the server does not have the same * object identifier as the object being passed, * the operation will fail with the NIS_NOTSAMEOBJ * error. * * nis_modify (name, obj) can change specific attributes of an object * that already exists in the namespace. */ extern nis_result *nis_lookup (const_nis_name name, unsigned int flags) __THROW; extern nis_result *nis_add (const_nis_name name, const nis_object *obj) __THROW; extern nis_result *nis_remove (const_nis_name name, const nis_object *obj) __THROW; extern nis_result *nis_modify (const_nis_name name, const nis_object *obj) __THROW; /* nis_tables: These functions are used to search and modify NIS+ tables. * * nis_list (table_name, flags, callback(table_name, obj, userdata), userdata) * search a table in the NIS+ namespace. * const nis_name table_name: indexed name ([xx=yy],table.dir) * unsigned int flags: logically ORing one or more flags (FOLLOW_LINKS, * [FOLLOW_PATH], HARD_LOOKUP, [ALL_RESULTS], [NO_CACHE], * MASTER_ONLY, EXPAND_NAME, RETURN_RESULT) * callback(): callback is an optional pointer to a function that will * process the ENTRY type objects that are returned from the * search. If this pointer is NULL, then all entries that match * the search criteria are returned in the nis_result structure, * otherwise this function will be called once for each * entry returned. * void *userdata: passed to callback function along with the returned * entry object. * * nis_add_entry (table_name, obj, flags) will add the NIS+ object to the * NIS+ table_name. * const nis_name table_name * const nis_object *obj * unsigned int flags: 0, ADD_OVERWRITE, RETURN_RESULT