Changeset 589 for trunk/libs/libalmosmkh/almosmkh.h

Timestamp:

Nov 1, 2018, 12:48:51 PM (5 years ago)

Author:

alain

Message:

Introduce a pause() syscall in mini-libc/unistd library.

File:

• trunk/libs/libalmosmkh/almosmkh.h (modified) (14 diffs)

trunk/libs/libalmosmkh/almosmkh.h

@@ -39 +39 @@
 
 /*************************************************************************************** 
- * This function is used to give the process identified by the <pid> argument the 
- * exclusive ownership of its TXT terminal.
+ * This syscall gives the process identified by the <pid> argument the exclusive 
+ * ownership of its TXT terminal.
  *************************************************************************************** 
  * @ pid        : process identifier.
@@ -48 +48 @@
 
 /*************************************************************************************** 
- * This function stores in the buffer identified by the <owner> argument a non zero
+ * This syscall stores in the buffer identified by the <owner> argument a non zero
  * value when the process identified by the <pid> argument is currently the exclusive
  * owner of its TXT terminal.
@@ -60 +60 @@
 
 /*************************************************************************************** 
- * This function returns the hardware platform parameters.
+ * This syscall returns the hardware platform parameters.
  ***************************************************************************************
  * @ x_size   : [out] number of clusters in a row.
@@ -72 +72 @@
 
 /*************************************************************************************** 
- * This function returns the cluster an local index for the calling core.
+ * This syscall returns the cluster an local index for the calling core.
  ***************************************************************************************
  * @ cxy      : [out] cluster identifier.
@@ -90 +90 @@
 int get_cycle( unsigned long long * cycle );
 
-/*************************************************************************************** 
- * This function implement the operations related to User Thread Local Storage.
+/***************************************************************************************
+ * This syscall allows the calling thread to specify the target cluster for
+ * a subsequent fork(). It must be called for each fork().
+ ***************************************************************************************
+ * @ cxy      : [in] target cluster identifier.
+ * @ return 0 if success / returns -1 if illegal cxy argument.
+ **************************************************************************************/
+int place_fork( unsigned int cxy );
+
+/*************************************************************************************** 
+ * This syscall implements the operations related to User Thread Local Storage.
  ***************************************************************************************
  * @ operation  : UTLS operation type as defined in "shared_sycalls.h" file.
@@ -101 +110 @@
 
 /***************************************************************************************
- * This function returns an unsigned 32 bits integer from the standard "stdin" stream.
+ * This syscall returns an unsigned 32 bits integer from the standard "stdin" stream.
  * Both decimal numbers and hexadecimal numbers (prefixed by 0x) are supported.
  ***************************************************************************************
  * returns the integer value if success / returns -1 if failure.
  **************************************************************************************/
-unsigned int getint32( void );
+unsigned int get_uint32( void );
 
 
@@ -113 +122 @@
 
 /*************************************************************************************** 
- * This debug function displays on the kernel terminal TXT0
+ * This debug syscall displays on the kernel terminal TXT0
  * the thread / process / core identifiers, the current cycle, plus a user defined
  * message as specified by the <string> argument. 
@@ -132 +141 @@
 
 /*************************************************************************************** 
- * This debug function displays on the kernel terminal TXT0 
+ * This debug syscall displays on the kernel terminal TXT0 
  * the state of the core scheduler identified by the <cxy> and <lid> arguments.
  * It can be called by any thread running in any cluster.
@@ -144 +153 @@
 
 /*************************************************************************************** 
- * This debug function displays on the kernel terminal TXT0 
+ * This debug syscall displays on the kernel terminal TXT0 
  * the list of process registered in a given cluster identified by the <cxy> argument.
+ * Only the owned processes are displayed when the <owned> argument is non zero.
  * It can be called by any thread running in any cluster.
  ***************************************************************************************
  * @ cxy      : [in] target cluster identifier.
+ * @ owned    : [in] only owned processes if non zero.
  * @ return 0 if success / return -1 if illegal argument.
  **************************************************************************************/
-int display_cluster_processes( unsigned int  cxy );
-
-/*************************************************************************************** 
- * This debug function displays on the kernel terminal TXT0 
+int display_cluster_processes( unsigned int  cxy,
+                               unsigned int  owned );
+
+/*************************************************************************************** 
+ * This debug syscall displays on the kernel terminal TXT0 
  * the list of processes attached to a given TXT channel.
  * It can be called by any thread running in any cluster.
@@ -164 +176 @@
 
 /*************************************************************************************** 
- * This debug function displays on the kernel terminal TXT0 
+ * This debug syscall displays on the kernel terminal TXT0 
  * the list of channel devices available in the architecture.
  * It can be called by any thread running in any cluster.
@@ -173 +185 @@
 
 /*************************************************************************************** 
- * This debug function displays on the kernel terminal TXT0 
+ * This debug syscall displays on the kernel terminal TXT0 
  * the list of channel device or pseudo-files registered in the VFS cache.
  * It can be called by any thread running in any cluster.
@@ -182 +194 @@
 
 /*************************************************************************************** 
- * This debug function displays on the kernel terminal TXT0 the current DQDT state.
+ * This debug syscall displays on the kernel terminal TXT0 the current DQDT state.
  * It can be called by any thread running in any cluster.
  ***************************************************************************************
@@ -190 +202 @@
 
 /***************************************************************************************** 
-* This debug function is used to activate / desactivate the context switches trace
+* This debug syscall is used to activate / desactivate the context switches trace
 * for a core identified by the <cxy> and <lid> arguments.
 * It can be called by any thread running in any cluster.
@@ -204 +216 @@
 
 /****************************************************************************************
- * This blocking function implements an user-level interactive debugger that can be
+ * This syscall implements an user-level interactive debugger that can be
  * introduced in any user application to display various kernel distributed structures.
  * The supported commands are: