Changes between Version 92 and Version 93 of library_stdio

Timestamp:

Jul 17, 2015, 6:31:11 PM (9 years ago)

Author:

alain

Comment:

--

library_stdio

@@ -366 +366 @@
 This function stops execution of the calling task with a TTY message explaining the cause. The user task is descheduled and becomes not runable: it does not consume processor cycles anymore.
 
- === 2) void '''giet_assert'''( unsigned int condition, char* string ) ===
+ === 2) void '''giet_kill_application'''( char* name ) ===
+This function kill the application identified by the vspace '''name''' argument: All tasks are de-activated.
+
+ === 3) void '''giet_exec_application'''( char* name ) ===
+This function starts execution of the the application identified by the vspace '''name''' argument: 
+The application code and data segment are loaded into memory from the .elf file on device. 
+For all tasks, the stack an heap are re-initialised.
+
+ === 4) void '''giet_assert'''( unsigned int condition, char* string ) ===
 This function uses the giet_exit() system call to kill the calling task if the condition is false.
 
- === 3) void '''giet_context_switch'''() ===
+ === 5) void '''giet_context_switch'''() ===
 The user task calling this function is descheduled and the processor is allocated to another task.
 
- === 4) void '''giet_procs_number'''( unsigned int* x_size , unsigned int* y_size , unsigned int* nprocs ) ===
+ === 6) 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.
@@ -378 +386 @@
  * '''nprocs''' number of processors per cluster.
 
- === 5) void '''giet_vseg_get_vbase'''( char* vspace_name, char*  vseg_name, unsigned int* vbase) ===
+ === 7) 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().
 
- === 6) void '''giet_vseg_get_length'''( char* vspace_name, char*  vseg_name, unsigned int* length) ===
+ === 8) 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().
 
- === 7) void '''giet_heap_info'''( unsigned int* vaddr, unsigned int* length, unsigned int  x, unsigned int  y );
+ === 9) 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).
 
- === 8) void '''giet_get_xy'''( void* ptr, unsigned int* px, unsigned int* py ) ===
+ === 10) 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().