Changeset 683 for trunk/kernel/syscalls/syscalls.h

Timestamp:

Jan 13, 2021, 12:36:17 AM (3 years ago)

Author:

alain

Message:

All modifications required to support the <tcp_chat> application
including error recovery in case of packet loss.A

File:

• trunk/kernel/syscalls/syscalls.h (modified) (6 diffs)

trunk/kernel/syscalls/syscalls.h

@@ -38 +38 @@
 
 /****************************************************************************************** 
- * This function forces the calling thread to sleep, for a fixed number of cycles.
- ******************************************************************************************
- * cycles   : number of cycles.
- *****************************************************************************************/
-int sys_alarm( uint32_t cycles );
+ * This function forces the calling thread to sleep, for a fixed number of seconds.
+ ******************************************************************************************
+ * @ seconds   : number of seconds.
+ *****************************************************************************************/
+int sys_alarm( uint32_t seconds );
 
 /****************************************************************************************** 
@@ -229 +229 @@
 
 /****************************************************************************************** 
+ * This generic function implements all the non standard syscalls of type "get_xxx()",
+ * defined in the <almosmkh.h> and <almosmkh.c> files.
+ * The operation types mnemonics are defined in the <shared_almos.h> file.
+ * This function ckecks the syscall arguments, and call the relevant kernel function.
+ ******************************************************************************************
+ * @ arg0       : operation type (mnemonics defined in shared_get.h)
+ * @ arg1       : depends on operation type
+ * @ arg2       : depends on operation type
+ * @ arg3       : depends on operation type
+ * @ return 0 if success / return -1 if illegal argument.
+ *****************************************************************************************/
+int sys_get( reg_t   arg0,
+             reg_t   arg1,
+             reg_t   arg2,
+             reg_t   arg3 );
+
+/****************************************************************************************** 
  * This function implements the non-standard "get_best_core" syscall.
  * It selects, in a macro-cluster specified by the <base_cxy> and <level> arguments,
@@ -470 +487 @@
  * as a remote_buffer_t, creates two (read and write) file descriptors, and links these
  * two file descriptors to the pipe.
- * TODO : the dynamic memory allocation in case of buffer full is not implemented.
+ * TODO  : the dynamic memory allocation in case of buffer full is not implemented.
+ * FIXME : wich syscall release the kernel memory allocated by this syscall ?
  ******************************************************************************************
  * @ fd   : pointeur on a 2 slots array of fdid : fd[0] read / fd[1] write.
@@ -566 +584 @@
 
 /****************************************************************************************** 
- * This generic function implements the socket related syscalls.
+ * This generic function implements all socket related syscalls.
  * The operation types mnemonics are defined in the <shared_socket> file.
  * The supported operations are defined in the <socket.h> & <socket.c> files.
@@ -686 +704 @@
 
 /****************************************************************************************** 
- * This function block the calling thread on the THREAD_BLOCKED_GLOBAL condition,
- * and deschedule.
- ******************************************************************************************
- * @ return 0 if success / returns -1 if failure.
- *****************************************************************************************/
-int sys_thread_sleep( void );
+ * This function blocks the calling thread on the THREAD_BLOCKED_SLEEP condition,
+ * and deschedules. When the <seconds> argument is non-zero, this argument defines
+ * the sleeping time. When it is zero, the sleeping time is unbounded, and the thread
+ * must be unblocked by the sys_thread_wakeup() function
+ ******************************************************************************************
+ * @ seconds : number of seconds of sleep / No alarm is activated when 0. 
+ * @ return 0 if success / returns -1 if failure.
+ *****************************************************************************************/
+int sys_thread_sleep( uint32_t seconds );
 
 /****************************************************************************************** 
  * This function unblock the thread identified by its <trdid> from the 
- * THREAD_BLOCKED_GLOBAL condition.
+ * THREAD_BLOCKED_SLEEP condition, and cancel the registered alarm if required.
  ******************************************************************************************
  * @ trdid  : target thread identifier.
@@ -705 +726 @@
  * This function calls the scheduler for the core running the calling thread.
  ******************************************************************************************
- * @ x_size   : [out] number of clusters in a row.
- * @ y_size   : [out] number of clusters in a column.
- * @ ncores   : [out] number of cores per cluster.
  * @ return always 0.
  *****************************************************************************************/