Changes between Version 122 and Version 123 of library_stdio

Timestamp:

Oct 2, 2015, 2:17:13 AM (9 years ago)

Author:

alain

Comment:

--

library_stdio

@@ -76 +76 @@
 
  === 6) void '''giet_pthread_assert'''( unsigned int condition, char* string ) ===
-This function is an extension to the POSIX standard. It send a KILL signal and deactivates immediately the calling thread (as does the giet_pthread_exit() function), with a TTY0 message defined by the <string> argument if the <condition> argument has a zero value.
+This function is an extension to the POSIX standard. It send a KILL signal and deactivates immediately the calling thread (as does the giet_pthread_exit() function), with a  message on
+the kernel TTY0,  if the <condition> argument has a zero value. The message is defined by the <string> argument.
  * '''condition''' : thread exit if condition value is 0.
  * '''string''' : message displayed on TTY0.
 
- === 7) int '''giet_pthread_pause'''( char* vspace , char* thread ) ===
-This function is an extension to the POSIX standard. It deactivates the thread identified by the <vspace> and <thread> arguments. The target thread goes to the ''blocked'' state at the next context switch, and will not be scheduled until the thread is reactivated by the giet_pthread_resume() function. The thread context (including the resources dynamically allocated to the thread) is not modified.
+ === 7) void '''giet_pthread_control'''( unsigned int command , char* vspace , char* thread ) ===
+This function is an extension to the POSIX standard. It execute the command defined by the<command> argument for  the thread identified by the <vspace> and <thread> arguments.
+ * '''command''' : command type.
  * '''vspace''' : vspace name.
  * '''thread''' : thread name in mapping.
-Return 0 if success.
-Return -1 if vspace name not found.
-Return -2 if thread name not found.
-
- === 8) int '''giet_pthread_resume'''( char* vspace , char* thread ) === 
-This function is an extension to the POSIX standard. It  reactivates a thread identified by the <vspace> and <thread> arguments, that was descheduled by the giet_pthread_pause() function. The target thread goes to the ''runable'' state, and can be rescheduled at the next context switch to resume execution.
- * '''vspace''' : vspace name.
- * '''thread''' : thread name in mapping.
-Return 0 if success.
-Return -1 if vspace name not found.
-Return -2 if thread name not found.
+The supported command types are:
+ * '''THREAD_CMD_PAUSE''' : The target thread is deactivated. It goes immediately to the ''blocked'' state, and will not be scheduled until the thread is reactivated. The thread context (including the resources dynamically allocated to the thread) is not modified.
+ * '''THREAD_CMD_RESUME''' : The target thread is reactivated. It goes immediately to the ''runable'' state, and can be rescheduled at the next context switch to resume execution.
+ * '''THREAD_CMD_CONTEXT''' : Display the context of the target thread on the TTY allocated to the calling thread.