[BACK]Return to gr_private.h CVS log [TXT][DIR] Up to [cvs.NetBSD.org] / src / lib / libc / gen

File: [cvs.NetBSD.org] / src / lib / libc / gen / gr_private.h (download)

Revision 1.1, Thu Jan 6 15:00:45 2005 UTC (19 years, 2 months ago) by lukem
Branch: MAIN
CVS Tags: yamt-pf42-baseX, yamt-pf42-base, wrstuden-fixsa-newbase, wrstuden-fixsa-base-1, wrstuden-fixsa-base, wrstuden-fixsa, netbsd-4-base, netbsd-4-0-RELEASE, netbsd-4-0-RC5, netbsd-4-0-RC4, netbsd-4-0-RC3, netbsd-4-0-RC2, netbsd-4-0-RC1, netbsd-4-0-1-RELEASE, netbsd-4-0, netbsd-4, netbsd-3-base, netbsd-3-1-RELEASE, netbsd-3-1-RC4, netbsd-3-1-RC3, netbsd-3-1-RC2, netbsd-3-1-RC1, netbsd-3-1-1-RELEASE, netbsd-3-1, netbsd-3-0-RELEASE, netbsd-3-0-RC6, netbsd-3-0-RC5, netbsd-3-0-RC4, netbsd-3-0-RC3, netbsd-3-0-RC2, netbsd-3-0-RC1, netbsd-3-0-3-RELEASE, netbsd-3-0-2-RELEASE, netbsd-3-0-1-RELEASE, netbsd-3-0, netbsd-3, matt-mips64-base, matt-mips64, matt-armv6-prevmlocking, matt-armv6-nbase, matt-armv6-base, matt-armv6, keiichi-mipv6-base, keiichi-mipv6, hpcarm-cleanup-base, hpcarm-cleanup, cube-autoconf-base, cube-autoconf, abandoned-netbsd-4-base, abandoned-netbsd-4
Branch point for: yamt-pf42

Rename various "internal" variables and functions and make non-static so other
internal libc source files can use these (including getgroupmembership(3)).

Be more consistent in the API that the __grscan_<source>() methods use.

In __grscan_compat() support an optional custom 'search' function used when a
"+" lookup is required.  Normally this will be getgrent() from group_compat,
but getgroupmembership(3) will use a tailored compat search routine for
efficiency.

/*	$NetBSD: gr_private.h,v 1.1 2005/01/06 15:00:45 lukem Exp $	*/

/*-
 * Copyright (c) 2004-2005 The NetBSD Foundation, Inc.
 * All rights reserved.
 *
 * This code is derived from software contributed to The NetBSD Foundation
 * by Luke Mewburn.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. All advertising materials mentioning features or use of this software
 *    must display the following acknowledgement:
 *	This product includes software developed by the NetBSD
 *	Foundation, Inc. and its contributors.
 * 4. Neither the name of The NetBSD Foundation nor the names of its
 *    contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

/*
 * Structures and functions used by various group(5) public functions
 * and their back-end implementations.
 * These are subject to change without notice and should not be used
 * outside of libc (even by third-party nss_*.so modules implementing
 * group(5) back-ends).
 */

#define _GROUP_COMPAT	/* "group" defaults to compat, so always provide it */


	/*
	 * mutex to serialize the public group(5) functions use of the
	 * back-end implementations, which may not be reentrant.
	 */
extern 	mutex_t		__grmutex;

	/*
	 * files methods
	 */
struct __grstate_files {	/* state shared between files methods */
	int	 stayopen;	/* see getgroupent(3) */
	FILE	*fp;		/* groups file handle */
};

extern int	__grstart_files(struct __grstate_files *);
extern int	__grend_files(struct __grstate_files *);
extern int	__grscan_files(int *, struct group *, char *, size_t,
			struct __grstate_files *, int, const char *, gid_t);

	/*
	 * dns methods
	 */
struct __grstate_dns {		/* state shared between dns methods */
	int	 stayopen;	/* see getgroupent(3) */
	void	*context;	/* Hesiod context */
	int	 num;		/* group index, -1 if no more */
};

extern int	__grstart_dns(struct __grstate_dns *);
extern int	__grend_dns(struct __grstate_dns *state);
extern int	__grscan_dns(int *, struct group *, char *, size_t,
			struct __grstate_dns *, int, const char *, gid_t);

	/*
	 * nis methods
	 */
struct __grstate_nis {		/* state shared between nis methods */
	int	 stayopen;	/* see getgroupent(3) */
	char	*domain;	/* NIS domain */
	int	 done;		/* non-zero if search exhausted */
	char	*current;	/* current first/next match */
	int	 currentlen;	/* length of _nis_current */
};

extern int	__grstart_nis(struct __grstate_nis *);
extern int	__grend_nis(struct __grstate_nis *);
extern int	__grscan_nis(int *, struct group *, char *, size_t,
			struct __grstate_nis *, int, const char *, gid_t);

	/*
	 * compat methods
	 */
struct __grstate_compat {	/* state shared between compat methods */
	int	 stayopen;	/* see getgroupent(3) */
	FILE	*fp;		/* file handle */
/*
 * XXX:	convert name to a separate compatstate enum and grow name as necessary
 *	instead of using strdup & free for each + line
 */
	char	*name;		/* NULL if reading file,	*/
				/*   "" if compat "+",		*/
				/* name if compat "+name"	*/
};

extern int	__grbad_compat(void *nsrv, void *nscb, va_list ap);
extern int	__grstart_compat(struct __grstate_compat *);
extern int	__grend_compat(struct __grstate_compat *);
extern int	__grscan_compat(int *, struct group *, char *, size_t,
			struct __grstate_compat *, int, const char *, gid_t,
			int (*)(void *, struct group **), void *);