Updates to docs
authorAli Younis <ayounis@uci.edu>
Thu, 17 Nov 2016 19:22:27 +0000 (11:22 -0800)
committerAli Younis <ayounis@uci.edu>
Thu, 17 Nov 2016 19:22:27 +0000 (11:22 -0800)
doc2/iotcloud.tex

index 3eb10e1..9bbfc7c 100644 (file)
@@ -84,7 +84,7 @@ A data entry can be one of these:
         \newline {The purpose of this is for the client to tell if the server lies about the number of slots in the queue, e.g. if there are 2 queue state entry in the queue, e.g. 50 and 70, the client knows that when it sees 50, it should expect at most 50 slots in the queue and after it sees 70, it should expect 50 slots before that queue state entry slot 50 and at most 70 slots. The queue state entry slot 70 is counted as slot number 51 in the queue.}\r
 \r
     \item Collision resolution entry: message identifier + machine id of a collision winner\r
-        \newline {The purpose of this is to keep keep track of the winner of all the collisions until allclients have seen the particular entry.}\r
+        \newline {The purpose of this is to keep keep track of the winner of all the collisions until all clients have seen the particular entry.}\r
 \end{enumerate}\r
 \r
 \subsection{Live status}\r
@@ -95,14 +95,14 @@ Live status of entries:
     \r
     \item Abort is live until the machine ID that created the transaction that is being aborted inserts into the block chain a message with a sequence number greater than the abort (that client sees the abort).\r
         \r
-    \item Commit is dead if for all key value updates in the commit there is a commit with the same key value update that is newer (larger sequence number).\r
+    \item Commit is dead if for all key value updates in the commit there is a commit with the same key value update that is newer (larger sequence number).  The committing client (arbitrator) will see those newer commits since it is the one that generates them.\r
     \r
-    \item New Key messages are always kept alive.\r
+    \item New Key messages are always kept alive.  Keys can not be deleted.  Deleted keys will cause arbitration to fail if a key is deleted then reassigned to a new client device for arbitration.\r
     \r
     \item Slot sequence number (of either a message version data or user-level data) is dead if there is a newer slot from the same machine.\r
 \r
     \item Queue state entry is dead if there is a newer queue state entry.\r
-    {In the case of queue state entries 50 and 70, this means that queue state entry 50 is dead and 70 is live. However, not until the number of slots reaches 70 that queue state entry 50 will be expunged from the queue.}\r
+    {In the case of queue state entries 50 and 70, this means that queue state entry 50 is dead and 70 is live. However, not until the number of slots reaches 70 that queue state entry 50 will be expunged from the queue.  Further all entries before the 50 entry will also not be expunged until the queue size has reached 70}\r
 \r
     \item Collision resolution entry is dead if this entry has been seen by all clients after a collision happens.\r
 \end{enumerate}\r
@@ -244,13 +244,13 @@ $max\_size$ = max size of the block chain\\
 \r
 \subsubsection{Sets and Lists}\r
 \r
-$PendingTransSet$ = Set of pending transactions that need to be pushed to the block chain, $\tuple{number,PendingTrans}$\\\r
+$PendingTransQueue$ = Queue of pending transactions that need to be pushed to the block chain, $\tuple{PendingTrans}$\\\r
 $PendingTrans= \tuple{KV, Guard} = \tuple{$set of key value pairs, set of guard conditions$}$.\\\r
 $Arbitrator$ = set of $\tuple{k,id}$ containing the key and its arbitrating device.\\\r
 $LastSlot$ = set of $\tuple{id, seq}$ containing the machine ID and the largest sequence number from that machine ID.\\\r
 $LocalSlots$ = set of slots that are in the clients local buffer (initially $\emptyset$), data is decrypted.\\\r
 $RejectedSlotList$ = ordered list of the sequence numbers of slots that this client tried to insert but were rejected.\\\r
-$CommittedKV$ = set of committed key value pairs (initially $\emptyset$).\r
+$CommittedKV$ = set of committed key value pairs (initially $\emptyset$).\\\r
 $SpeculatedKV$ = set of speculated key value pairs (initially $\emptyset$).\r
 \r
 \subsection{Helper Functions}\r
