Various small cleanups and comments added.

diff --git a/kernel/clock.c b/kernel/clock.c
index 008039db3faba6a36f6475a9f0ffc3f3dbeaf097..1b47081d6da13e6a8eb457c583507f6ff63a6669 100755 (executable)
--- a/kernel/clock.c
+++ b/kernel/clock.c
@@ -8,22 +8,21 @@
  * Changes:
  *   Mar 18, 2004   clock interface moved to SYSTEM task (Jorrit N. Herder) 
  *   Sep 30, 2004   source code documentation updated  (Jorrit N. Herder)
- *   Sep 24, 2004   redesigned timers and alarms  (Jorrit N. Herder)
+ *   Sep 24, 2004   redesigned alarm timers  (Jorrit N. Herder)
  *
- * The function do_clocktick() is not triggered from the clock library, but 
- * by the clock's interrupt handler when a watchdog timer has expired or 
- * another user process must be scheduled. 
+ * The function do_clocktick() is not triggered by the clock's interrupt 
+ * handler when a watchdog timer has expired or a process must be scheduled. 
  *
  * In addition to the main clock_task() entry point, which starts the main 
  * loop, there are several other minor entry points:
  *   clock_stop:       called just before MINIX shutdown
  *   get_uptime:       get realtime since boot in clock ticks
- *   set_timer:                set a watchdog timer (*, see note below!)
- *   reset_timer:      reset a watchdog timer (*)
+ *   set_timer:                set a watchdog timer (+)
+ *   reset_timer:      reset a watchdog timer (+)
  *   calc_elapsed:     do timing measurements: get delta ticks and pulses
  *   read_clock:       read the counter of channel 0 of the 8253A timer
  *
- * (*) The CLOCK task keeps tracks of watchdog timers for the entire kernel.
+ * (+) The CLOCK task keeps tracks of watchdog timers for the entire kernel.
  * The watchdog functions of expired timers are executed in do_clocktick(). 
  * It is crucial that watchdog functions cannot block, or the CLOCK task may
  * be blocked. Do not send() a message when the receiver is not expecting it.

diff --git a/kernel/system.c b/kernel/system.c
index 6fb2f810c9e453c27393f967296e27181022c1a4..438a72091494e06daea89262dad08154526cb64e 100755 (executable)
--- a/kernel/system.c
+++ b/kernel/system.c
@@ -21,7 +21,6 @@
  *   get_randomness:   accumulate randomness in a buffer
  *
  * Changes:
- *   2004 to 2005   many new system calls (see system.h)  (Jorrit N. Herder)
  *   Aug 04, 2005   check if kernel call is allowed  (Jorrit N. Herder)
  *   Jul 20, 2005   send signal to services with message  (Jorrit N. Herder) 
  *   Jan 15, 2005   new, generalized virtual copy function  (Jorrit N. Herder)

diff --git a/kernel/system/do_copy.c b/kernel/system/do_copy.c
index d685a4cfab40386703d22886c86e0e35bf6f96c5..e10630422bcd1227d2ca50cc5267051e4f5a2bbe 100644 (file)
--- a/kernel/system/do_copy.c
+++ b/kernel/system/do_copy.c
@@ -9,6 +9,9 @@
  *    m5_l2:   CP_DST_ADDR     
  *    m5_i2:   CP_DST_PROC_NR  
  *    m5_l3:   CP_NR_BYTES
+ *
+ * Changes:
+ *   Jan 20, 2005      updated to use new virtual_copy()  (Jorrit N. Herder)
  */
 
 #include "../system.h"

diff --git a/kernel/system/do_devio.c b/kernel/system/do_devio.c
index 5d22d63b8e7e64f2e6632e00778f28290361cd33..fe6028784f67014591ff2a4efe6c173f53bf92cf 100644 (file)
--- a/kernel/system/do_devio.c
+++ b/kernel/system/do_devio.c
@@ -6,6 +6,9 @@
  *   m2_i1:    DIO_TYPE        (flag indicating byte, word, or long)
  *   m2_l1:    DIO_PORT        (port to read/ write)   
  *   m2_l2:    DIO_VALUE       (value to write/ return value read)     
