3.3. Network Protocol

all numbers are sent as 64-bit little-endian numbers

3.3.1. Client to Server

Prefix	Data	Description
joedb	client_version	first message, sent at connection time
r	offset size	read a range of bytes
b	blob	read a blob
P	checkpoint wait_milliseconds	pull
i	checkpoint wait_milliseconds	get server checkpoint (like P, without data)
H	checkpoint hash (32 bytes)	check SHA-256 hash code
Q		quit
L	checkpoint wait_milliseconds	lock-pull
l	checkpoint wait_milliseconds	lock (like L, without data)
p	checkpoint size data	locked-push
U	checkpoint size data	push-unlock
u		unlock

3.3.2. Server to Client

Prefix	Data	Description
joedb	server_version session_id checkpoint ‘R’ or ‘W’	reply to joedb. server_version = 0 means client_version is rejected. ‘R’ is pull-only
r	size data	reply to r (size may be shorter than what was sent)
b	size data	reply to b
P	checkpoint size data	reply to P
i	checkpoint	reply to i
H		reply to H, hash is matching
h		reply to H, hash mismatch
R		reply to L, l, p, U, or u when the server is read-only
L	checkpoint size data	reply to L
l	checkpoint	reply to l
U		reply to U or p when the push succeeded
C		reply to U or p when the push failed (conflict)
u		reply to u (no timeout)
t		reply to u, U, or p in case of lock timeout