Request structure:
/* All numbers are big endian */
struct RawRequest {
magic: u64,
request_type: u8,
size: u32,
body: Vec<u8>,
}The magic value is a 64 bits big endian unsigned integer used to determine wether the request is a valid SEP request or not. Its value is defined by this code:
3.1415926535897932f64
.to_be_bytes()
.iter()
.enumerate()
.fold(0, |acc, (idx, b)| acc | (*b as u64) << ((7 - idx) * 8))If the received magic value is not the expected one, a « bad request » is returned.
The request type is a 8 bits big endian unsigned integer and must be one of these:
read(0): Read a page.
If the request type is not valid, a « bad request » is returned.
The size is a 32 bits big endian unsigned integer representing the body size.
The request body is an array of bytes that are read one at a time on the stream.
If the body is not as long as specified by the size, a « bad request » is returned.
Response structure:
/* All numbers are big endian */
struct Response {
status: u8,
size: u32,
body: Vec<u8>,
}The reponse status is one of the following:
- 0: Success: The request has been successfully handled.
- 1: Bad request: The submitted request is incorrectly made.
- 2: Not found: The requested path is not found.
- 3: Server error: The server failed to handle the request, but it’s not a user mistake.
The size is a 32 bits big endian unsigned integer representing the body size.
The response body, size bytes long.
This data format is a mix of several data formats, such as Org.
- Top level header:
* <header> - Second level header:
** <header> - Third level header:
*** <header> - Link:
$<link>$ - Link with caption:
$<link> <caption>$ - Item:
+ <item> - Verbatim:
=<content>=