thread.h

Go to the documentation of this file.

 
/*
 * (c) 2003-2009 Author(s)
 *     economic rights: Technische Universität Dresden (Germany)
 * License: see LICENSE.spdx (in this directory or the directories above)
 */
 
#pragma once
 
#include <l4/sys/compiler.h>
#include <l4/sys/types.h>
#include <l4/sys/scheduler.h>
 
#include <l4/util/arch/thread.h>
 
L4_BEGIN_DECLS


L4_CV long
l4util_create_thread(l4_cap_idx_t id, l4_utcb_t *thread_utcb,
                     l4_cap_idx_t factory,
                     l4_umword_t pc, l4_umword_t sp, l4_cap_idx_t pager,
                     l4_cap_idx_t task,
                     l4_cap_idx_t scheduler, l4_sched_param_t scp) L4_NOTHROW;
 
L4_END_DECLS
 
#ifndef L4UTIL_THREAD_FUNC
# define __L4UTIL_THREAD_FUNC(name) void L4_NORETURN name(void)
# define L4UTIL_THREAD_FUNC(name) __L4UTIL_THREAD_FUNC(name)
# define __L4UTIL_THREAD_STATIC_FUNC(name) static L4_NORETURN void name(void)
# define L4UTIL_THREAD_STATIC_FUNC(name) __L4UTIL_THREAD_STATIC_FUNC(name)
#endif
 
#ifndef L4UTIL_THREAD_CXX_FUNC_HELPER_PROTO_ATTR
# define L4UTIL_THREAD_CXX_FUNC_HELPER_PROTO_ATTR
#endif
#ifndef L4UTIL_THREAD_CXX_FUNC_INTERRUPT_HELPER_PROTO_ATTR
# define L4UTIL_THREAD_CXX_FUNC_INTERRUPT_HELPER_PROTO_ATTR
#endif

#define _L4UTIL_THREAD_CXX_FUNC_IMPL_(suffix, class, fn_name, from_asm_name, ...)\
  asm (".global " L4_stringify(fn_name ## _stub)                  "\n"         \
       ".type " L4_stringify(fn_name ## _stub) " STT_FUNC          \n"         \
       L4_stringify(fn_name ## _stub) ":                           \n"         \
  L4UTIL_THREAD_CXX_FUNC_IMPL ## suffix ## _STUB(from_asm_name)                \
      );                                                                       \
                                                                               \
  [[noreturn]] void __attribute__((used)) class::from_asm_name(__VA_ARGS__)
 
#define _L4UTIL_THREAD_CXX_FUNC_IMPL(suffix, class, fn_name, ...)              \
  _L4UTIL_THREAD_CXX_FUNC_IMPL_(suffix, class, fn_name, fn_name ## _from_asm,  \
                                ##__VA_ARGS__)
 
#ifndef L4UTIL_THREAD_CXX_FUNC_PROTO

# define L4UTIL_THREAD_CXX_FUNC_PROTO(fn_name, ...) \
   [[noreturn]] static void fn_name(__VA_ARGS__) \
   asm (L4_stringify(fn_name ## _stub)); \
   [[noreturn]] static void fn_name ## _from_asm(__VA_ARGS__) \
   asm (L4_stringify(fn_name ## _from_asm))
 
#endif

 
#ifdef L4UTIL_THREAD_CXX_FUNC_IMPL_STUB
 
# define L4UTIL_THREAD_CXX_FUNC_IMPL(class, fn_name, ...) \
   _L4UTIL_THREAD_CXX_FUNC_IMPL(, class, fn_name, ##__VA_ARGS__)
 
#else /* !L4UTIL_THREAD_CXX_FUNC_IMPL_STUB */
 
# define L4UTIL_THREAD_CXX_FUNC_IMPL(class, fn_name, ...) \
   [[noreturn]] void class::fn_name(__VA_ARGS__)
 
#endif

#ifndef L4UTIL_THREAD_CXX_FUNC_IMPL_INTERRUPT_STUB
# error architecture-specific L4UTIL_THREAD_CXX_FUNC_IMPL_INTERRUPT_STUB missing
#endif
 
#define L4UTIL_THREAD_CXX_FUNC_INTERRUPT_IMPL(class, fn_name, ...) \
  _L4UTIL_THREAD_CXX_FUNC_IMPL(_INTERRUPT, class, fn_name, ##__VA_ARGS__)