Changeset 032bbe7 in mainline for uspace/srv/net/tl/tcp/rqueue.c

Timestamp:

2011-09-22T19:53:07Z (13 years ago)

Author:

Jiri Svoboda <jiri@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

32105348

Parents:

0093ab6

Message:

Document functions and files.

File:

• uspace/srv/net/tl/tcp/rqueue.c (modified) (7 diffs)

uspace/srv/net/tl/tcp/rqueue.c

@@ -32 +32 @@
 
 /**
- * @file
+ * @file Global segment receive queue
  */
 
@@ -40 +40 @@
 #include <stdlib.h>
 #include <thread.h>
+#include "conn.h"
 #include "rqueue.h"
 #include "state.h"
@@ -46 +47 @@
 static prodcons_t rqueue;
 
+/** Initialize segment receive queue. */
 void tcp_rqueue_init(void)
 {
@@ -54 +56 @@
  *
  * This is for testing purposes only.
+ *
+ * @param sp    Socket pair, oriented for transmission
+ * @param seg   Segment
  */
 void tcp_rqueue_bounce_seg(tcp_sockpair_t *sp, tcp_segment_t *seg)
@@ -62 +67 @@
 
         /* Reverse the identification */
-        rident.local = sp->foreign;
-        rident.foreign = sp->local;
+        tcp_sockpair_flipped(sp, &rident);
 
         tcp_rqueue_insert_seg(&rident, seg);
 }
 
+/** Insert segment into receive queue.
+ *
+ * @param sp    Socket pair, oriented for reception
+ * @param seg   Segment
+ */
 void tcp_rqueue_insert_seg(tcp_sockpair_t *sp, tcp_segment_t *seg)
 {
@@ -85 +94 @@
 }
 
+/** Receive queue handler thread. */
 static void tcp_rqueue_thread(void *arg)
 {
@@ -100 +110 @@
 }
 
+/** Start receive queue handler thread. */
 void tcp_rqueue_thread_start(void)
 {