Changes between Version 51 and Version 52 of kernel_syscalls

Timestamp:

Dec 5, 2016, 12:54:53 AM (7 years ago)

Author:

alain

Comment:

--

kernel_syscalls

@@ -19 +19 @@
 == __Threads related syscall handlers__ ==
 
-=== 1) int '''_sys_pthread_create'''( pthread_t* buffer , void* function ) ===
+=== 1) int '''_sys_pthread_create'''( pthread_t * buffer , 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.
+ * '''attr''' : the attribute argument is not supported : must be NULL. 
+ * '''function''' : pointer on the thread entry function.
+ * '''arg''' : pointer on function argument. 
+Returns 0 if success / returns -1 if matching thread not found.
 
 === 2) int '''_sys_pthread_join'''( pthread_t trdid ) ===
@@ -28 +36 @@
 
 === 5) int '''_sys_pthread_yield'''( ) ===
+
+=== 6) void '''_sys_kthread_create'''( 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.
+ * '''x''' : X cluster coordinate.
+ * '''y''' : Y cluster coordinate.
+ * '''p''' : local processor index in cluster.
+ * '''function''' : pointer on the thread entry function.
+ * '''arg''' : pointer on function argument. 
 
 == __Coprocessors related syscall handlers__ ==