+ *
+ * Changes:
+ *   Feb 02, 2004   created to support user-space drivers  (Jorrit N. Herder) 
  */
 
 #include "../system.h"

diff --git a/kernel/system/do_exit.c b/kernel/system/do_exit.c
index 3eac7891b23fe90466297412b162c09d837a7020..71c860ca76f83cbe17e9b8eeb30fa46bb589c6f3 100644 (file)
--- a/kernel/system/do_exit.c
+++ b/kernel/system/do_exit.c
@@ -3,6 +3,9 @@
  *
  * The parameters for this system call are:
  *    m1_i1:   PR_PROC_NR              (slot number of exiting process)
+ *
+ * Changes:
+ *   Sep 09, 2004   updated to allow services to exit  (Jorrit N. Herder) 
  */
 
 #include "../system.h"

diff --git a/kernel/system/do_getinfo.c b/kernel/system/do_getinfo.c
index 9159a79d12a2412a0d5ae4eddf3d2e2c11424d0a..1a03a631bec211c8a412c61338bc14710fe044f0 100644 (file)
--- a/kernel/system/do_getinfo.c
+++ b/kernel/system/do_getinfo.c
@@ -7,6 +7,9 @@
  *    m1_i1:   I_VAL_LEN       (maximum length expected, optional)     
  *    m1_p2:   I_VAL_PTR2      (second, optional pointer)      
  *    m1_i2:   I_VAL_LEN2      (second length or process nr)   
+ *
+ * Changes:
+ *   May 24, 2004   Created.  (Jorrit N. Herder) 
  */
 
 #include "../system.h"

diff --git a/kernel/system/do_getksig.c b/kernel/system/do_getksig.c
index 8e3d0fe643d82cf8ddd502ec9531259e6adbe093..a8814252fb65b810292ce1944abc6ced5c5c4045 100644 (file)
--- a/kernel/system/do_getksig.c
+++ b/kernel/system/do_getksig.c
@@ -5,6 +5,8 @@
  *     m2_i1:  SIG_PROC        # process with pending signals
  *     m2_l1:  SIG_MAP         # bit map with pending signals
  *
+ * Changes:
+ *   Oct 24, 2004   Created.  (Jorrit N. Herder) 
  */
 
 #include "../system.h"

diff --git a/kernel/system/do_int86.c b/kernel/system/do_int86.c
index 004d4b9ea8550f9eea62885e7062c484afdd0568..41c631306fe7b0a1b316c34266e3d488ed988882 100644 (file)
--- a/kernel/system/do_int86.c
+++ b/kernel/system/do_int86.c
@@ -3,6 +3,9 @@
  *
  * The parameters for this system call are:
  *    m1_p1:   INT86_REG86     
+ * 
+ * Changes:
+ *   Jul 30, 2005   created to support BIOS driver  (Philip Homburg) 
  */
 
 #include "../system.h"

diff --git a/kernel/system/do_irqctl.c b/kernel/system/do_irqctl.c
index ae349c60ca510c2efbe5178764e023f8b602a6bf..f76965df105cc9c85dab285480ad9da9b680038a 100644 (file)
--- a/kernel/system/do_irqctl.c
+++ b/kernel/system/do_irqctl.c
@@ -7,6 +7,9 @@
  *    m5_i1:   IRQ_POLICY      (irq policy allows reenabling interrupts)
  *    m5_l3:   IRQ_HOOK_ID     (provides index to be returned on interrupt)
  *      ,,          ,,          (returns index of irq hook assigned at kernel)
+ *
+ * Changes:
+ *   Feb 24, 2004   Created to support user-space drivers  (Jorrit N. Herder) 
  */
 
 #include "../system.h"

