Changes between Version 11 and Version 12 of kernel_syscalls

Timestamp:

Nov 9, 2014, 1:34:34 PM (10 years ago)

Author:

alain

Comment:

--

kernel_syscalls

@@ -51 +51 @@
 == __NIC related syscall handlers__ ==
 
-=== int '''_sys_nic_alloc'''() ===
-This function allocates a private NIC channel to the calling task, and register the channel index in the task context.
-Return -1 if no NIC channel available.
+=== 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.
 
-=== int '''_sys_nic_sync_send'''( void* vbuf ) ===
-This function uses a physical_memcpy() to transfer a 4kbytes container from an user buffer to a private NIC TX channel. It computes the physical base address associated to the user buffer. Returns 0 if success, returns -1 if the buffer address is illegal, or if there is no  NIC channel allocated to the calling task.
+=== 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.
 
-=== int '''_sys_nic_sync_receive'''( void* vbuf ) ===
-This function uses a physical_memcpy() to transfer a 4kbytes container from a private NIC RX channel to an user buffer. It computes the physical base address associated to the user buffer. Returns 0 if success, returns -1 if the buffer address is illegal, or if there is no  NIC channel allocated to the calling task.
+=== 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_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.