xref: /minix3/external/bsd/bind/dist/lib/isc/app_api.c (revision 00b67f09dd46474d133c95011a48590a8e8f94c7)
1*00b67f09SDavid van Moolenbroek /*	$NetBSD: app_api.c,v 1.7 2014/12/10 04:37:59 christos Exp $	*/
2*00b67f09SDavid van Moolenbroek 
3*00b67f09SDavid van Moolenbroek /*
4*00b67f09SDavid van Moolenbroek  * Copyright (C) 2009, 2013, 2014  Internet Systems Consortium, Inc. ("ISC")
5*00b67f09SDavid van Moolenbroek  *
6*00b67f09SDavid van Moolenbroek  * Permission to use, copy, modify, and/or distribute this software for any
7*00b67f09SDavid van Moolenbroek  * purpose with or without fee is hereby granted, provided that the above
8*00b67f09SDavid van Moolenbroek  * copyright notice and this permission notice appear in all copies.
9*00b67f09SDavid van Moolenbroek  *
10*00b67f09SDavid van Moolenbroek  * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
11*00b67f09SDavid van Moolenbroek  * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
12*00b67f09SDavid van Moolenbroek  * AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
13*00b67f09SDavid van Moolenbroek  * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
14*00b67f09SDavid van Moolenbroek  * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
15*00b67f09SDavid van Moolenbroek  * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
16*00b67f09SDavid van Moolenbroek  * PERFORMANCE OF THIS SOFTWARE.
17*00b67f09SDavid van Moolenbroek  */
18*00b67f09SDavid van Moolenbroek 
19*00b67f09SDavid van Moolenbroek /* Id: app_api.c,v 1.5 2009/09/02 23:48:02 tbox Exp  */
20*00b67f09SDavid van Moolenbroek 
21*00b67f09SDavid van Moolenbroek #include <config.h>
22*00b67f09SDavid van Moolenbroek 
23*00b67f09SDavid van Moolenbroek #include <unistd.h>
24*00b67f09SDavid van Moolenbroek 
25*00b67f09SDavid van Moolenbroek #include <isc/app.h>
26*00b67f09SDavid van Moolenbroek #include <isc/magic.h>
27*00b67f09SDavid van Moolenbroek #include <isc/mutex.h>
28*00b67f09SDavid van Moolenbroek #include <isc/once.h>
29*00b67f09SDavid van Moolenbroek #include <isc/util.h>
30*00b67f09SDavid van Moolenbroek 
31*00b67f09SDavid van Moolenbroek static isc_mutex_t createlock;
32*00b67f09SDavid van Moolenbroek static isc_once_t once = ISC_ONCE_INIT;
33*00b67f09SDavid van Moolenbroek static isc_appctxcreatefunc_t appctx_createfunc = NULL;
34*00b67f09SDavid van Moolenbroek 
35*00b67f09SDavid van Moolenbroek #define ISCAPI_APPMETHODS_VALID(m) ISC_MAGIC_VALID(m, ISCAPI_APPMETHODS_MAGIC)
36*00b67f09SDavid van Moolenbroek 
37*00b67f09SDavid van Moolenbroek static void
initialize(void)38*00b67f09SDavid van Moolenbroek initialize(void) {
39*00b67f09SDavid van Moolenbroek 	RUNTIME_CHECK(isc_mutex_init(&createlock) == ISC_R_SUCCESS);
40*00b67f09SDavid van Moolenbroek }
41*00b67f09SDavid van Moolenbroek 
42*00b67f09SDavid van Moolenbroek isc_result_t
isc_app_register(isc_appctxcreatefunc_t createfunc)43*00b67f09SDavid van Moolenbroek isc_app_register(isc_appctxcreatefunc_t createfunc) {
44*00b67f09SDavid van Moolenbroek 	isc_result_t result = ISC_R_SUCCESS;
45*00b67f09SDavid van Moolenbroek 
46*00b67f09SDavid van Moolenbroek 	RUNTIME_CHECK(isc_once_do(&once, initialize) == ISC_R_SUCCESS);
47*00b67f09SDavid van Moolenbroek 
48*00b67f09SDavid van Moolenbroek 	LOCK(&createlock);
49*00b67f09SDavid van Moolenbroek 	if (appctx_createfunc == NULL)
50*00b67f09SDavid van Moolenbroek 		appctx_createfunc = createfunc;
51*00b67f09SDavid van Moolenbroek 	else
52*00b67f09SDavid van Moolenbroek 		result = ISC_R_EXISTS;
53*00b67f09SDavid van Moolenbroek 	UNLOCK(&createlock);
54*00b67f09SDavid van Moolenbroek 
55*00b67f09SDavid van Moolenbroek 	return (result);
56*00b67f09SDavid van Moolenbroek }
57*00b67f09SDavid van Moolenbroek 
58*00b67f09SDavid van Moolenbroek isc_result_t
isc_appctx_create(isc_mem_t * mctx,isc_appctx_t ** ctxp)59*00b67f09SDavid van Moolenbroek isc_appctx_create(isc_mem_t *mctx, isc_appctx_t **ctxp) {
60*00b67f09SDavid van Moolenbroek 	isc_result_t result;
61*00b67f09SDavid van Moolenbroek 
62*00b67f09SDavid van Moolenbroek 	if (isc_bind9)
63*00b67f09SDavid van Moolenbroek 		return (isc__appctx_create(mctx, ctxp));
64*00b67f09SDavid van Moolenbroek 
65*00b67f09SDavid van Moolenbroek 	LOCK(&createlock);
66*00b67f09SDavid van Moolenbroek 
67*00b67f09SDavid van Moolenbroek 	REQUIRE(appctx_createfunc != NULL);
68*00b67f09SDavid van Moolenbroek 	result = (*appctx_createfunc)(mctx, ctxp);
69*00b67f09SDavid van Moolenbroek 
70*00b67f09SDavid van Moolenbroek 	UNLOCK(&createlock);
71*00b67f09SDavid van Moolenbroek 
72*00b67f09SDavid van Moolenbroek 	return (result);
73*00b67f09SDavid van Moolenbroek }
74*00b67f09SDavid van Moolenbroek 
75*00b67f09SDavid van Moolenbroek void
isc_appctx_destroy(isc_appctx_t ** ctxp)76*00b67f09SDavid van Moolenbroek isc_appctx_destroy(isc_appctx_t **ctxp) {
77*00b67f09SDavid van Moolenbroek 	REQUIRE(ctxp != NULL && ISCAPI_APPCTX_VALID(*ctxp));
78*00b67f09SDavid van Moolenbroek 
79*00b67f09SDavid van Moolenbroek 	if (isc_bind9)
80*00b67f09SDavid van Moolenbroek 		isc__appctx_destroy(ctxp);
81*00b67f09SDavid van Moolenbroek 	else
82*00b67f09SDavid van Moolenbroek 		(*ctxp)->methods->ctxdestroy(ctxp);
83*00b67f09SDavid van Moolenbroek 
84*00b67f09SDavid van Moolenbroek 	ENSURE(*ctxp == NULL);
85*00b67f09SDavid van Moolenbroek }
86*00b67f09SDavid van Moolenbroek 
87*00b67f09SDavid van Moolenbroek isc_result_t
isc_app_ctxstart(isc_appctx_t * ctx)88*00b67f09SDavid van Moolenbroek isc_app_ctxstart(isc_appctx_t *ctx) {
89*00b67f09SDavid van Moolenbroek 	REQUIRE(ISCAPI_APPCTX_VALID(ctx));
90*00b67f09SDavid van Moolenbroek 
91*00b67f09SDavid van Moolenbroek 	if (isc_bind9)
92*00b67f09SDavid van Moolenbroek 		return (isc__app_ctxstart(ctx));
93*00b67f09SDavid van Moolenbroek 
94*00b67f09SDavid van Moolenbroek 	return (ctx->methods->ctxstart(ctx));
95*00b67f09SDavid van Moolenbroek }
96*00b67f09SDavid van Moolenbroek 
97*00b67f09SDavid van Moolenbroek isc_result_t
isc_app_ctxrun(isc_appctx_t * ctx)98*00b67f09SDavid van Moolenbroek isc_app_ctxrun(isc_appctx_t *ctx) {
99*00b67f09SDavid van Moolenbroek 	REQUIRE(ISCAPI_APPCTX_VALID(ctx));
100*00b67f09SDavid van Moolenbroek 
101*00b67f09SDavid van Moolenbroek 	if (isc_bind9)
102*00b67f09SDavid van Moolenbroek 		return (isc__app_ctxrun(ctx));
103*00b67f09SDavid van Moolenbroek 
104*00b67f09SDavid van Moolenbroek 	return (ctx->methods->ctxrun(ctx));
105*00b67f09SDavid van Moolenbroek }
106*00b67f09SDavid van Moolenbroek 
107*00b67f09SDavid van Moolenbroek isc_result_t
isc_app_ctxonrun(isc_appctx_t * ctx,isc_mem_t * mctx,isc_task_t * task,isc_taskaction_t action,void * arg)108*00b67f09SDavid van Moolenbroek isc_app_ctxonrun(isc_appctx_t *ctx, isc_mem_t *mctx,
109*00b67f09SDavid van Moolenbroek 		 isc_task_t *task, isc_taskaction_t action,
110*00b67f09SDavid van Moolenbroek 		 void *arg)
111*00b67f09SDavid van Moolenbroek {
112*00b67f09SDavid van Moolenbroek 	REQUIRE(ISCAPI_APPCTX_VALID(ctx));
113*00b67f09SDavid van Moolenbroek 
114*00b67f09SDavid van Moolenbroek 	if (isc_bind9)
115*00b67f09SDavid van Moolenbroek 		return (isc__app_ctxonrun(ctx, mctx, task, action, arg));
116*00b67f09SDavid van Moolenbroek 
117*00b67f09SDavid van Moolenbroek 	return (ctx->methods->ctxonrun(ctx, mctx, task, action, arg));
118*00b67f09SDavid van Moolenbroek }
119*00b67f09SDavid van Moolenbroek 
120*00b67f09SDavid van Moolenbroek isc_result_t
isc_app_ctxsuspend(isc_appctx_t * ctx)121*00b67f09SDavid van Moolenbroek isc_app_ctxsuspend(isc_appctx_t *ctx) {
122*00b67f09SDavid van Moolenbroek 	REQUIRE(ISCAPI_APPCTX_VALID(ctx));
123*00b67f09SDavid van Moolenbroek 
124*00b67f09SDavid van Moolenbroek 	if (isc_bind9)
125*00b67f09SDavid van Moolenbroek 		return (isc__app_ctxsuspend(ctx));
126*00b67f09SDavid van Moolenbroek 
127*00b67f09SDavid van Moolenbroek 	return (ctx->methods->ctxsuspend(ctx));
128*00b67f09SDavid van Moolenbroek }
129*00b67f09SDavid van Moolenbroek 
130*00b67f09SDavid van Moolenbroek isc_result_t
isc_app_ctxshutdown(isc_appctx_t * ctx)131*00b67f09SDavid van Moolenbroek isc_app_ctxshutdown(isc_appctx_t *ctx) {
132*00b67f09SDavid van Moolenbroek 	REQUIRE(ISCAPI_APPCTX_VALID(ctx));
133*00b67f09SDavid van Moolenbroek 
134*00b67f09SDavid van Moolenbroek 	if (isc_bind9)
135*00b67f09SDavid van Moolenbroek 		return (isc__app_ctxshutdown(ctx));
136*00b67f09SDavid van Moolenbroek 
137*00b67f09SDavid van Moolenbroek 	return (ctx->methods->ctxshutdown(ctx));
138*00b67f09SDavid van Moolenbroek }
139*00b67f09SDavid van Moolenbroek 
140*00b67f09SDavid van Moolenbroek void
isc_app_ctxfinish(isc_appctx_t * ctx)141*00b67f09SDavid van Moolenbroek isc_app_ctxfinish(isc_appctx_t *ctx) {
142*00b67f09SDavid van Moolenbroek 	REQUIRE(ISCAPI_APPCTX_VALID(ctx));
143*00b67f09SDavid van Moolenbroek 
144*00b67f09SDavid van Moolenbroek 	if (isc_bind9)
145*00b67f09SDavid van Moolenbroek 		isc__app_ctxfinish(ctx);
146*00b67f09SDavid van Moolenbroek 
147*00b67f09SDavid van Moolenbroek 	ctx->methods->ctxfinish(ctx);
148*00b67f09SDavid van Moolenbroek }
149*00b67f09SDavid van Moolenbroek 
150*00b67f09SDavid van Moolenbroek void
isc_appctx_settaskmgr(isc_appctx_t * ctx,isc_taskmgr_t * taskmgr)151*00b67f09SDavid van Moolenbroek isc_appctx_settaskmgr(isc_appctx_t *ctx, isc_taskmgr_t *taskmgr) {
152*00b67f09SDavid van Moolenbroek 	REQUIRE(ISCAPI_APPCTX_VALID(ctx));
153*00b67f09SDavid van Moolenbroek 	REQUIRE(taskmgr != NULL);
154*00b67f09SDavid van Moolenbroek 
155*00b67f09SDavid van Moolenbroek 	if (isc_bind9)
156*00b67f09SDavid van Moolenbroek 		isc__appctx_settaskmgr(ctx, taskmgr);
157*00b67f09SDavid van Moolenbroek 
158*00b67f09SDavid van Moolenbroek 	ctx->methods->settaskmgr(ctx, taskmgr);
159*00b67f09SDavid van Moolenbroek }
160*00b67f09SDavid van Moolenbroek 
161*00b67f09SDavid van Moolenbroek void
isc_appctx_setsocketmgr(isc_appctx_t * ctx,isc_socketmgr_t * socketmgr)162*00b67f09SDavid van Moolenbroek isc_appctx_setsocketmgr(isc_appctx_t *ctx, isc_socketmgr_t *socketmgr) {
163*00b67f09SDavid van Moolenbroek 	REQUIRE(ISCAPI_APPCTX_VALID(ctx));
164*00b67f09SDavid van Moolenbroek 	REQUIRE(socketmgr != NULL);
165*00b67f09SDavid van Moolenbroek 
166*00b67f09SDavid van Moolenbroek 	if (isc_bind9)
167*00b67f09SDavid van Moolenbroek 		isc__appctx_setsocketmgr(ctx, socketmgr);
168*00b67f09SDavid van Moolenbroek 
169*00b67f09SDavid van Moolenbroek 	ctx->methods->setsocketmgr(ctx, socketmgr);
170*00b67f09SDavid van Moolenbroek }
171*00b67f09SDavid van Moolenbroek 
172*00b67f09SDavid van Moolenbroek void
isc_appctx_settimermgr(isc_appctx_t * ctx,isc_timermgr_t * timermgr)173*00b67f09SDavid van Moolenbroek isc_appctx_settimermgr(isc_appctx_t *ctx, isc_timermgr_t *timermgr) {
174*00b67f09SDavid van Moolenbroek 	REQUIRE(ISCAPI_APPCTX_VALID(ctx));
175*00b67f09SDavid van Moolenbroek 	REQUIRE(timermgr != NULL);
176*00b67f09SDavid van Moolenbroek 
177*00b67f09SDavid van Moolenbroek 	if (isc_bind9)
178*00b67f09SDavid van Moolenbroek 		isc__appctx_settimermgr(ctx, timermgr);
179*00b67f09SDavid van Moolenbroek 
180*00b67f09SDavid van Moolenbroek 	ctx->methods->settimermgr(ctx, timermgr);
181*00b67f09SDavid van Moolenbroek }
182*00b67f09SDavid van Moolenbroek 
183*00b67f09SDavid van Moolenbroek isc_result_t
isc_app_start(void)184*00b67f09SDavid van Moolenbroek isc_app_start(void) {
185*00b67f09SDavid van Moolenbroek 	if (isc_bind9)
186*00b67f09SDavid van Moolenbroek 		return (isc__app_start());
187*00b67f09SDavid van Moolenbroek 
188*00b67f09SDavid van Moolenbroek 	return (ISC_R_NOTIMPLEMENTED);
189*00b67f09SDavid van Moolenbroek }
190*00b67f09SDavid van Moolenbroek 
191*00b67f09SDavid van Moolenbroek isc_result_t
isc_app_onrun(isc_mem_t * mctx,isc_task_t * task,isc_taskaction_t action,void * arg)192*00b67f09SDavid van Moolenbroek isc_app_onrun(isc_mem_t *mctx, isc_task_t *task,
193*00b67f09SDavid van Moolenbroek 	       isc_taskaction_t action, void *arg)
194*00b67f09SDavid van Moolenbroek {
195*00b67f09SDavid van Moolenbroek 	if (isc_bind9)
196*00b67f09SDavid van Moolenbroek 		return (isc__app_onrun(mctx, task, action, arg));
197*00b67f09SDavid van Moolenbroek 
198*00b67f09SDavid van Moolenbroek 	return (ISC_R_NOTIMPLEMENTED);
199*00b67f09SDavid van Moolenbroek }
200*00b67f09SDavid van Moolenbroek 
201*00b67f09SDavid van Moolenbroek isc_result_t
isc_app_run()202*00b67f09SDavid van Moolenbroek isc_app_run() {
203*00b67f09SDavid van Moolenbroek 	if (isc_bind9)
204*00b67f09SDavid van Moolenbroek 		return (isc__app_run());
205*00b67f09SDavid van Moolenbroek 
206*00b67f09SDavid van Moolenbroek 	return (ISC_R_NOTIMPLEMENTED);
207*00b67f09SDavid van Moolenbroek }
208*00b67f09SDavid van Moolenbroek 
209*00b67f09SDavid van Moolenbroek isc_result_t
isc_app_shutdown(void)210*00b67f09SDavid van Moolenbroek isc_app_shutdown(void) {
211*00b67f09SDavid van Moolenbroek 	if (isc_bind9)
212*00b67f09SDavid van Moolenbroek 		return (isc__app_shutdown());
213*00b67f09SDavid van Moolenbroek 
214*00b67f09SDavid van Moolenbroek 	return (ISC_R_NOTIMPLEMENTED);
215*00b67f09SDavid van Moolenbroek }
216*00b67f09SDavid van Moolenbroek 
217*00b67f09SDavid van Moolenbroek isc_result_t
isc_app_reload(void)218*00b67f09SDavid van Moolenbroek isc_app_reload(void) {
219*00b67f09SDavid van Moolenbroek 	if (isc_bind9)
220*00b67f09SDavid van Moolenbroek 		return (isc__app_reload());
221*00b67f09SDavid van Moolenbroek 
222*00b67f09SDavid van Moolenbroek 	return (ISC_R_NOTIMPLEMENTED);
223*00b67f09SDavid van Moolenbroek }
224*00b67f09SDavid van Moolenbroek 
225*00b67f09SDavid van Moolenbroek void
isc_app_finish(void)226*00b67f09SDavid van Moolenbroek isc_app_finish(void) {
227*00b67f09SDavid van Moolenbroek 	if (!isc_bind9)
228*00b67f09SDavid van Moolenbroek 		return;
229*00b67f09SDavid van Moolenbroek 
230*00b67f09SDavid van Moolenbroek 	isc__app_finish();
231*00b67f09SDavid van Moolenbroek }
232*00b67f09SDavid van Moolenbroek 
233*00b67f09SDavid van Moolenbroek void
isc_app_block(void)234*00b67f09SDavid van Moolenbroek isc_app_block(void) {
235*00b67f09SDavid van Moolenbroek 	if (!isc_bind9)
236*00b67f09SDavid van Moolenbroek 		return;
237*00b67f09SDavid van Moolenbroek 
238*00b67f09SDavid van Moolenbroek 	isc__app_block();
239*00b67f09SDavid van Moolenbroek }
240*00b67f09SDavid van Moolenbroek 
241*00b67f09SDavid van Moolenbroek void
isc_app_unblock(void)242*00b67f09SDavid van Moolenbroek isc_app_unblock(void) {
243*00b67f09SDavid van Moolenbroek 	if (!isc_bind9)
244*00b67f09SDavid van Moolenbroek 		return;
245*00b67f09SDavid van Moolenbroek 
246*00b67f09SDavid van Moolenbroek 	isc__app_unblock();
247*00b67f09SDavid van Moolenbroek }
248