1/*
2 * Copyright (c) 2016 Oracle and/or its affiliates. All Rights Reserved.
3 *
4 * This program is free software: you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation, either version 2 of the License, or
7 * (at your option) any later version.
8 *
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12 * GNU General Public License for more details.
13 *
14 * You should have received a copy of the GNU General Public License
15 * along with this program. If not, see <http://www.gnu.org/licenses/>.
16 */
17
18#ifndef TST_SAFE_PTHREAD_H__
19#define TST_SAFE_PTHREAD_H__
20
21/*
22 * Macro to use for making functions called only once in
23 * multi-threaded tests such as init or cleanup function.
24 * The first call to @name_fn function by any thread shall
25 * call the @exec_fn. Subsequent calls shall not call @exec_fn.
26 * *_fn functions must not take any arguments.
27 */
28#define TST_DECLARE_ONCE_FN(name_fn, exec_fn)				\
29	void name_fn(void)						\
30	{								\
31		static pthread_once_t ltp_once = PTHREAD_ONCE_INIT;	\
32		pthread_once(&ltp_once, exec_fn);			\
33	}
34
35int safe_pthread_create(const char *file, const int lineno,
36			pthread_t *thread_id, const pthread_attr_t *attr,
37			void *(*thread_fn)(void *), void *arg);
38#define SAFE_PTHREAD_CREATE(thread_id, attr, thread_fn, arg) \
39	safe_pthread_create(__FILE__, __LINE__, thread_id, attr, thread_fn, arg)
40
41int safe_pthread_join(const char *file, const int lineno,
42		      pthread_t thread_id, void **retval);
43#define SAFE_PTHREAD_JOIN(thread_id, retval) \
44	safe_pthread_join(__FILE__, __LINE__, thread_id, retval)
45
46#endif /* TST_SAFE_PTHREAD_H__ */
47