Add TODO item.
[bertos.git] / kern / proc_p.h
index 4123e138240fbbbe6354c03ad6bcc18d9c4bf978..7ac481760e123f3c96208581bb8070ebcbda5b44 100755 (executable)
@@ -3,7 +3,7 @@
  * <!--
  * Copyright 2001, 2004 Develer S.r.l. (http://www.develer.com/)
  * Copyright 1999, 2000, 2001 Bernardo Innocenti <bernie@develer.com>
- * This file is part of DevLib - See devlib/README for information.
+ * This file is part of DevLib - See README.devlib for information.
  * -->
  *
  * \brief Internal scheduler structures and definitions for processes.
  * \author Bernardo Innocenti <bernie@develer.com>
  */
 
-/*
- * $Log$
- * Revision 1.6  2004/08/24 16:05:15  bernie
- * Add missing headers; Reformat.
- *
- * Revision 1.5  2004/08/14 19:37:57  rasky
- * Merge da SC: macros.h, pool.h, BIT_CHANGE, nome dei processi, etc.
- *
- * Revision 1.4  2004/07/30 14:24:16  rasky
- * Task switching con salvataggio perfetto stato di interrupt (SR)
- * Kernel monitor per dump informazioni su stack dei processi
- *
- * Revision 1.3  2004/07/14 14:18:09  rasky
- * Merge da SC: Rimosso timer dentro il task, che è uno spreco di memoria per troppi task
- *
- * Revision 1.2  2004/06/03 11:27:09  bernie
- * Add dual-license information.
- *
- * Revision 1.1  2004/05/23 17:27:00  bernie
- * Import kern/ subdirectory.
- *
- * Revision 1.3  2004/05/14 12:52:13  rasky
- * Importato supporto kernel per AVR da Stefano
- *
- * Revision 1.2  2004/04/28 16:13:49  rasky
- * proc_schedule() is now semi-private (used only within the kernel)
- *
- * Revision 1.1  2004/04/26 18:02:40  rasky
- * Importato microkernel
- *
- * Revision 1.1  2004/04/04 17:40:26  aleph
- * Add multithreading kernel
- *
- */
+/*#*
+ *#* $Log$
+ *#* Revision 1.15  2005/11/27 23:36:19  bernie
+ *#* Use appconfig.h instead of cfg/config.h.
+ *#*
+ *#* Revision 1.14  2005/11/04 16:20:02  bernie
+ *#* Fix reference to README.devlib in header.
+ *#*
+ *#* Revision 1.13  2005/04/11 19:10:28  bernie
+ *#* Include top-level headers from cfg/ subdir.
+ *#*
+ *#* Revision 1.12  2004/12/08 08:57:35  bernie
+ *#* Rename sigset_t to sigmask_t.
+ *#*
+ *#* Revision 1.11  2004/11/16 22:37:14  bernie
+ *#* Replace IPTR with iptr_t.
+ *#*
+ *#* Revision 1.10  2004/10/19 11:47:07  bernie
+ *#* Add missing #endif.
+ *#*
+ *#* Revision 1.9  2004/10/19 08:55:31  bernie
+ *#* Define forbid_cnt.
+ *#*
+ *#* Revision 1.8  2004/10/03 20:39:28  bernie
+ *#* Import changes from sc/firmware.
+ *#*
+ *#* Revision 1.7  2004/08/25 14:12:09  rasky
+ *#* Aggiornato il comment block dei log RCS
+ *#*
+ *#* Revision 1.6  2004/08/24 16:05:15  bernie
+ *#* Add missing headers; Reformat.
+ *#*
+ *#* Revision 1.5  2004/08/14 19:37:57  rasky
+ *#* Merge da SC: macros.h, pool.h, BIT_CHANGE, nome dei processi, etc.
+ *#*
+ *#* Revision 1.4  2004/07/30 14:24:16  rasky
+ *#* Task switching con salvataggio perfetto stato di interrupt (SR)
+ *#* Kernel monitor per dump informazioni su stack dei processi
+ *#*
+ *#* Revision 1.3  2004/07/14 14:18:09  rasky
+ *#* Merge da SC: Rimosso timer dentro il task, che è uno spreco di memoria per troppi task
+ *#*
+ *#* Revision 1.2  2004/06/03 11:27:09  bernie
+ *#* Add dual-license information.
+ *#*
+ *#* Revision 1.1  2004/05/23 17:27:00  bernie
+ *#* Import kern/ subdirectory.
+ *#*
+ *#* Revision 1.3  2004/05/14 12:52:13  rasky
+ *#* Importato supporto kernel per AVR da Stefano
+ *#*
+ *#* Revision 1.2  2004/04/28 16:13:49  rasky
+ *#* proc_schedule() is now semi-private (used only within the kernel)
+ *#*
+ *#* Revision 1.1  2004/04/26 18:02:40  rasky
+ *#* Importato microkernel
+ *#*
+ *#* Revision 1.1  2004/04/04 17:40:26  aleph
+ *#* Add multithreading kernel
+ *#*
+ *#*/
 #ifndef KERN_PROC_P_H
 #define KERN_PROC_P_H
 
-#include "compiler.h"
-#include "cpu.h"        /* for cpu_stack_t */
-#include "config.h"
-#include "config_kern.h"
+#include <cfg/compiler.h>
+#include <cfg/cpu.h>        /* for cpu_stack_t */
 #include <mware/list.h>
+#include <config_kern.h>
+#include <appconfig.h>
 
 typedef struct Process
 {
        Node         link;        /*!< Link Process into scheduler lists */
        cpustack_t  *stack;       /*!< Per-process SP */
-       IPTR         user_data;   /*!< Custom data passed to the process */
+       iptr_t       user_data;   /*!< Custom data passed to the process */
 
 #if CONFIG_KERN_SIGNALS
-       sigset_t     sig_wait;    /*!< Signals the process is waiting for */
-       sigset_t     sig_recv;    /*!< Received signals */
+       sigmask_t    sig_wait;    /*!< Signals the process is waiting for */
+       sigmask_t    sig_recv;    /*!< Received signals */
+#endif
+
+#if CONFIG_KERN_PREEMPTIVE
+       int          forbid_cnt;  /*!< Nesting count for proc_forbid()/proc_permit(). */
 #endif
 
 #if CONFIG_KERN_HEAP
@@ -87,27 +118,39 @@ typedef struct Process
 
 
 /*!
- * \name Flags for Process.flags
+ * \name Flags for Process.flags.
  * \{
  */
 #define PF_FREESTACK  BV(0)  /*!< Free the stack when process dies */
 /*\}*/
 
 
-/*! Track running processes */
+/*! Track running processes. */
 extern REGISTER Process        *CurrentProcess;
 
-/*! Track ready processes */
+/*! Track ready processes. */
 extern REGISTER List     ProcReadyList;
 
 
-/*!
- * Enqueue a task in the ready list
- */
+/*! Enqueue a task in the ready list. */
 #define SCHED_ENQUEUE(proc)  ADDTAIL(&ProcReadyList, &(proc)->link)
 
-/*! Schedule to another process *without* adding the current to the ready list */
+/*! Schedule to another process *without* adding the current to the ready list. */
 void proc_schedule(void);
 
+#if CONFIG_KERN_MONITOR
+       /*! Initialize the monitor */
+       void monitor_init(void);
+
+       /*! Register a process into the monitor */
+       void monitor_add(Process *proc, const char *name, cpustack_t *stack, size_t stacksize);
+
+       /*! Unregister a process from the monitor */
+       void monitor_remove(Process *proc);
+
+       /*! Rename a process */
+       void monitor_rename(Process *proc, const char* name);
+#endif /* CONFIG_KERN_MONITOR */
+
 #endif /* KERN_PROC_P_H */