Changeset 673104e in mainline

Timestamp:

2005-06-03T15:10:05Z (20 years ago)

Author:

Martin Decky <martin@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

d1a184f

Parents:

70527f1

Message:

doxygen-style comments
NDEBUG in Makefile.config

Files:

• include/userspace.h (modified) (1 diff)
• src/Makefile.config (modified) (1 diff)
• src/cpu/cpu.c (modified) (1 diff)
• src/main/main.c (modified) (4 diffs)

include/userspace.h

@@ -30 +30 @@
 #define __USERSPACE_H__
 
-extern void userspace(void) __attribute__ ((noreturn));
+extern void userspace(void) __attribute__ ((noreturn)); /**< Switch to user-space (CPU user priviledge level) */
 
 #endif

src/Makefile.config

@@ -10 +10 @@
 # Improved support for hyperthreading
 HT=__HT__
+
+# General debuging and assert checking disable
+#NDEBUG=__NDEBUG__
 
 # Deadlock detection support for spinlocks.

src/cpu/cpu.c

@@ -44 +44 @@
 cpu_t *cpus;
 
+
+/** Initialize CPUs
+ *
+ * Initialize kernel CPUs support.
+ *
+ */
 void cpu_init(void) {
         int i, j;

src/main/main.c

@@ -85 +85 @@
 static void main_ap_separated_stack(void);
 
-/*
- * Executed by the bootstrap processor. cpu_priority_high()'d
+
+/** Bootstrap CPU main kernel routine
+ *
+ * Initializes the kernel by bootstrap CPU.
+ *
+ * Assuming cpu_priority_high().
+ *
  */
 void main_bsp(void)
@@ -103 +108 @@
 }
 
+
+/** Bootstrap CPU main kernel routine stack wrapper
+ *
+ * Second part of main_bsp().
+ *
+ */
 void main_bsp_separated_stack(void) {
         vm_t *m;
@@ -162 +173 @@
 }
 
+
 #ifdef __SMP__
-/*
- * Executed by application processors. cpu_priority_high()'d
- * Temporary stack is at ctx.sp which was set during BP boot.
+/** Application CPUs main kernel routine
+ *
+ * Executed by application processors, temporary stack
+ * is at ctx.sp which was set during BP boot.
+ *
+ * Assuming  cpu_priority_high().
+ *
  */
 void main_ap(void)
@@ -199 +215 @@
 }
 
+
+/** Application CPUs main kernel routine stack wrapper
+ *
+ * Second part of main_ap().
+ *
+ */
 void main_ap_separated_stack(void)
 {