From ac7633d8149a28af288ac0b850850cef9b13c151 Mon Sep 17 00:00:00 2001
From: sjtufs <sjtu_fs@outlook.com>
Date: Sun, 25 Aug 2013 15:45:55 +0800
Subject: This is alpha

---
 misc/server/ptp.rst | 96 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 96 insertions(+)
 create mode 100644 misc/server/ptp.rst

(limited to 'misc/server/ptp.rst')

diff --git a/misc/server/ptp.rst b/misc/server/ptp.rst
new file mode 100644
index 0000000..8aef2b7
--- /dev/null
+++ b/misc/server/ptp.rst
@@ -0,0 +1,96 @@
+Piztor Transmission Protocol v0.2
+---------------------------------
+
+- General 
+
+  - Request
+
+    ::
+    
+        +---4b---+---1b---+-------?b--------+
+        | LENGTH | OPT ID |  SPECIFIC DATA  |
+        +--int---+-uchar--+-----------------+
+
+  - Response
+
+    ::
+    
+        +---4b---+---1b---+------?b---------+
+        | LENGTH | OPT ID |  SPECIFIC DATA  |
+        +--int---+-uchar--+-----------------+
+
+    Notice that in following sections, ``LENGTH`` part is left out for clarity.
+    TODO: All secure requests should have username or uid provided.
+
+- Authentication 
+
+  - Request
+
+    :: 
+
+        +--1b---+-----?b------+-----?b-----+
+        | 0x00  |   USERNAME  |  PASSWORD  |
+        +-uchar-+-------------+------------+
+
+  - Response
+
+    ::
+    
+       +--1b---+---1b---+---4b----+----16b-----+
+       | 0x00  | STATUS | USER_ID | USER_TOKEN |
+       +-uchar-+--uchar-+---int---+----raw-----+
+
+    ``STATUS`` :
+    
+    - 0x00 for success
+    - 0x01 for failure
+
+- Location Update
+
+  - Request
+
+    ::
+    
+        +--1b---+-----16b------+-----8b-----+------8b-----+
+        | 0x02  |  USER_TOKEN  |  LATITUDE  |  LONGITUDE  |
+        +-uchar-+------raw-----+---double---+---double----+
+
+  - Response
+
+    ::
+
+        +--1b---+---1b---+
+        | 0x02  | STATUS |
+        +-uchar-+--uchar-+
+
+    ``STATUS`` :
+
+    - 0x00 for success
+    - 0x01 for invalid token
+
+- Location Information
+
+  - Request
+
+    ::
+    
+        +--1b---+-----16b------+------4b-----+
+        | 0x03  |  USER_TOKEN  |  GROUP_ID   |
+        +-uchar-+-----raw------+-----int-----+
+
+  - Response
+
+    ::
+
+        +--1b---+---1b---+-----4b----+------20b-------+-----+
+        | 0x03  | STATUS | ENTRY_CNT | LOCATION_ENTRY | ... |
+        +-uchar-+-uchar--+----int----+----------------+-----+
+        
+    ``LOCATION_ENTRY`` :
+
+    :: 
+
+        +---4b----+----8b----+-----8b----+
+        | USER_ID | LATITUDE | LONGITUDE |
+        +---int---+--double--+--double---+
+
-- 
cgit v1.2.3-70-g09d2