xref: /netbsd-src/sys/kern/subr_once.c (revision 88f5c690f5bca6efbe862ad67af5bfa73db547d8)
1 /*	$NetBSD: subr_once.c,v 1.7 2019/03/19 08:16:51 ryo Exp $	*/
2 
3 /*-
4  * Copyright (c)2005 YAMAMOTO Takashi,
5  * Copyright (c)2008 Antti Kantee,
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
21  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27  * SUCH DAMAGE.
28  */
29 
30 #include <sys/cdefs.h>
31 __KERNEL_RCSID(0, "$NetBSD: subr_once.c,v 1.7 2019/03/19 08:16:51 ryo Exp $");
32 
33 #include <sys/param.h>
34 #include <sys/systm.h>
35 #include <sys/condvar.h>
36 #include <sys/mutex.h>
37 #include <sys/once.h>
38 
39 static kmutex_t oncemtx;
40 static kcondvar_t oncecv;
41 
42 void
once_init(void)43 once_init(void)
44 {
45 
46 	mutex_init(&oncemtx, MUTEX_DEFAULT, IPL_NONE);
47 	cv_init(&oncecv, "runonce");
48 }
49 
50 int
_init_once(once_t * o,int (* fn)(void))51 _init_once(once_t *o, int (*fn)(void))
52 {
53 	/* Fastpath handled by RUN_ONCE() */
54 
55 	int error;
56 
57 	mutex_enter(&oncemtx);
58 	while (o->o_status == ONCE_RUNNING)
59 		cv_wait(&oncecv, &oncemtx);
60 
61 	if (o->o_refcnt++ == 0) {
62 		o->o_status = ONCE_RUNNING;
63 		mutex_exit(&oncemtx);
64 		o->o_error = fn();
65 		mutex_enter(&oncemtx);
66 		o->o_status = ONCE_DONE;
67 		cv_broadcast(&oncecv);
68 	}
69 	KASSERT(o->o_refcnt != 0);	/* detect overflow */
70 
71 	while (o->o_status == ONCE_RUNNING)
72 		cv_wait(&oncecv, &oncemtx);
73 	error = o->o_error;
74 	mutex_exit(&oncemtx);
75 
76 	return error;
77 }
78 
79 void
_fini_once(once_t * o,void (* fn)(void))80 _fini_once(once_t *o, void (*fn)(void))
81 {
82 	mutex_enter(&oncemtx);
83 	while (o->o_status == ONCE_RUNNING)
84 		cv_wait(&oncecv, &oncemtx);
85 
86 	KASSERT(o->o_refcnt != 0);	/* we need to call _init_once() once */
87 	if (--o->o_refcnt == 0) {
88 		o->o_status = ONCE_RUNNING;
89 		mutex_exit(&oncemtx);
90 		fn();
91 		mutex_enter(&oncemtx);
92 		o->o_status = ONCE_VIRGIN;
93 		cv_broadcast(&oncecv);
94 	}
95 
96 	mutex_exit(&oncemtx);
97 }
98