workbench/libs/thread/exitthread.c

   1 /*
   2  * thread.library - threading and synchronisation primitives
   3  *
   4  * Copyright © 2008 Markus Weiss
   5  *
   6  * This program is free software; you can redistribute it and/or modify it
   7  * under the same terms as AROS itself.
   8  */
   9
  10 #include "thread_intern.h"
  11
  12 /*****************************************************************************
  13
  14     NAME */
  15         AROS_LH1(void, ExitThread,
  16
  17 /*  SYNOPSIS */
  18         AROS_LHA(void *, result, A0),
  19
  20 /*  LOCATION */
  21         struct ThreadBase *, ThreadBase, 20, Thread)
  22
  23 /*  FUNCTION
  24         Exits the calling thread.
  25
  26     INPUTS
  27         result    - pointer to storage for the thread's return value. You can
  28                     pass NULL here if you don't care about the return value.
  29
  30     RESULT
  31         None, this function never returns.
  32
  33     NOTES
  34         This function is similar to the exit() function of arosc library.
  35
  36     EXAMPLE
  37         ExitThread(5);
  38
  39     BUGS
  40
  41     SEE ALSO
  42         WaitThread(), WaitAllThreads(), exit()
  43
  44     INTERNALS
  45
  46 *****************************************************************************/
  47 {
  48     AROS_LIBFUNC_INIT
  49
  50     struct _Thread *thread = _getthreadbytask(FindTask(NULL), ThreadBase);
  51     if (thread == NULL)
  52         /* if called from a task that is not a thread */
  53         return;
  54
  55     thread->result = result;
  56
  57     longjmp(thread->jmp, 1);
  58
  59     AROS_LIBFUNC_EXIT
  60 } /* ExitThread */