1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 /*
22  * Copyright 2006 Sun Microsystems, Inc.  All rights reserved.
23  * Use is subject to license terms.
24  */
25 
26 /*
27  * nsswitch_priv.h
28  *
29  * The original switch low level interface to switch was defined in
30  * /usr/include/nsswitch.h.  Although it was marked "Project Private",
31  * it was none-the-less "exposed" and used by several apps.  This
32  * file, nsswitch_priv.h will *not* go in /usr/include to limit "exposure"
33  * and contains new versions of the switch low level interface.
34  *
35  * This is a Project Private interface.  It may change in future releases.
36  */
37 
38 #ifndef _NSSWITCH_PRIV_H
39 #define	_NSSWITCH_PRIV_H
40 
41 #include <nsswitch.h>
42 
43 #ifdef	__cplusplus
44 extern "C" {
45 #endif
46 
47 
48 #define	__NSW_STD_ERRS_V1	5 /* V1 number of reserved errors */
49 
50 /*
51  * Results: the first of which are from /usr/include/nsswitch.h
52  *
53  * #define	__NSW_SUCCESS	0	 found the required data
54  * #define	__NSW_NOTFOUND	1 the naming service returned lookup failure
55  * #define	__NSW_UNAVAIL	2	 could not call the naming service
56  * #define	__NSW_TRYAGAIN	3	 bind error to suggest a retry
57  */
58 
59 /* nis server in dns forwarding mode and dns server non-response */
60 #define	__NSW_NISSERVDNS_TRYAGAIN	4
61 
62 /*
63  * Actions: the first of which are from /usr/include/nsswitch.h
64  *
65  * #define	__NSW_CONTINUE	0 the action is to continue to next service
66  * #define	__NSW_RETURN	1 the action is to return to the user
67  */
68 
69 /* the action is to retry the request until we get an answer */
70 #define	__NSW_TRYAGAIN_FOREVER	2
71 /* the action is to retry the request N times maximum */
72 #define	__NSW_TRYAGAIN_NTIMES	3
73 /* retried N times so disable try-again until service is restored */
74 #define	__NSW_TRYAGAIN_PAUSED	4
75 
76 /* is this action available to all switch errs? */
77 #define	__NSW_COMMON_ACTION(act)\
78 	(((act) == __NSW_CONTINUE) || ((act) == __NSW_RETURN))
79 
80 #define	__NSW_SUCCESS_ACTION(act)	__NSW_COMMON_ACTION(act)
81 #define	__NSW_NOTFOUND_ACTION(act)	__NSW_COMMON_ACTION(act)
82 #define	__NSW_UNAVAIL_ACTION(act)	__NSW_COMMON_ACTION(act)
83 #define	__NSW_TRYAGAIN_ACTION(act) \
84 	(__NSW_COMMON_ACTION(act) || \
85 	    ((act) == __NSW_TRYAGAIN_FOREVER) || \
86 	    ((act) == __NSW_TRYAGAIN_NTIMES))
87 #define	__NSW_UNPAUSE_ACTION(act)\
88 	(((act) == __NSW_TRYAGAIN_PAUSED) && ((act) = __NSW_TRYAGAIN_NTIMES))
89 
90 #define	__NSW_STR_FOREVER	"forever"
91 
92 #ifdef __NSS_PRIVATE_INTERFACE
93 
94 struct __nsw_lookup_v1 {
95 	char *service_name;
96 	action_t actions[__NSW_STD_ERRS_V1];
97 	int max_retries;  /* for TRYAGAIN=N */
98 	struct __nsw_long_err *long_errs;
99 	struct __nsw_lookup_v1 *next;
100 };
101 
102 struct __nsw_switchconfig_v1 {
103 	int vers;
104 	char *dbase;
105 	int num_lookups;
106 	struct __nsw_lookup_v1 *lookups;
107 };
108 
109 #define	__NSW_ACTION_V1(lkp, err) 	\
110 	((lkp)->next == NULL ? \
111 		__NSW_RETURN \
112 	: \
113 		((err) >= 0 && (err) < __NSW_STD_ERRS_V1 ? \
114 			(lkp)->actions[err] \
115 		: \
116 			__nsw_extended_action_v1(lkp, err)))
117 
118 
119 struct __nsw_switchconfig_v1 *__nsw_getconfig_v1
120 	(const char *, enum __nsw_parse_err *);
121 int __nsw_freeconfig_v1(struct __nsw_switchconfig_v1 *);
122 action_t __nsw_extended_action_v1(struct __nsw_lookup_v1 *, int);
123 
124 #endif /* __NSS_PRIVATE_INTERFACE */
125 
126 #ifdef	__cplusplus
127 }
128 #endif
129 
130 #endif /* _NSSWITCH_PRIV_H */
131