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

Timestamp:

Apr 29, 2019, 7:25:09 PM (5 years ago)

Author:

alain

Message:

This version has been tested on the sort multithreaded application
for TSAR_IOB architectures ranging from 1 to 8 clusters.
It fixes three bigs bugs:
1) the dev_ioc device API has been modified: the dev_ioc_sync_read()
and dev_ioc_sync_write() function use now extended pointers on the
kernel buffer to access a mapper stored in any cluster.
2) the hal_uspace API has been modified: the hal_copy_to_uspace()
and hal_copy_from_uspace() functions use now a (cxy,ptr) couple
to identify the target buffer (equivalent to an extended pointer.
3) an implementation bug has been fixed in the assembly code contained
in the hal_copy_to_uspace() and hal_copy_from_uspace() functions.

File:

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

trunk/kernel/syscalls/syscalls.h

@@ -2 +2 @@
  * syscalls.h - Kernel side services for syscall handling.
  * 
- * Author     Alain Greiner (2016,2017,2018)
+ * Author     Alain Greiner (2016,2017,2018,2019)
  *
  * Copyright (c) UPMC Sorbonne Universites
@@ -584 +584 @@
  * [43] This debug function displays on the kernel terminal TXT0 an user defined string,
  * or the current state of a kernel structure, identified by the <type> argument.
- * The <arg0>, <arg1>, and <arg2> arguments depends on the structure type:
- * - DISPLAY_STRING          : an user defined string
- * - DISPLAY_VMM             : VSL and GPT for a process identified by <pid>.
- * - DISPLAY_SCHED           : all threads allocated to a scheduler <cxy> & <lid>.
- * - DISPLAY_CLUSTER_PROCESS : all processes registered in a cluster identified by <cxy>.  
- * - DISPLAY_TXT_PROCESS     : all processes registered in a cluster identified by <cxy>.  
- * - DISPLAY_VFS             : all files registered in the VFS cache. 
- * - DISPLAY_CHDEV           : all registered channel devices.
- * - DISPLAY_DQDT            : all DQDT nodes curren values.
- * - DISPLAY_BUSYLOCKS       : all busylocks taken by one thread.
- * - DISPLAY_MAPPER          : one page of a given mapper.
+ * The <arg0>, <arg1>, and <arg2> arguments depends on the structure type.
  ******************************************************************************************
  * type      : [in] type of display 
@@ -671 +661 @@
 
 /****************************************************************************************** 
- * [50] This function implements the exit system call terminating a POSIX process.
+ * [50] This function implements the "exit" system call terminating a POSIX process.
  * It can be called by any thread running in any cluster.
  * It uses both remote accesses to access the owner process descriptor, and the
- * RPC_PROCESS_SIGACTION to delete remote process and thread descriptors.
+ * RPC_PROCESS_SIGACTION to delete remote process copies and thread descriptors.
  * In the present implementation, this function implements actually the _exit():
  * - it does not flush open output streams.
  * - it does not close open streams.
  ******************************************************************************************
- * @ status   : terminaison status.
+ * @ status   : terminaison status returned to parent process.
+ * @ return 0 if success / return -1 if failure.
  *****************************************************************************************/
 int sys_exit( uint32_t status );
 
+/****************************************************************************************** 
+ * [51] This function implements the "sync" system call.
+ * It forces all modified pages in all kernel mappers to be copied to the IOC device.
+ * It can be called by any thread running in any cluster.
+ * TODO not implemented yet.
+ ******************************************************************************************
+ * @ return 0 if success / return -1 if failure.
+ *****************************************************************************************/
+int sys_sync( void );
+
+/****************************************************************************************** 
+ * [52] This function implements the "fsync" system call.
+ * It forces all modified pages of the file mapper identified by the <fd> argument
+ * to be copied to the IOC device.
+ * It can be called by any thread running in any cluster.
+ * TODO not implemented yet.
+ ******************************************************************************************
+ * @ file_id   : file descriptor index in fd_array.
+ * @ return 0 if success / return -1 if failure.
+ *****************************************************************************************/
+int sys_fsync( uint32_t file_id );
+
 #endif  // _SYSCALLS_H_