1*0Sstevel@tonic-gate /*
2*0Sstevel@tonic-gate * CDDL HEADER START
3*0Sstevel@tonic-gate *
4*0Sstevel@tonic-gate * The contents of this file are subject to the terms of the
5*0Sstevel@tonic-gate * Common Development and Distribution License, Version 1.0 only
6*0Sstevel@tonic-gate * (the "License"). You may not use this file except in compliance
7*0Sstevel@tonic-gate * with the License.
8*0Sstevel@tonic-gate *
9*0Sstevel@tonic-gate * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10*0Sstevel@tonic-gate * or http://www.opensolaris.org/os/licensing.
11*0Sstevel@tonic-gate * See the License for the specific language governing permissions
12*0Sstevel@tonic-gate * and limitations under the License.
13*0Sstevel@tonic-gate *
14*0Sstevel@tonic-gate * When distributing Covered Code, include this CDDL HEADER in each
15*0Sstevel@tonic-gate * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16*0Sstevel@tonic-gate * If applicable, add the following below this CDDL HEADER, with the
17*0Sstevel@tonic-gate * fields enclosed by brackets "[]" replaced with your own identifying
18*0Sstevel@tonic-gate * information: Portions Copyright [yyyy] [name of copyright owner]
19*0Sstevel@tonic-gate *
20*0Sstevel@tonic-gate * CDDL HEADER END
21*0Sstevel@tonic-gate */
22*0Sstevel@tonic-gate /*
23*0Sstevel@tonic-gate * Copyright (c) 2002-2003, Network Appliance, Inc. All rights reserved.
24*0Sstevel@tonic-gate */
25*0Sstevel@tonic-gate
26*0Sstevel@tonic-gate /*
27*0Sstevel@tonic-gate * Copyright 2004 Sun Microsystems, Inc. All rights reserved.
28*0Sstevel@tonic-gate * Use is subject to license terms.
29*0Sstevel@tonic-gate */
30*0Sstevel@tonic-gate
31*0Sstevel@tonic-gate #pragma ident "%Z%%M% %I% %E% SMI"
32*0Sstevel@tonic-gate
33*0Sstevel@tonic-gate
34*0Sstevel@tonic-gate /*
35*0Sstevel@tonic-gate *
36*0Sstevel@tonic-gate * MODULE: dat_init.c
37*0Sstevel@tonic-gate *
38*0Sstevel@tonic-gate * PURPOSE: DAT registry implementation for uDAPL
39*0Sstevel@tonic-gate * Description: init and fini functions for DAT module.
40*0Sstevel@tonic-gate *
41*0Sstevel@tonic-gate * $Id: dat_init.c,v 1.12 2003/07/09 11:26:06 hobie16 Exp $
42*0Sstevel@tonic-gate */
43*0Sstevel@tonic-gate
44*0Sstevel@tonic-gate #include "dat_init.h"
45*0Sstevel@tonic-gate
46*0Sstevel@tonic-gate #include "dat_dr.h"
47*0Sstevel@tonic-gate #include "dat_osd.h"
48*0Sstevel@tonic-gate
49*0Sstevel@tonic-gate #ifndef DAT_NO_STATIC_REGISTRY
50*0Sstevel@tonic-gate #include "dat_sr.h"
51*0Sstevel@tonic-gate #endif
52*0Sstevel@tonic-gate
53*0Sstevel@tonic-gate
54*0Sstevel@tonic-gate /*
55*0Sstevel@tonic-gate *
56*0Sstevel@tonic-gate * Global Variables
57*0Sstevel@tonic-gate *
58*0Sstevel@tonic-gate */
59*0Sstevel@tonic-gate
60*0Sstevel@tonic-gate /*
61*0Sstevel@tonic-gate * Ideally, the following two rules could be enforced:
62*0Sstevel@tonic-gate *
63*0Sstevel@tonic-gate * - The DAT Registry's initialization function is executed before that
64*0Sstevel@tonic-gate * of any DAT Providers and hence all calls into the registry occur
65*0Sstevel@tonic-gate * after the registry module is initialized.
66*0Sstevel@tonic-gate *
67*0Sstevel@tonic-gate * - The DAT Registry's deinitialization function is executed after that
68*0Sstevel@tonic-gate * of any DAT Providers and hence all calls into the registry occur
69*0Sstevel@tonic-gate * before the registry module is deinitialized.
70*0Sstevel@tonic-gate *
71*0Sstevel@tonic-gate * However, on many platforms few guarantees are provided regarding the
72*0Sstevel@tonic-gate * order in which modules initialization and deinitialization functions
73*0Sstevel@tonic-gate * are invoked.
74*0Sstevel@tonic-gate *
75*0Sstevel@tonic-gate * To understand why these rules are difficult to enforce using only
76*0Sstevel@tonic-gate * features common to all platforms, consider the Linux platform. The order
77*0Sstevel@tonic-gate * in which Linux shared libraries are loaded into a process's address space
78*0Sstevel@tonic-gate * is undefined. When a DAT consumer explicitly links to DAT provider
79*0Sstevel@tonic-gate * libraries, the order in which library initialization and deinitialization
80*0Sstevel@tonic-gate * functions are invoked becomes important. For example if the DAPL provider
81*0Sstevel@tonic-gate * calls dat_registry_add_provider() before the registry has been initialized,
82*0Sstevel@tonic-gate * an error will occur.
83*0Sstevel@tonic-gate *
84*0Sstevel@tonic-gate * We assume that modules are loaded with a single thread. Given
85*0Sstevel@tonic-gate * this assumption, we can use a simple state variable to determine
86*0Sstevel@tonic-gate * the state of the DAT registry.
87*0Sstevel@tonic-gate */
88*0Sstevel@tonic-gate
89*0Sstevel@tonic-gate static DAT_MODULE_STATE g_module_state = DAT_MODULE_STATE_UNINITIALIZED;
90*0Sstevel@tonic-gate
91*0Sstevel@tonic-gate
92*0Sstevel@tonic-gate /*
93*0Sstevel@tonic-gate * Function: dat_module_get_state
94*0Sstevel@tonic-gate */
95*0Sstevel@tonic-gate
96*0Sstevel@tonic-gate DAT_MODULE_STATE
dat_module_get_state(void)97*0Sstevel@tonic-gate dat_module_get_state(void)
98*0Sstevel@tonic-gate {
99*0Sstevel@tonic-gate return (g_module_state);
100*0Sstevel@tonic-gate }
101*0Sstevel@tonic-gate
102*0Sstevel@tonic-gate
103*0Sstevel@tonic-gate /*
104*0Sstevel@tonic-gate * Function: dat_init
105*0Sstevel@tonic-gate */
106*0Sstevel@tonic-gate
107*0Sstevel@tonic-gate void
dat_init(void)108*0Sstevel@tonic-gate dat_init(void)
109*0Sstevel@tonic-gate {
110*0Sstevel@tonic-gate if (DAT_MODULE_STATE_UNINITIALIZED == g_module_state) {
111*0Sstevel@tonic-gate /*
112*0Sstevel@tonic-gate * update the module state flag immediately in case there
113*0Sstevel@tonic-gate * is a recursive call to dat_init().
114*0Sstevel@tonic-gate */
115*0Sstevel@tonic-gate g_module_state = DAT_MODULE_STATE_INITIALIZING;
116*0Sstevel@tonic-gate
117*0Sstevel@tonic-gate dat_os_dbg_init();
118*0Sstevel@tonic-gate
119*0Sstevel@tonic-gate dat_os_dbg_print(DAT_OS_DBG_TYPE_GENERIC,
120*0Sstevel@tonic-gate "DAT Registry: Started (dat_init)\n");
121*0Sstevel@tonic-gate
122*0Sstevel@tonic-gate #ifndef DAT_NO_STATIC_REGISTRY
123*0Sstevel@tonic-gate (void) dat_sr_init();
124*0Sstevel@tonic-gate #endif
125*0Sstevel@tonic-gate (void) dat_dr_init();
126*0Sstevel@tonic-gate
127*0Sstevel@tonic-gate g_module_state = DAT_MODULE_STATE_INITIALIZED;
128*0Sstevel@tonic-gate }
129*0Sstevel@tonic-gate }
130*0Sstevel@tonic-gate
131*0Sstevel@tonic-gate
132*0Sstevel@tonic-gate /*
133*0Sstevel@tonic-gate * Function: dat_fini
134*0Sstevel@tonic-gate */
135*0Sstevel@tonic-gate
136*0Sstevel@tonic-gate void
dat_fini(void)137*0Sstevel@tonic-gate dat_fini(void)
138*0Sstevel@tonic-gate {
139*0Sstevel@tonic-gate if (DAT_MODULE_STATE_INITIALIZED == g_module_state) {
140*0Sstevel@tonic-gate g_module_state = DAT_MODULE_STATE_DEINITIALIZING;
141*0Sstevel@tonic-gate
142*0Sstevel@tonic-gate (void) dat_dr_fini();
143*0Sstevel@tonic-gate #ifndef DAT_NO_STATIC_REGISTRY
144*0Sstevel@tonic-gate (void) dat_sr_fini();
145*0Sstevel@tonic-gate #endif
146*0Sstevel@tonic-gate dat_os_dbg_print(DAT_OS_DBG_TYPE_GENERIC,
147*0Sstevel@tonic-gate "DAT Registry: Stopped (dat_fini)\n");
148*0Sstevel@tonic-gate
149*0Sstevel@tonic-gate g_module_state = DAT_MODULE_STATE_DEINITIALIZED;
150*0Sstevel@tonic-gate }
151*0Sstevel@tonic-gate }
152*0Sstevel@tonic-gate
153*0Sstevel@tonic-gate
154*0Sstevel@tonic-gate /*
155*0Sstevel@tonic-gate * Local variables:
156*0Sstevel@tonic-gate * c-indent-level: 4
157*0Sstevel@tonic-gate * c-basic-offset: 4
158*0Sstevel@tonic-gate * tab-width: 8
159*0Sstevel@tonic-gate * End:
160*0Sstevel@tonic-gate */
161