Changeset dce3903 for protocols/ft.h

Timestamp:

2007-12-04T00:48:57Z (16 years ago)

Author:

ulim <a.sporto+bee@…>

Branches:

master

Children:

8076ec0, fa30fa5

Parents:

2ff2076

Message:

Send and receive seems to work now! Also adopted the new buffering strategy,
only one buffer of 2k per transfer now.

File:

• protocols/ft.h (modified) (3 diffs)

protocols/ft.h

@@ -26 +26 @@
 #ifndef _FT_H
 #define _FT_H
+
+/*
+ * One buffer is needed for each transfer. The receiver stores a message
+ * in it and gives it to the sender. The sender will stall the receiver
+ * till the buffer has been sent out.
+ */
+#define FT_BUFFER_SIZE 2048
 
 typedef enum {
@@ -131 +138 @@
         
         /*
-         * If set, called when the transfer queue is running empty and
-         * more data can be added.
+         * called by the sending side to indicate that it is writable.
+         * The callee should check if data is available and call the 
+         * function(as seen below) if that is the case.
          */
-        void (*out_of_data) ( struct file_transfer *file );
+        gboolean (*write_request) ( struct file_transfer *file );
 
         /*
          * When sending files, protocols register this function to receive data.
+         * This should only be called once after write_request is called. The caller
+         * should not read more data until write_request is called again. This technique
+         * avoids buffering.
          */
-        gboolean (*write) (struct file_transfer *file, char *buffer, int len );
+        gboolean (*write) (struct file_transfer *file, char *buffer, unsigned int len );
+
+        /* The send buffer associated with this transfer.
+         * Since receivers always wait for a write_request call one is enough.
+         */
+        char buffer[FT_BUFFER_SIZE];
 
 } file_transfer_t;
@@ -154 +170 @@
 void imcb_file_canceled( file_transfer_t *file, char *reason );
 
-/*
- * The given buffer is queued for transfer and MUST NOT be freed by the caller.
- * When the method returns false the caller should not invoke this method again
- * until out_of_data has been called.
- */
-gboolean imcb_file_write( file_transfer_t *file, gpointer data, size_t data_size );
-
 gboolean imcb_file_recv_start( file_transfer_t *ft );
 #endif