Changeset fa30fa5 for protocols/ft.h

Timestamp:

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

Author:

ulim <a.sporto+bee@…>

Branches:

master

Children:

08135df

Parents:

2c2df7d (diff), dce3903 (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.

Message:

Jabber file transfer now also with sending! You can't use a proxy yet when
sending, that's my next task. You can use proxies when receiving though!

I also changed the buffering strategy. Previously receiving continued till some
buffer limit was reached, now only one message is received and receiving stops
till it is delivered. This keeps the buffering space per file transfer to a
minimum(currently 4k). Makes sense when used on a public server. For public
servers a throughput maximum would also be interesting...

File:

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

protocols/ft.h

@@ -27 +27 @@
 #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 {
         FT_STATUS_LISTENING     = 1,
-        FT_STATUS_TRANSFERING   = 2,
+        FT_STATUS_TRANSFERRING  = 2,
         FT_STATUS_FINISHED      = 4,
-        FT_STATUS_CANCELED      = 8
+        FT_STATUS_CANCELED      = 8,
+        FT_STATUS_CONNECTING    = 16
 } file_status_t;
 
@@ -61 +69 @@
  */
 typedef struct file_transfer {
+
+        /* Are we sending something? */
+        int sending;
+
         /*
          * The current status of this file transfer.
@@ -126 +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, 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;
@@ -144 +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