Changes between Version 105 and Version 106 of library_stdio

Timestamp:

Sep 15, 2015, 11:14:29 AM (10 years ago)

Author:

alain

Comment:

--

library_stdio

@@ -6 +6 @@
 
 All these functions use a ''syscall'' instruction to enter the system. 
-In  case of system call failure (illegal arguments), the calling thread
+For most system calls, in case of failure (illegal arguments), the calling thread
 is killed with a ''giet_pthread_exit()''. 
-
-Therefore, for most of these system calls, there is no return value.
 
  == __Processor related system calls__ ==
@@ -52 +50 @@
 This function desactivates the calling thread. 
 The 'string' argument is a (user defined) log message displayed on the kernel TTY.
-
- === 3) unsigned int '''giet_pthread_join'''( pthread_t  trdid , void** ptr ) ===
+No error possible.
+
+ === 3) int '''giet_pthread_join'''( pthread_t  trdid , void** ptr ) ===
 This blocking function can be used to detect completion of a thread activated by a giet_pthread_create().
 It returns only when the thread identified by the ''traded'' argument is desactivated. 
@@ -63 +62 @@
 Return -2  if ptr not NULL
 
-No error possible.
-
- === 3) unsigned int '''giet_thread_id'''() === 
-This functions returns (from the calling task context) the thread index, identiying the task in a given vspace.
-No error possible.
-
- === 4) void '''giet_exit'''( char* string ) ===
-This function stops execution of the calling task with a TTY0 message explaining the cause. 
-The user task is descheduled and becomes not runable: it does not consume processor cycles anymore.
+ === 4) int '''giet_thread_kill'''( pthread_id trdid , int signal ) === 
+This function deactivates the thread identified by the ''trdid'' argument when the ''signal'' argument is non zero.
+If the ''signal'' argument is zero, the thread existence is checked, but it is not deactivated.
+ * trdid : unique thread identifier in vspace.
+ * signal : deactivation if non zero.
+Return 0 if success.
+Return -1 if no matching thread.
 
  === 5) void '''giet_assert'''( unsigned int condition, char* string ) ===
 This function stops execution of the calling with a TTY0 message if the condition is false.
+No error possible.
 
  === 6) void '''giet_context_switch'''() ===
-The user task calling this function is descheduled and the processor is allocated to another task. === 
-
+The thread calling this function is descheduled and the processor is allocated to another thread.
+No error possible.
 
  == __Application related system calls__ ==