Changes between Version 12 and Version 13 of kernel_syscalls

Timestamp:

Nov 9, 2014, 10:16:48 PM (10 years ago)

Author:

alain

Comment:

--

kernel_syscalls

@@ -52 +52 @@
 
 === int '''_sys_nic_rx_alloc'''() ===
-This function allocates a private NIC_RX channel, and the associated RX chbuf to the calling task, and register the channel index in the task context.
-Return -1 if no NIC_RX channel available.
+This function allocates a private NIC_RX channel, the associated NIC_RX chbuf, and a private CMA channel to the calling task, and register these channel indexes in the task context.
+Return -1 if no NIC_RX channel available, or if no CMA channel available.
 
 === int '''_sys_nic_tx_alloc'''() ===
-This function allocates a private NIC_TX channel, and the associated TX chbuf to the calling task, and register the channel index in the task context.
-Return -1 if no NIC_TX channel available.
+This function allocates a private NIC_TX channel, the associated NIC_TX chbuf, and a private CMA channel to the calling task, and register these channel indexes in the task context.
+Return -1 if no NIC_TX channel available, or if no CMA channel available.
 
-=== int '''_sys_nic_send_container'''( void* vbuf ) ===
-This function transfer a 4kbytes container from an user buffer, to the private kernel TX chbuf allocated to the calling task. It is blocking if the kernel TX chbuf is full, with a time-out limit.
-Returns 0 if success, returns -1 if the user buffer address is illegal, returns -2 if there is no  NIC channel allocated to the calling task, returns -3 if the timeout is elapsed.
+=== int '''_sys_nic_rx_start'''() ===
+This function starts the NIC_RX and the CMA channels allocated to the calling task.
+Returns -1 if no NIC_RX channel or no CMA channel allocated to the calling task.
 
-=== int '''_sys_nic_receive_container'''( void* vbuf ) ===
-This function transfer a 4kbytes container from the private  RX chbuf allocated to the calling task, to an user buffer. It is blocking if the chbuf is empty, with a time_out limit.
-Returns 0 if success, returns -1 if the user buffer address is illegal, returns -2 if there is no  NIC channel allocated to the calling task, returns -3 if the timeout is elapsed.
+=== int '''_sys_nic_tx_start'''() ===
+This function starts the NIC_RX and the CMA channels allocated to the calling task.
+Returns -1 if no NIC_RX channel or no CMA channel allocated to the calling task.
+
+=== int '''_sys_nic_rx_move'''( void* vbuf ) ===
+This function moves one 4kbytes container from the private kernel NIC_RX chbuf allocated to the calling task, to an user buffer.
+ * '''vbuf''' is the user buffer virtual base address.
+It is blocking if the kernel NIC_RX chbuf is empty, with a time-out limit.
+Returns 0 if success, returns -1 if the user buffer address is illegal, or if there is no  NIC_RX channel allocated to the calling task, or if the timeout is elapsed.
+
+=== int '''_sys_nic_tx_move'''( void* vbuf ) ===
+This function moves one 4kbytes container from an user buffer, to the private kernel NIC_TX chbuf allocated to the calling task. 
+ * '''vbuf''' is the user buffer virtual base address.
+It is blocking if the kernel NIC_TX chbuf is full, with a time-out limit.
+Returns 0 if success, returns -1 if the user buffer address is illegal, or if there is no  NIC_TX channel allocated to the calling task, or if the timeout is elapsed.