diff --git a/kernel/system/do_kill.c b/kernel/system/do_kill.c
index 442a0e4e898f36e119e3b7d7dda0db4a79914bc7..648b35479ff061ab21f8a4fa0245ed3dad241363 100644 (file)
--- a/kernel/system/do_kill.c
+++ b/kernel/system/do_kill.c
@@ -4,6 +4,9 @@
  * The parameters for this system call are:
  *     m2_i1:  SIG_PROC        # process to signal/ pending            
  *     m2_i2:  SIG_NUMBER      # signal number to send to process
+ *
+ * Changes:
+ *   Jul 09, 2005   updated to signal system processes  (Jorrit N. Herder) 
  */
 
 #include "../system.h"

diff --git a/kernel/system/do_memset.c b/kernel/system/do_memset.c
index 0235c2e11ec3483a26b3609f713939841171e13c..fe37a40cc160c1b7e713e17b71ada5031f0e3a1a 100644 (file)
--- a/kernel/system/do_memset.c
+++ b/kernel/system/do_memset.c
@@ -5,6 +5,9 @@
  *    m2_p1:   MEM_PTR         (virtual address)       
  *    m2_l1:   MEM_COUNT       (returns physical address)      
  *    m2_l2:   MEM_PATTERN     (size of datastructure)         
+ *
+ * Changes:
+ *   Jun 21, 2005   created to speed up exec(2)  (Ben J. Gras)
  */
 
 #include "../system.h"

diff --git a/kernel/system/do_nice.c b/kernel/system/do_nice.c
index 879ae32ffc1e69f65fff72884f1af30773febdc9..ec7cc07b39ef979f30c698ed15fc9614da798720 100644 (file)
--- a/kernel/system/do_nice.c
+++ b/kernel/system/do_nice.c
@@ -4,6 +4,9 @@
  * The parameters for this system call are:
  *    m1_i1:   PR_PROC_NR      process number to change priority
  *    m1_i2:   PR_PRIORITY     the new priority
+ *
+ * Changes:
+ *   Jun 21, 2005   created for nice(2) system call  (Ben J. Gras)
  */
 
 #include "../system.h"

diff --git a/kernel/system/do_privctl.c b/kernel/system/do_privctl.c
index 8c2e8011c2228b762c014aca6debd2e13f616062..45ebec4e041e4b9e6a841d9642e05b2bb672cd6e 100644 (file)
--- a/kernel/system/do_privctl.c
+++ b/kernel/system/do_privctl.c
@@ -3,6 +3,9 @@
  *
  * The parameters for this system call are:
  *    m1_i1:   PR_PROC_NR      (process number of caller)      
+ *
+ * Changes:
+ *   Jul 13, 2005   created to dynamically start services  (Jorrit N. Herder) 
  */
 
 #include "../system.h"

diff --git a/kernel/system/do_sdevio.c b/kernel/system/do_sdevio.c
index 7ca526ddb8ddfce76298dd6b68e05cd06282c192..4084a8a4e7d3d45d96f83e3945ace17755d94852 100644 (file)
--- a/kernel/system/do_sdevio.c
+++ b/kernel/system/do_sdevio.c
@@ -8,6 +8,9 @@
  *    m2_p1:   DIO_VEC_ADDR    (virtual address of buffer)     
  *    m2_l2:   DIO_VEC_SIZE    (number of elements)    
  *    m2_i2:   DIO_VEC_PROC    (process where buffer is)       
+ *
+ * Changes:
+ *   May 24, 2004   Created to support user-space drivers  (Jorrit N. Herder) 
  */
 
 #include "../system.h"

diff --git a/kernel/system/do_segctl.c b/kernel/system/do_segctl.c
index 9b29e5f22f3e54e27ee291a88f36319c75d9ada0..91c88cb0f7bd90e67f1631c6a93485f9e20c5c5e 100644 (file)
--- a/kernel/system/do_segctl.c
+++ b/kernel/system/do_segctl.c
@@ -7,6 +7,9 @@
  *    m4_l1:   SEG_SELECT      (return segment selector here)
  *    m4_l2:   SEG_OFFSET      (return offset within segment here)
  *    m4_l5:   SEG_INDEX       (return index into remote memory map here)
