From 533cdfb7a5949c170fa32a132eec8505d270c464 Mon Sep 17 00:00:00 2001
From: Olivier Blanvillain <olivier.blanvillain@epfl.ch>
Date: Sun, 28 Mar 2021 14:00:01 +0200
Subject: [PATCH] Add labs/lab6-lock-free-sorted-list
---
labs/lab6-lock-free-sorted-list/README.md | 193 ++++++++++++++++++++++
labs/lab6-lock-free-sorted-list/step0.png | Bin 0 -> 2042 bytes
labs/lab6-lock-free-sorted-list/step1.png | Bin 0 -> 4278 bytes
labs/lab6-lock-free-sorted-list/step2.png | Bin 0 -> 6487 bytes
labs/lab6-lock-free-sorted-list/step3.png | Bin 0 -> 7112 bytes
5 files changed, 193 insertions(+)
create mode 100644 labs/lab6-lock-free-sorted-list/README.md
create mode 100644 labs/lab6-lock-free-sorted-list/step0.png
create mode 100644 labs/lab6-lock-free-sorted-list/step1.png
create mode 100644 labs/lab6-lock-free-sorted-list/step2.png
create mode 100644 labs/lab6-lock-free-sorted-list/step3.png
diff --git a/labs/lab6-lock-free-sorted-list/README.md b/labs/lab6-lock-free-sorted-list/README.md
new file mode 100644
index 0000000..820bb19
--- /dev/null
+++ b/labs/lab6-lock-free-sorted-list/README.md
@@ -0,0 +1,193 @@
+# Lock-free Sorted List
+
+Use the following commands to make a fresh clone of your repository:
+
+```
+git clone -b lockfree git@gitlab.epfl.ch:lamp/student-repositories-s21/cs206-GASPAR.git cs206-lockfree
+```
+
+## Useful links
+
+ * [The API documentation of the Scala standard library](https://www.scala-lang.org/files/archive/api/2.13.4)
+ * [The API documentation of the Java standard library](https://docs.oracle.com/en/java/javase/15/docs/api/index.html)
+
+**If you have issues with the IDE, try [reimporting the
+build](https://gitlab.epfl.ch/lamp/cs206/-/blob/master/labs/example-lab.md#ide-features-like-type-on-hover-or-go-to-definition-do-not-work),
+if you still have problems, use `compile` in sbt instead.**
+
+## Introduction
+
+The goal of this assignment is to implement a concurrent list that stores values of type `Int` in ascending order.
+Last week, we have seen how to use a monitor to make data structures operations behave correctly in a concurrent setting.
+This week, the data structure we will implement will not use a monitor or a lock of any kind.
+Instead, we will use an atomic operation, called `compareAndSet`, in your implementation of the data structure operations.
+
+The goal will still be to have a data structure that can safely be used in a concurrent setting.
+In addition, the sorted list operations you will implement will be *lock-free*.
+In a system where all concurrent operations have this property, the progress of at least one thread is ***guaranteed***.
+There can not be a global deadlock in which none of the thread can make progress!
+Note that this does *not* guarantee that all threads can make progress.
+Operation with this property is said to be *wait-free*.
+
+## Atomic Variables
+
+The list methods you will implement will make use of atomic variables. An atomic variable is an object which holds a value of a given type `T`. The object offers two methods to manipulate this value:
+- `get`, which returns the current value held in the variable,
+- `compareAndSet`, which modifies the content of the variable provided that the previous value is given. This method returns `true` if it was successful, `false` otherwise.
+
+The operation `compareAndSet` applies the following logic ***atomically***, which means there cannot be any context switches between the instructions of the operation:
+```scala
+def compareAndSet(expected: T, value: T) {
+ if (current == expected) {
+ current = value
+ true
+ }
+ else {
+ false
+ }
+}
+```
+
+The `AtomicVariable` class is given to you. You do not have to worry about implementing it!
+
+Note that a similar class exists in the Java standard library, called [`AtomicReference`](https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/atomic/AtomicReference.html).
+The main difference between `AtomicReference` and the `AtomicVariable` class we defined for this exercise is that `AtomicReference` uses referential equality to check whether `expected` and `current` are the same, while `AtomicVariable` uses the `==` method.
+
+## The Sorted List Data Structure
+
+The data structure you will implement is a mutable linked list of integers, sorted in ascending order. Each integer is stored in a `Node`. In addition to the integer value, each node contains a mutable reference to the next node in the list. This mutable reference is held in an `AtomicVariable`.
+
+```scala
+abstract class Node(val value: Int, initTail: Option[Node]) {
+
+ type State = Option[Node]
+
+ def initialState: State = initTail
+
+ val atomicState: AbstractAtomicVariable[State] = new AtomicVariable[State](initialState)
+
+ def next: Option[Node] = atomicState.get
+
+ // ...
+}
+```
+
+Then, `SortedList` is simply a class that holds a reference to the first node of the list. This class is defined in `SortedList.scala`.
+
+```scala
+class SortedList extends AbstractSortedList {
+
+ // The sentinel node at the head.
+ private val _head = createNode(0, None, isHead=true)
+
+ // The first logical node is referenced by the head.
+ def firstNode: Option[Node] = _head.next
+
+ def findNodeWithPrev(pred: Int => Boolean): (Node, Option[Node]) = ???
+
+ def insert(e: Int): Unit = ???
+
+ def contains(e: Int): Boolean = ???
+
+ def delete(e: Int): Boolean = ???
+}
+```
+
+The value `_head` of the list is called a [*sentinel* node](https://en.wikipedia.org/wiki/Sentinel_node). This value is simply `Node` that will serve only as a reference to the first actual node of the list. The value (viz. zero) held by this special node should be completely ignored. This technique is useful because it limits the duplication of code. An alternative is to have a reference to the first node using an `AtomicVariable`. But this would force us to handle the first node differently from the rest. So will use a sentinel node for this assignment.
+
+### `findNodeWithPrev`
+
+The first method you will implement is an internal helper method which will be used all other methods.
+This method should do a traversal of the list to find the first node whose value satisfies the parameter predicate.
+The method should return the following two values as a pair:
+- the predecessor of the node,
+- the node.
+
+If `node` is the first node whose value satisfies the predicate and `predecessor` its predecessor, then the method should return `(predecessor, Some(node))`. Due to the use of the sentinel node at the head of the list, the method is bound to find a predecessor, even for the first logical node.
+
+When the predicate doesn't hold on any of the values, then the function should return `(last, None)`, where
+`last` is the last node of the list.
+
+### `insert`
+
+Your first goal will be to code the insert method of the lock-free list. The idea is very simple:
+
+1. Locate the position you need to insert by using the `findNodeWithPrev` method you have just implemented.
+2. Create a new node that holds the value and points to the correct next node. For this, you should use `createNode(value, nextNode)`.
+3. Use the `compareAndSet` operation to make the previous node point to your newly created node.
+4. If the operation failed, retry from the start! Otherwise, the operation is done!
+
+### `contains`
+
+Next, you should implement the `contains` method, which checks if the list contains a given element. You may of course use the `findNodeWithPrev` method you have implemented.
+
+### `delete`
+
+With the addition of `delete`, things get rapidly trickier. The intuitive solution would be to:
+
+1. Find the node to delete and its predecessor using `findNodeWithPrev`.
+2. Use an atomic `compareAndSet` operation to make the predecessor node point to the successor.
+
+Unfortunately, this solution is not entirely satisfactory!
+Indeed, there exist schedules in which some successful operations are lost. Can you think of any?
+
+As an example, assume that the list currently contains the values `10` and `30`.
+
+
+- Imagine one thread starts executing the insertion of `20` in the list and correctly locates where to insert the new node (between `10` and `30`). The thread then creates a node with value `20` and makes it point to the node with value `30`. 
+- Now, some other thread is scheduled and starts executing the deletion of the node with value `10`. The thread finds the two nodes that surround it, that is the sentinel node at the head of the list and the node with value `30` (note that the insertion of `20` by the other thread isn't visible yet!). The thread, using compare and set, changes the next pointer of the sentinel node to the node with value `30`. The `delete` operation then terminates successfully. 
+- Now, the first thread resumes its execution. Its next instruction is to use compare and set to change the next pointer of the node with value `10`, which it can do without any problem! Indeed, this atomic variable wasn't touched by the delete operation. The `insert` operation looks successful, even though the node that was inserted is not reachable from the head of the list! The operation was lost... 
+
+One solution to this problem, as proposed by Timothy L. Harris in his paper [A Pragmatic Implementation of Non-Blocking Linked Lists](https://www.cl.cam.ac.uk/research/srg/netos/papers/2001-caslists.pdf), is to somehow record in the node that it was deleted.
+We will proceed similarly in this assignment.
+
+#### Marking Nodes
+
+The first step is to modify the mutable state held by nodes. Open the `Node.scala` file. Until now the state was just `Option[Node]`, which is an optional reference to the next node.
+You will need to add, in addition to this information, a boolean flag that indicates whether the node was deleted or not.
+
+
+```scala
+abstract class Node(val value: Int, initTail: Option[Node]) {
+
+ type State = ???
+
+ def initialState: State = ???
+
+ val atomicState: AbstractAtomicVariable[State] = new AtomicVariable[State](initialState)
+
+ def next: Option[Node] = ???
+
+ def deleted: Boolean = ???
+
+ def mark: Boolean = ???
+}
+```
+
+Begin by modifying the `State` type to any type that you deem appropriate. Remember that the value of this type should contain an `Option[Node]` (the next node) and a flag (whether the node has been marked).
+
+Complete the other functions, described below, as well:
+- `initialState` should return the state of the node when it is first created. Note that the node should not be marked and the optional reference to the next node should be set to `initTail`.
+- `next` should return the optional reference to the next node held currently in the state.
+- `deleted` should return `true` if the node was marked, `false` otherwise.
+- `mark` should mark the node as `deleted`. The method should return `true` only if it is the first time this node is marked. If the node was previously marked, this method should return `false`. (Think carefully about this!)
+
+#### Implementing `delete` of `SortedList`
+
+Now, we can implement a version of delete that is not vulnerable to the problem exposed earlier. The idea is to:
+
+1. Find the node to delete and its predecessor using `findNodeWithPrev`.
+2. Mark the node as `deleted` using its `mark` method. If it returns false, retry from the start!
+
+Once this is done, we still have to modify the other list methods to handle the fact that nodes can be marked.
+Marked nodes will be deleted within the `findNodeWithPrev` method.
+
+#### Adapting `findNodeWithPrev` to handle marked nodes
+
+The first method you need to adapt is `findNodeWithPrev`. The method should do exactly as before except when it encounters a marked node during its traversal. When it does so, the method should use compare and set to modify the next node pointed by the predecessor node. Regardless of the outcome of the compare and set operation, the `findNodeWithPrev` should then restart from scratch.
+
+#### Adapting `insert` to handle marked nodes
+
+The last method you need to change is `insert`. The logic remains exactly the same, except that when you perform the `compareAndSet` operation, you should make sure that the parameters are of type `State` and are not flagged as deleted.
+
+You are now done with this assignment. Congratulations!
diff --git a/labs/lab6-lock-free-sorted-list/step0.png b/labs/lab6-lock-free-sorted-list/step0.png
new file mode 100644
index 0000000000000000000000000000000000000000..7730e289490798d2a298b3794e592fd810a81df3
GIT binary patch
literal 2042
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
Qb~?iAh_8Fyw<pv84S^Fp{Qv*}
literal 0
HcmV?d00001
diff --git a/labs/lab6-lock-free-sorted-list/step1.png b/labs/lab6-lock-free-sorted-list/step1.png
new file mode 100644
index 0000000000000000000000000000000000000000..59a5df13ab342a8965fff748ab716d17365d28b4
GIT binary patch
literal 4278
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
N{>9F+^z@bA{tJq{n4ACr
literal 0
HcmV?d00001
diff --git a/labs/lab6-lock-free-sorted-list/step2.png b/labs/lab6-lock-free-sorted-list/step2.png
new file mode 100644
index 0000000000000000000000000000000000000000..1b09129d815cdbc2081ca7d9073c9c18cb6d0a90
GIT binary patch
literal 6487
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
a_!Rep%XW`-1$;1})4yh-Q+?Ix(SHGD^0;CE
literal 0
HcmV?d00001
diff --git a/labs/lab6-lock-free-sorted-list/step3.png b/labs/lab6-lock-free-sorted-list/step3.png
new file mode 100644
index 0000000000000000000000000000000000000000..fb9dcfff4ac0a5ecbe3cbee823a1793b03e7c0d9
GIT binary patch
literal 7112
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
DDp}#<
literal 0
HcmV?d00001
--
GitLab