rom/exec/etask.h

   1 #ifndef _ETASK_H
   2 #define _ETASK_H
   3
   4 /*
   5     Copyright © 1995-2012, The AROS Development Team. All rights reserved.
   6     $Id$
   7
   8     Desc: Internal description of the ETask structure
   9     Lang: english
  10 */
  11
  12 #include <exec/interrupts.h>
  13 #include <exec/tasks.h>
  14 #include <devices/timer.h>
  15
  16 #include <exec_platform.h>
  17
  18 #include "alertextra.h"
  19
  20 /* Known alert context types */
  21 #define AT_NONE     0x00
  22 #define AT_CPU      0x01
  23 #define AT_MUNGWALL 0x02
  24 #define AT_MEMORY   0x03
  25
  26 /* Alert data. Can have different contents, depending on what actually happened */
  27 struct AlertContext
  28 {
  29     union
  30     {
  31         struct ExceptionContext acpu;
  32         struct MungwallContext  amw;
  33         struct MMContext        amm;
  34     } u;
  35 };
  36
  37 struct IntETask
  38 {
  39     struct ETask       iet_ETask;
  40     APTR                iet_RT;                 /* Structure for resource tracking         */
  41 #if defined(__AROSEXEC_SMP__)
  42     IPTR                iet_CpuNumber;          /* core this task is currently running on  */
  43     IPTR                iet_CpuAffinity;        /* bitmap of cores this task can run on    */
  44     spinlock_t          *iet_SpinLock;          /* pointer to spinlock task is spinning on */
  45 #endif
  46     struct timeval      iet_StartTime;          /* time the task was launched              */
  47     struct timeval      iet_CpuTime;            /* time the task has spent running         */
  48     UQUAD               iet_private1;
  49     ULONG               iet_AlertCode;          /* Alert code for crash handler            */
  50     UBYTE               iet_AlertType;          /* Type of the alert context               */
  51     UBYTE               iet_AlertFlags;         /* See below                               */
  52     APTR                iet_AlertLocation;      /* Alert location for crash handler        */
  53     APTR                iet_AlertStack;         /* Frame pointer for stack backtrace       */
  54     struct AlertContext iet_AlertData;          /* Extra data coming with the crash        */
  55 #ifdef DEBUG_ETASK
  56     STRPTR              iet_Me;
  57 #endif
  58 };
  59
  60 #define GetIntETask(task)   ((struct IntETask *)GetETask(task))
  61 #define IntETask(etask)     ((struct IntETask *)(etask))
  62
  63 /* iet_AlertFlags */
  64 #define AF_Alert    0x01    /* The task is in alert state      */
  65 #define AF_Location 0x02    /* iet_AlertLocation is filled in */
  66
  67 /*
  68  * This function resets a task's crash status:
  69  * - AF_Alert flag serves as an actual indicator of crash status.
  70  *   If we enter Alert() with this flag already set, this is
  71  *   considered a nested alert and is directed to supervisor-mode routine.
  72  * - AF_Location flag can also be set only once. It is either set explicitly
  73  *   before calling Alert(), or it is set by Alert() routine itself. So we clear
  74  *   it in order for Alert() to be able to remember it if task ever alerts again.
  75  * - iet_AlertType specifies type of alert context (if any). We make sure
  76  *   it is clear so as next time Alert() will not display old information.
  77  */
  78 static inline void ResetETask(struct IntETask *etask)
  79 {
  80     etask->iet_AlertType  = AT_NONE;
  81     etask->iet_AlertFlags = 0;
  82 }
  83
  84 #endif /* _ETASK_H */