sys/sys/thr.h

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