Changes between Version 26 and Version 27 of kernel_syscalls

Timestamp:

Jan 4, 2015, 11:07:05 PM (10 years ago)

Author:

alain

Comment:

--

kernel_syscalls

@@ -58 +58 @@
 Returns the NIC channel index if success. Return -1 if no NIC channel available, or if no CMA channel available.
 
-=== 2) int '''_sys_nic_start'''( unsigned int is_rx ) ===
+=== 2) int '''_sys_nic_start'''( unsigned int is_rx,  unsigned int channel ) ===
 This function initializes the kernel chbuf allocated to the calling task. It allocates the distributed 4 Kbytes containers (one container per cluster) from the distributed kernel heap, and initializes the kernel chbuf  describing the containers status. This chbuf descriptor is allocated in the seg_kernel_data segment in cluster [0,0].
 It starts the NIC channel allocated to the calling task, and starts the CMA transfer between the NIC chbuf and the distributed kernel chbuf. The CMA component is configured in OUT_OF_ORDER transfer mode (non blocking when a SRC or DST container is not available).
  * '''is_rx''' : boolean (RX transfer if non zero)
+ * '''channel''' : RX or TX channel index
 Returns 0 if success. Returns -1 if no NIC channel or no CMA channel allocated to the calling task.
 
-=== 3) int '''_sys_nic_move'''(  unsigned int nic_channel,  unsigned int is_rx,  void* buffer ) ===
-This function moves one 4 Kbytes container from the kernel chbuf defined by the ''nic_channel'' argument, to an user buffer defined by the ''buffer'' argument. This blocking function enforces locality and parallelism: it scans the two containers  located in the same cluster as the calling task, and returns only when a full container has been found. 
- * '''nic_channel''' : selected nic channel.
+=== 3) int '''_sys_nic_move'''(  unsigned int is_rx,  unsigned int channel,  void* buffer ) ===
+This function moves one 4 Kbytes container from the kernel chbuf defined by the ''nic_channel'' argument, to an user buffer defined by the ''buffer'' argument. This blocking function enforces locality and parallelism: it scans the two containers  located in the same cluster as the calling task, and returns only when a full container has been found.  
  * '''is_rx''' : boolean (RX transfer if non zero)
+ * '''channel''' : RX or TX channel index.
  * '''buffer''' is the user buffer virtual base address.
 Returns 0 if success, returns -1 if the user buffer address is illegal, or if the NIC channel is too large, or if the timeout is elapsed.
 
-=== 4) int '''_sys_nic_stop'''( unsigned int is_rx ) ===
+=== 4) int '''_sys_nic_stop'''( unsigned int is_rx,  unsigned int channel ) ===
 This function stops the NIC and the CMA channels allocated to the calling task.
  * '''is_rx''' : boolean (RX transfer if non zero)
+ * '''channel''' : RX or TX channel index
 Returns 0 if success. Returns -1 if no NIC channel or no CMA channel allocated to the calling task.
 
-=== 5) int '''_sys_nic_clear'''( unsigned int is_rx ) ===
+=== 5) int '''_sys_nic_clear'''( unsigned int is_rx,  unsigned int channel ) ===
 This function reset the NIC instrumentation registers (packet counters).
-* '''is_isr''' : boolean (RX channels if non zero)
+* '''is_rx''' : boolean (RX channels if non zero)
+ * '''channel''' : RX or TX channel index
 
-=== 6) int '''_sys_nic_stats'''( unsigned int is_rx ) ===
+=== 6) int '''_sys_nic_stats'''( unsigned int is_rx,  unsigned int channel ) ===
 This function displays on TTY0 the values stored in the NIC instrumentation registers (packet counters).
-* '''is_isr''' : boolean (RX channels if non zero)
+* '''is_rx''' : boolean (RX channels if non zero)
+ * '''channel''' : RX or TX channel index
 
 == FBF related syscall handlers ==