Changeset 408 for trunk/hal/generic/hal_syscall.h

Timestamp:

Dec 5, 2017, 4:20:07 PM (6 years ago)

Author:

alain

Message:

Fix several bugs in the fork() syscall.

File:

• trunk/hal/generic/hal_syscall.h (modified) (1 diff)

trunk/hal/generic/hal_syscall.h

@@ -27 +27 @@
 #include <hal_types.h>
 
-//////////////////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////////////////
 //     Kernel-side syscall handler API
 //
-// This hal_do_syscall() function extract from the regs_tbl[] array the syscall index,
-// and the four syscall arguments. Then it calls the generic do_syscall() kernel function,
-// that call itself the relevant kernel function, depending on the syscall index.
+// This hal_do_syscall() function extract from the calling thread uzone array
+// the syscall index, and the four syscall arguments. 
+// Then it calls the generic do_syscall() function,
+// that calls itself the relevant kernel function, depending on the syscall index.
 //
-// Any architecture specific implementation must implement this API.
-//////////////////////////////////////////////////////////////////////////////////////////
-
-/**** forward declaration  ****/
-
-struct thread_s;
+// When the generic do_syscall function returns, it saves the return value
+// in the UZ_VO slot of the returning thread uzone, and update the UZ_EPC slot.
+// 
+// WARNING: The returning thread can be different from the entering thread 
+// in the case of a sys_fork() system call.
+///////////////////////////////////////////////////////////////////////////////////////
 
 
-/*****************************************************************************************
- * This function implements the ALMOS-MKH kernel_side syscall handler.
- *****************************************************************************************
- * @ this     : pointer on the calling thread.
- * @ regs_tbl : array containing the core registers values, saved by hal_kentry.
- ****************************************************************************************/
-void hal_do_syscall( struct thread_s * this,
-                     reg_t           * regs_tbl );
+/**************************************************************************************
+ * This function implements the syscall handler for the TSAR architecture.
+ *************************************************************************************/
+void hal_do_syscall();