1/*-
2 * SPDX-License-Identifier: BSD-2-Clause
3 *
4 * Copyright (c) 2003, Jeffrey Roberson <jeff@freebsd.org>
5 * All rights reserved.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 *    notice unmodified, this list of conditions, and the following
12 *    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 ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 *
28 */
29
30#ifndef _SYS_THR_H_
31#define	_SYS_THR_H_
32
33#include <sys/cdefs.h>
34#include <sys/_types.h>
35#include <sys/sched.h>
36
37#ifndef _SIZE_T_DECLARED
38typedef __size_t	size_t;
39#define _SIZE_T_DECLARED
40#endif
41
42/* Create the thread in the suspended state. */
43#define	THR_SUSPENDED		0x0001
44/* Create the system scope thread. */
45#define	THR_SYSTEM_SCOPE	0x0002
46
47struct thr_param {
48    void	(*start_func)(void *);	/* thread entry function. */
49    void	*arg;			/* argument for entry function. */
50    char	*stack_base;		/* stack base address. */
51    size_t	stack_size;		/* stack size. */
52    char	*tls_base;		/* tls base address. */
53    size_t	tls_size;		/* tls size. */
54    long	*child_tid;		/* address to store new TID. */
55    long	*parent_tid;		/* parent accesses the new TID here. */
56    int		flags;			/* thread flags. */
57    struct rtprio	*rtp;		/* Real-time scheduling priority */
58    void	*spare[3];		/* TODO: cpu affinity mask etc. */
59};
60
61/*
62 * See pthread_*
63 */
64#ifndef _KERNEL
65#include <sys/ucontext.h>
66
67#ifndef _PID_T_DECLARED
68typedef __pid_t		pid_t;
69#define _PID_T_DECLARED
70#endif
71
72__BEGIN_DECLS
73int thr_create(ucontext_t *ctx, long *id, int flags);
74int thr_new(struct thr_param *param, int param_size);
75int thr_self(long *id);
76void thr_exit(long *state);
77int thr_kill(long id, int sig);
78int thr_kill2(pid_t pid, long id, int sig);
79int thr_suspend(const struct timespec *timeout);
80int thr_wake(long id);
81int thr_set_name(long id, const char *name);
82__END_DECLS
83#endif /* !_KERNEL */
84
85#endif /* ! _SYS_THR_H_ */
86