Changes between Version 94 and Version 95 of library_stdio

Timestamp:

Jul 17, 2015, 7:45:04 PM (9 years ago)

Author:

alain

Comment:

--

library_stdio

@@ -28 +28 @@
 No error possible, as the return value is always between 0 & 65535.
 
+
  == __User task related system calls__ ==
 
  === 1) unsigned int '''giet_proc_task_id'''() ===
-This functions returns (from the calling task context) the local task index, identifying the task amongst all task
+This functions returns (from the calling task context) the task index in scheduler, identifying the task amongst all task
 running on the same processor. 
 No error possible.
@@ -42 +43 @@
 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.
+
+ === 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.
+
+ === 6) void '''giet_context_switch'''() ===
+The user task calling this function is descheduled and the processor is allocated to another task. === 
+
+
+ == __Application related system calls__ ==
+
+ === 1) void '''giet_kill_application'''( char* name ) ===
+This function kill the application identified by the vspace '''name''' argument: 
+All tasks are de-activated, the private peripherals or coprocessors are released, but the physical memory
+allocated to the killed application is not released.
+
+ === 2) void '''giet_exec_application'''( char* name ) ===
+This function starts execution for the the application identified by the vspace '''name''' argument: 
+The application code and data segment are loaded into memory from the .elf file. 
+All tasks contexts are initialized, and the tasks are activated.
+
 
  ==  __Coprocessors related system calls__ ==
@@ -363 +388 @@
 ==  __Miscelaneous system calls__ ==
 
- === 1) 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.
-
- === 2) void '''giet_kill_application'''( char* name ) ===
-This function kill the application identified by the vspace '''name''' argument: 
-All tasks are de-activated, the private peripherals or coprocessors are released, but the physical memory
-allocated to the killed application is not released.
-
- === 3) void '''giet_exec_application'''( char* name ) ===
-This function starts execution for the the application identified by the vspace '''name''' argument: 
-The application code and data segment are loaded into memory from the .elf file. 
-All tasks contexts are initialized, and the tasks are activated.
-
- === 4) void '''giet_assert'''( unsigned int condition, char* string ) ===
-This function stops exzcution of the calling with a TTY0 message if the condition is false.
-
- === 5) void '''giet_context_switch'''() ===
-The user task calling this function is descheduled and the processor is allocated to another task.
-
- === 6) void '''giet_procs_number'''( unsigned int* x_size , unsigned int* y_size , unsigned int* nprocs ) ===
+ === 1) void '''giet_procs_number'''( unsigned int* x_size , unsigned int* y_size , unsigned int* nprocs ) ===
 This function returns the actual number of processors in a clusterized 2D mesh architecture.
  * '''x_size''' number of clusters containing processors in a row.
@@ -389 +394 @@
  * '''nprocs''' number of processors per cluster.
 
- === 7) void '''giet_vseg_get_vbase'''( char* vspace_name, char*  vseg_name, unsigned int* vbase) ===
+ === 2) void '''giet_vseg_get_vbase'''( char* vspace_name, char*  vseg_name, unsigned int* vbase) ===
 This function returns in argument ''vbase'' the virtual base address of a vseg defined in the mapping_info data structure. The vseg is identified by the two arguments ''vspace_name'' and ''vseg_name''. In case of error (such as undefined vspace or undefined vseg), it makes a giet_exit().
 
- === 8) void '''giet_vseg_get_length'''( char* vspace_name, char*  vseg_name, unsigned int* length) ===
+ === 3) void '''giet_vseg_get_length'''( char* vspace_name, char*  vseg_name, unsigned int* length) ===
 This function returns in argument ''length'' the length (bytes) of a vseg defined in the mapping_info data structure. The vseg is identified by the two arguments ''vspace_name'' and ''vseg_name''. In case of error (such as undefined vspace or undefined vseg), it makes a giet_exit().
 
- === 9) void '''giet_heap_info'''( unsigned int* vaddr, unsigned int* length, unsigned int  x, unsigned int  y );
+ === 4) void '''giet_heap_info'''( unsigned int* vaddr, unsigned int* length, unsigned int  x, unsigned int  y );
 This function supports access to the running task's heap or to a remote heap. If (x < X_SIZE) and (y < Y_SIZE), it returns the base address and length of the heap associated to any task running on cluster(x,y). Otherwise, it returns the base address and length of the heap associated to the calling task. In case of error (such as undefined heap segment in the selected cluster, it returns heap_size = 0).
 
- === 10) void '''giet_get_xy'''( void* ptr, unsigned int* px, unsigned int* py ) ===
+ === 5) void '''giet_get_xy'''( void* ptr, unsigned int* px, unsigned int* py ) ===
 This function takes as input a virtual address (''ptr'' argument), and returns through the ''px,py'' arguments the coordinates of the cluster containing the physical address associated to ''ptr''. In case of error (unmapped virtual address), it makes a giet_exit().