Protocols¶

This page describes the protocols used by Aybabtu for network communication between cores and between core and GUI.

Core <-> Core¶

See source:protos/network_protocol.proto for message details.

Downloading threads¶

There is NbDownloadThread threads. Each thread will choose a free chunk and download it.
There is no more than one downloading from B to A. A peer which a download is active is setted as not free.

F : the list of all unfinished download
C : A list of chunk candidates (empty at start)

- Take the first file in F -> f.
Loop :
   If the hash chunks of f are unknown :
      If there is already a peer asking for hashes :
         - Take the next file in F -> f.
         - continue
      Else
         - Ask the hashes to the source (see the message 'GetHashes').
   For each chunk not downloaded and not being downloaded -> c :
      If c has a free peer :
         - Add c to C
   If C isn't empty :
      - Take the best chunk in C based on peer.downloadRate.
        If there is more than one best chunk then choose one randomly.
      - Grab the lock for the peer
      - Request the download   
      - Take the first file in F -> f.
   Else :
      - Take the next file in F -> f.

Updating peer to hash association thread¶

This thread will periodically grab the NumberOfChunkToUpdate first chunks and request to all other peers what chunk they have.

If there is no chunk available the message will be send without hashes.

F : the list of all unfinished download
C : list of latest chunk hashes sent

Loop :
   Time.now -> t
   Empty C
   n : number of chunk = 0
   While take the next file in F -> f
      If C.count >= 'NumberOfChunkToUpdate' :
         - Break
      If we know the hashes for f :
         For all chunks of f -> c :
            - Add c to C
      Else :
         - Break
   - Copy C to C_latest
   - Send the list of the chunk to everyone. (The received responses will be compared against C)
   - Wait 'TimeBetweenChunksUpdate' - (Time.now - t)

Parameters¶

Most parameters will be stored as constants in their component.

Core <-> GUI¶