@@ -1727,18 +1727,8 @@ Get the value for the key while speculating.\\
 \begin{algorithmic}[1]\r
 \Function{GetValueSpeculate}{$k_a$}\r
     %\State $\tuple{k,v} \gets \tuple{k,v}$ \textit{such that} $\tuple{k,v} \in SpeculatedKV \land k = k_a$\r
-    \State $SpecKVTmp \gets SpeculatedKV$\r
-    \State $DKV \gets \emptyset$\\\r
     \r
-    \LeftComment{Go Through local pending transactions and speculate}\r
-    \ForAll{$\tuple{num, \tuple{KV, Guard}} \in PendingTransSet$ sorted by num}\r
-        \If{\Call{EvaluateGuard}{$Guard, SpecKVTmp$}}\r
-            \State $DKV \gets \{\tuple{k,v}| \tuple{k,v} \in SpecKVTmp \land \tuple{k',v'}\in KV \land k'=k\}$\r
-            \State $SpecKVTmp \gets (SpecKVTmp \setminus DKV) \cup KV$\r
-        \EndIf\r
-    \EndFor\r
-    \r
-    \State $\tuple{k,v} \gets \tuple{k,v}$ \textit{such that} $\tuple{k,v} \in SpecKVTmp \land k = k_a$\r
+    \State $\tuple{k,v} \gets \tuple{k,v}$ \textit{such that} $\tuple{k,v} \in SpeculatedKV \land k = k_a$\r
 \State \Return{$v$}\r
 \EndFunction\r
 \end{algorithmic}\r
@@ -1816,21 +1806,27 @@ Starts a transaction.  Clears out the key value pair update buffer.\\
 Commits the transaction into the block chain.  Keeps attempting to insert the transaction into the block chain until it succeeds.\\\r
 \begin{algorithmic}[1]\r
 \Function{Transaction Commit}{$ $}\r
-    \State $num_{largest} \gets 1$\\\r
-    \If{$PendingTransSet \neq \emptyset$}\r
-        \State $num_{largest} \gets num$ such that $\tuple{num, pt} \in PendingTransSet \land \forall \tuple{num', pt'} \in PendingTransSet, num \geq num'$ \Comment{Get the next largest number}\r
-        \State $num_{largest} \gets num_{largest} +1$\r
-    \EndIf\\\r
-    \r
-    \State $PendingTransSet \gets PendingTransSet \cup \{\tuple{num_{largest},PendingTrans}\}$\\\r
+    \State $DKV \gets \emptyset$\r
+    \State $pt \gets NULL$\\\r
     \r
-    \While{\Call{HasConnectionToServer}{ } $\land PendingTransSet \neq \emptyset$}    \r
-        \State $\tuple{num, pt} \gets \tuple{num, pt}$ such that $\tuple{num, pt} \in PendingTransSet \land \forall \tuple{num', pt'} \in PendingTransSet, num \leq num'$ \Comment{Get the oldest one and try to commit it}\\\r
+    \State $PendingTransQueue.$\Call{push}{$PendingTrans$}\\\r
+        \r
+    \While{\Call{HasConnectionToServer}{ } $\land PendingTransQueue \neq \emptyset$}\r
+        \State $pt \gets PendingTransQueue.$\Call{peak}{ }\\\r
     \r
         \If{\Call{TryInsertTransaction}{$pt, false$}}\r
-            \State $PendingTransSet \gets PendingTransSet \setminus \tuple{num, pt}$\r
+            \State $PendingTransQueue.$\Call{pop}{ }\r
         \EndIf\r
-    \EndWhile\r
+    \EndWhile\\    \r
+    \r
+    \LeftComment{Go Through local pending transactions and speculate}\r
+    \ForAll{$\tuple{KV, Guard} \in PendingTransQueue$}\r
+        \If{\Call{EvaluateGuard}{$Guard, SpeculatedKV$}}\r
+            \State $DKV \gets \{\tuple{k,v}| \tuple{k,v} \in SpeculatedKV \land \tuple{k',v'}\in KV \land k'=k\}$\r
+            \State $SpeculatedKV \gets (SpeculatedKV \setminus DKV) \cup KV$\r
+        \EndIf\r
+    \EndFor\r
+    \r
 \EndFunction\r
 \end{algorithmic}\r
 \end{varwidth}% \r