+ *
+ * Changes:
+ *   Jul 13, 2004   created to support user-space drivers  (Jorrit N. Herder) 
  */
 #include "../system.h"
 #include "../protect.h"

diff --git a/kernel/system/do_unused.c b/kernel/system/do_unused.c
index c0278ade727677aaef8d098f4983ec1392d6a436..010f8d013b42d2a5264b89fb95e2aec1b23c674f 100644 (file)
--- a/kernel/system/do_unused.c
+++ b/kernel/system/do_unused.c
@@ -1,4 +1,10 @@
-
+/* This file provides a catch-all handler for unused system calls. A system 
+ * call may be unused when it is not defined or when it is disabled in the
+ * kernel's configuration.
+ *
+ * Changes:
+ *   Oct 10, 2004   created  (Jorrit N. Herder) 
+ */
 #include "../system.h"
 
 /*===========================================================================*
@@ -7,8 +13,7 @@
 PUBLIC int do_unused(m)
 message *m;                            /* pointer to request message */
 {
-  kprintf("SYSTEM got unused request %d", m->m_type);
-  kprintf("from %d.\n", m->m_source);
+  kprintf("SYSTEM: got unused request %d from %d", m->m_type, m->m_source);
   return(EBADREQUEST);         /* illegal message type */
 }
 

diff --git a/kernel/system/do_vcopy.c b/kernel/system/do_vcopy.c
index 47260cfc57d9f3e0f2c6600b66ee7783e03476c0..46543e0d0d4cdbfc9e25c347ed4c8edb3f11726d 100644 (file)
--- a/kernel/system/do_vcopy.c
+++ b/kernel/system/do_vcopy.c
@@ -5,6 +5,9 @@
  *    m1_i3:   VCP_VEC_SIZE            size of copy request vector 
  *    m1_p1:   VCP_VEC_ADDR            address of vector at caller 
  *    m1_i2:   VCP_NR_OK               number of successfull copies    
+ *
+ * Changes:
+ *   Apr 12, 2005      updated to use new virtual_copy()  (Jorrit N. Herder)
  */
 
 #include "../system.h"

diff --git a/kernel/system/do_vdevio.c b/kernel/system/do_vdevio.c
index dfc4a64052bc4dd17c282fd2c8f3509765ca2653..ef3dbe98487bfcfd3a963bff98c3ab5b3ddf8d25 100644 (file)
--- a/kernel/system/do_vdevio.c
+++ b/kernel/system/do_vdevio.c
@@ -6,6 +6,9 @@
  *    m2_i1:   DIO_TYPE        (flag indicating byte, word, or long)
  *    m2_p1:   DIO_VEC_ADDR    (pointer to port/ value pairs)  
  *    m2_i2:   DIO_VEC_SIZE    (number of ports to read or write) 
+ *
+ * Changes:
+ *   Apr 18, 2004   created to support user-space drivers  (Jorrit N. Herder) 
  */
 
 #include "../system.h"

diff --git a/kernel/table.c b/kernel/table.c
index 8645c1d3dd1a03468d4228750f47e116d6272461..93082917f20bd8bf181e6958ee8b00f4bfc61f5d 100755 (executable)
--- a/kernel/table.c
+++ b/kernel/table.c
@@ -72,7 +72,7 @@ PUBLIC char *t_stack[TOT_STACK_SPACE / sizeof(char *)];
 #define DRV_M  (USR_M | s(SYSTEM) | s(CLOCK) | s(LOG_PROC_NR) | s(TTY_PROC_NR))
 
 /* Define kernel calls that processes are allowed to make. This is not looking
- * very nice, but we really need to set access rights on a per call basis. 
+ * very nice, but we need to define the access rights on a per call basis. 
  * Note that the system services manager has all bits on, because it should
  * be allowed to distribute rights to services that it starts. 
  */