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

Timestamp:

Jul 18, 2019, 2:06:55 PM (5 years ago)

Author:

alain

Message:

Introduce the non-standard pthread_parallel_create() system call
and re-write the <fft> and <sort> applications to improve the
intrinsic paralelism in applications.

File:

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

trunk/kernel/syscalls/syscalls.h

@@ -210 +210 @@
 /****************************************************************************************** 
  * [13] This function map physical memory (or a file) in the calling thread virtual space.
- * The <attr> argument is a pointer on a structure for arguments (see shared_syscalls.h).
+ * The <attr> argument is a pointer on a structure for arguments (see shared_mman.h).
  * The user defined virtual address (MAP_FIXED flag) is not supported.
  * TODO : the access rights checking is not implemented yet [AG]
@@ -560 +560 @@
 
 /****************************************************************************************** 
- * [41] This function implements the non-standard get_core() syscall.
+ * [41] This function implements the non-standard get_core_id() syscall.
  * It returns in <cxy> and <lid> the calling core cluster and local index.
  ******************************************************************************************
@@ -567 +567 @@
  * @ return 0 if success / return -1 if illegal arguments
  *****************************************************************************************/
-int sys_get_core( uint32_t * cxy,
-                  uint32_t * lid );
+int sys_get_core_id( uint32_t * cxy,
+                     uint32_t * lid );
 
 /****************************************************************************************** 
@@ -696 +696 @@
 int sys_fsync( uint32_t file_id );
 
+/****************************************************************************************** 
+ * [53] This function implements the non-standard "get_best_core" syscall.
+ * It selects, in a macro-cluster specified by the <base_cxy> and <level> arguments,
+ * the core that has the lowest load.
+ * When an active core has been found in the target macro-cluster, it writes into the 
+ * <cxy> and <lid> buffers the cluster identifier and the core local index, and return 0.
+ * It returns -1 in case of illegal arguments (level / cxy / lid).
+ * It returns +1 if there is no active core in specified macro-cluster.
+ ******************************************************************************************
+ * @ base_cxy : [in]  any cluster identifier in macro-cluster.
+ * @ level    : [in]  macro-cluster level in [1,2,3,4,5].
+ * @ cxy      : [out] selected core cluster identifier.
+ * @ lid      : [out] selected core local index in cluster.
+ * @ return 0 if success / -1 if illegal arguments / +1 if no core in macro-clusters.
+ *****************************************************************************************/
+int sys_get_best_core( uint32_t   base_cxy,
+                       uint32_t   level,
+                       uint32_t * cxy,
+                       uint32_t * lid );
+
+/****************************************************************************************** 
+ * [54] This function implements the non-standard "get_nb_cores" syscall.
+ * It writes in the <ncores> buffer the number of cores in the target cluster <cxy>.
+ ******************************************************************************************
+ * @ cxy      : [in]  target cluster identifier.
+ * @ ncores   : [out] number of cores / 0 if cluster cxy undefined in architecture.
+ * @ return 0 if success / return -1 if illegal "ncores" arguments.
+ *****************************************************************************************/
+int sys_get_nb_cores( uint32_t   cxy,
+                      uint32_t * ncores );
+
 #endif  // _SYSCALLS_H_