Changes between Version 52 and Version 53 of kernel_syscalls

Timestamp:

Dec 9, 2016, 7:03:38 PM (8 years ago)

Author:

alain

Comment:

--

kernel_syscalls

@@ -19 +19 @@
 == __Threads related syscall handlers__ ==
 
-=== 1) int '''_sys_pthread_create'''( pthread_t * buffer , void * attr , void * function , void * arg ) ===
+=== 1) int '''_sys_pthread_create'''( pthread_t * trdid , void * attr , void * function , void * arg ) ===
 This function search in the mapping a thread that is declared in the same space as the calling (parent) thread, 
 and has the entry point defined by the function <argument>. If it found a matching thread in the mapping,
 this thread is activated.
- * '''buffer''' : pointer on buffer to store the activated thread TRDID.
+ * '''trdid''' : pointer on buffer for allocated trdid.
  * '''attr''' : the attribute argument is not supported : must be NULL. 
  * '''function''' : pointer on the thread entry function.
@@ -30 +30 @@
 
 === 2) int '''_sys_pthread_join'''( pthread_t trdid ) ===
+This blocking function returns only when the thread identified by the <trdid> argument exit.
 
 === 3) int '''_sys_pthread_kill'''( pthread_t trdid , int signal ) ===
+This function send a SIGKILL signal to the thread identified by the <trdid> argument. The target thread will be desactivated at the next scheduling point. 
 
 === 4) int '''_sys_pthread_exit'''( void* string ) ===
+This function deschedules and desactivates the calling thread.
 
 === 5) int '''_sys_pthread_yield'''( ) ===
 
-=== 6) void '''_sys_kthread_create'''( unsigned int x , unsigned int y , unsigned int p , void * function , void * arg ) ===
+=== 6) void '''_sys_kthread_create'''( unsigned int * trdid , unsigned int x , unsigned int y , unsigned int p , void * function , void * arg ) ===
 This function initializes a kernel thread context, for a core identified by the <x,y,p> arguments, in a given scheduler.
 It allocate a new "ltid" and update the threads field in the scheduler.
 It is used in kernel-init to create the NIC_TX and NIC_RX kernel threads.
+ * '''trdid''' : pointer on buffer for allocated trdid.
  * '''x''' : X cluster coordinate.
  * '''y''' : Y cluster coordinate.