Changes in / [2cb8bf71:8913de4]

Location:

doc/theses/colby_parsons_MMAth

Files:

• Makefile (modified) (1 diff)
• glossary.tex (modified) (1 diff)
• style/style.tex (modified) (1 diff)
• text/channels.tex (modified) (8 diffs)
• thesis.tex (modified) (2 diffs)

doc/theses/colby_parsons_MMAth/Makefile

@@ -98 +98 @@
 
 ${BASE}.dvi : Makefile ${GRAPHS} ${PROGRAMS} ${PICTURES} ${FIGURES} ${SOURCES} ${DATA} \
-                glossary.tex style/style.tex ${Macros}/common.tex ${Macros}/indexstyle local.bib ../../bibliography/pl.bib | ${Build}
+                style/style.tex ${Macros}/common.tex ${Macros}/indexstyle local.bib ../../bibliography/pl.bib | ${Build}
         # Must have *.aux file containing citations for bibtex
         if [ ! -r ${basename $@}.aux ] ; then ${LaTeX} ${basename $@}.tex ; fi

doc/theses/colby_parsons_MMAth/glossary.tex

@@ -32 +32 @@
 % Examples from template above
 
-\newabbreviation{raii}{RAII}{\Newterm{resource acquisition is initialization}}
-\newabbreviation{rtti}{RTTI}{\Newterm{run-time type information}}
-\newabbreviation{fcfs}{FCFS}{\Newterm{first-come first-served}}
-\newabbreviation{toctou}{TOCTOU}{\Newterm{time-of-check to time-of-use}}
+\newabbreviation{raii}{RAII}{Resource Acquisition Is Initialization}
+\newabbreviation{rtti}{RTTI}{Run-Time Type Information}
+\newabbreviation{fcfs}{FCFS}{First Come First Served}
+\newabbreviation{toctou}{TOCTOU}{time-of-check to time-of-use}
 
 \newglossaryentry{actor}

doc/theses/colby_parsons_MMAth/style/style.tex

@@ -15 +15 @@
 \newsavebox{\myboxB}
 
-\lstnewenvironment{Golang}[1][]
-{\lstset{language=Go,literate={<-}{\makebox[2ex][c]{\textless\raisebox{0.4ex}{\rule{0.8ex}{0.075ex}}}}2,
-        moredelim=**[is][\protect\color{red}]{@}{@}}\lstset{#1}}
-{}
-
 \lstnewenvironment{java}[1][]
 {\lstset{language=java,moredelim=**[is][\protect\color{red}]{@}{@}}\lstset{#1}}

doc/theses/colby_parsons_MMAth/text/channels.tex

@@ -17 +17 @@
 Additionally all channel operations in CSP are synchronous (no buffering).
 Advanced channels as a programming language feature has been popularized in recent years by the language Go~\cite{Go}, which encourages the use of channels as its fundamental concurrent feature.
-It was the popularity of Go channels that lead to their implementation in \CFA.
+It was the popularity of Go channels that lead to their implemention in \CFA.
 Neither Go nor \CFA channels have the restrictions of the early channel-based concurrent systems.
 
@@ -61 +61 @@
 \section{Channel Implementation}
 Currently, only the Go programming language provides user-level threading where the primary communication mechanism is channels.
-Experiments were conducted that varied the producer-consumer algorithm and lock type used inside the channel.
+Experiments were conducted that varied the producer-consumer problem algorithm and lock type used inside the channel.
 With the exception of non-\gls{fcfs} or non-FIFO algorithms, no algorithm or lock usage in the channel implementation was found to be consistently more performant that Go's choice of algorithm and lock implementation.
 Performance of channels can be improved by sharding the underlying buffer \cite{Dice11}. 
-However, the FIFO property is lost, which is undesirable for user-facing channels.
+In doing so the FIFO property is lost, which is undesireable for user-facing channels.
 Therefore, the low-level channel implementation in \CFA is largely copied from the Go implementation, but adapted to the \CFA type and runtime systems.
 As such the research contributions added by \CFA's channel implementation lie in the realm of safety and productivity features.
 
-The Go channel implementation utilizes cooperation among threads to achieve good performance~\cite{go:chan}.
-This cooperation only occurs when producers or consumers need to block due to the buffer being full or empty.
-In these cases, a blocking thread stores their relevant data in a shared location and the signalling thread completes the blocking thread's operation before waking them;
-\ie the blocking thread has no work to perform after it unblocks because the signalling threads has done this work.
-This approach is similar to wait morphing for locks~\cite[p.~82]{Butenhof97} and improves performance in a few ways.
-First, each thread interacting with the channel only acquires and releases the internal channel lock once.
-As a result, contention on the internal lock is decreased, threads only compete for the lock upon entry, as unblocking threads do not reacquire the lock.
-The other advantage of Go's wait-morphing approach is that it eliminates the bottleneck of waiting for signalled threads to run.
-Note, the property of acquiring/releasing the lock only once can also be achieved with a different form of cooperation, called \Newterm{baton passing}.
-Baton passing occurs when one thread acquires a lock but does not release it, and instead signals a thread inside the critical section, conceptually ``passing'' the mutual exclusion from the signalling thread to the signalled thread.
-The baton-passing approach has threads cooperate to pass mutual exclusion without additional lock acquires or releases;
-the wait-morphing approach has threads cooperate by completing the signalled thread's operation, thus removing a signalled thread's need for mutual exclusion after unblocking.
-While baton passing is useful in some algorithms, it results in worse channel performance than the Go approach.
-In the baton-passing approach, all threads need to wait for the signalled thread to reach the front of the ready queue, context switch, and run before other operations on the channel can proceed, since the signalled thread holds mutual exclusion;
-in the wait-morphing approach, since the operation is completed before the signal, other threads can continue to operate on the channel without waiting for the signalled thread to run.
+The Go channel implementation utilitizes cooperation between threads to achieve good performance~\cite{go:chan}.
+The cooperation between threads only occurs when producers or consumers need to block due to the buffer being full or empty.
+In these cases the blocking thread stores their relevant data in a shared location and the signalling thread will complete their operation before waking them.
+This helps improve performance in a few ways.
+First, each thread interacting with the channel with only acquire and release the internal channel lock exactly once.
+This decreases contention on the internal lock, as only entering threads will compete for the lock since signalled threads never reacquire the lock.
+The other advantage of the cooperation approach is that it eliminates the potential bottleneck of waiting for signalled threads.
+The property of acquiring/releasing the lock only once can be achieved without cooperation by \Newterm{baton passing} the lock.
+Baton passing is when one thread acquires a lock but does not release it, and instead signals a thread inside the critical section conceptually "passing" the mutual exclusion to the signalled thread.
+While baton passing is useful in some algorithms, it results in worse performance than the cooperation approach in channel implementations since all entering threads then need to wait for the blocked thread to reach the front of the ready queue and run before other operations on the channel can proceed.
 
 In this work, all channel sizes \see{Sections~\ref{s:ChannelSize}} are implemented with bounded buffers.
@@ -105 +100 @@
 \subsection{Toggle-able Statistics}
 As discussed, a channel is a concurrent layer over a bounded buffer.
-To achieve efficient buffering, users should aim for as few blocking operations on a channel as possible.
-Mechanisms to reduce blocking are: change the buffer size, shard a channel into multiple channels, or tweak the number of producer and consumer threads.
-For users to be able to make informed decisions when tuning channel usage, toggle-able channel statistics are provided.
-The statistics are toggled on during the \CFA build by defining the @CHAN_STATS@ macro, which guarantees zero cost when not using this feature.
-When statistics are turned on, four counters are maintained per channel, two for inserting (producers) and two for removing (consumers).
+To achieve efficient buffering users should aim for as few blocking operations on a channel as possible.
+Often to achieve this users may change the buffer size, shard a channel into multiple channels, or tweak the number of producer and consumer threads.
+Fo users to be able to make informed decisions when tuning channel usage, toggle-able channel statistics are provided.
+The statistics are toggled at compile time via the @CHAN_STATS@ macro to ensure that they are entirely elided when not used.
+When statistics are turned on, four counters are maintained per channel, two for producers and two for consumers.
 The two counters per type of operation track the number of blocking operations and total operations.
-In the channel destructor, the counters are printed out aggregated and also per type of operation.
-An example use case is noting that producer inserts are blocking often while consumer removes do not block often.
-This information can be used to increase the number of consumers to decrease the blocking producer operations, thus increasing the channel throughput.
-Whereas, increasing the channel size in this scenario is unlikely to produce a benefit because the consumers can never keep up with the producers.
+In the channel destructor the counters are printed out aggregated and also per type of operation.
+An example use case of the counters follows.
+A user is buffering information between producer and consumer threads and wants to analyze channel performance.
+Via the statistics they see that producers block for a large percentage of their operations while consumers do not block often.
+They then can use this information to adjust their number of producers/consumers or channel size to achieve a larger percentage of non-blocking producer operations, thus increasing their channel throughput.
 
 \subsection{Deadlock Detection}
-The deadlock detection in the \CFA channels is fairly basic but detects a very common channel mistake during termination.
-That is, it detects the case where threads are blocked on the channel during channel deallocation.
-This case is guaranteed to deadlock since there are no producer threads to supply values needed by the waiting consumer threads.
-Only if a user maintained a separate reference to the consumer threads and manually unblocks them outside the channel could the deadlock be avoid.
-However, without special consumer semantics, this unblocking would generate other runtime errors where the consumer attempts to access non-existing channel data or even a deallocated channel.
-More robust deadlock detection needs to be implemented separate from channels since it requires knowledge about the threading system and other channel/thread state.
+The deadlock detection in the \CFA channels is fairly basic.
+It only detects the case where threads are blocked on the channel during deallocation.
+This case is guaranteed to deadlock since the list holding the blocked thread is internal to the channel and will be deallocated.
+If a user maintained a separate reference to a thread and unparked it outside the channel they could avoid the deadlock, but would run into other runtime errors since the thread would access channel data after waking that is now deallocated.
+More robust deadlock detection surrounding channel usage would have to be implemented separate from the channel implementation since it would require knowledge about the threading system and other channel/thread state.
 
 \subsection{Program Shutdown}
 Terminating concurrent programs is often one of the most difficult parts of writing concurrent code, particularly if graceful termination is needed.
-The difficulty for graceful termination often arises from the usage of synchronization primitives that need to be handled carefully during shutdown.
+The difficulty of graceful termination often arises from the usage of synchronization primitives that need to be handled carefully during shutdown.
 It is easy to deadlock during termination if threads are left behind on synchronization primitives.
 Additionally, most synchronization primitives are prone to \gls{toctou} issues where there is race between one thread checking the state of a concurrent object and another thread changing the state.
 \gls{toctou} issues with synchronization primitives often involve a race between one thread checking the primitive for blocked threads and another thread blocking on it.
 Channels are a particularly hard synchronization primitive to terminate since both sending and receiving to/from a channel can block.
-Thus, improperly handled \gls{toctou} issues with channels often result in deadlocks as threads performing the termination may end up unexpectedly blocking in their attempt to help other threads exit the system.
-
-\paragraph{Go channels} provide a set of tools to help with concurrent shutdown~\cite{go:chan} using a @close@ operation in conjunction with the \Go{select} statement.
+Thus, improperly handled \gls{toctou} issues with channels often result in deadlocks as threads trying to perform the termination may end up unexpectedly blocking in their attempt to help other threads exit the system.
+
+\paragraph{Go channels} provide a set of tools to help with concurrent shutdown~\cite{go:chan}.
+Channels in Go have a @close@ operation and a \Go{select} statement that both can be used to help threads terminate.
 The \Go{select} statement is discussed in \ref{s:waituntil}, where \CFA's @waituntil@ statement is compared with the Go \Go{select} statement.
 
@@ -147 +143 @@
 Note, panics in Go can be caught, but it is not the idiomatic way to write Go programs.
 
-While Go's channel-closing semantics are powerful enough to perform any concurrent termination needed by a program, their lack of ease of use leaves much to be desired.
+While Go's channel closing semantics are powerful enough to perform any concurrent termination needed by a program, their lack of ease of use leaves much to be desired.
 Since both closing and sending panic once a channel is closed, a user often has to synchronize the senders (producers) before the channel can be closed to avoid panics.
 However, in doing so it renders the @close@ operation nearly useless, as the only utilities it provides are the ability to ensure receivers no longer block on the channel and receive zero-valued elements.
 This functionality is only useful if the zero-typed element is recognized as a sentinel value, but if another sentinel value is necessary, then @close@ only provides the non-blocking feature.
 To avoid \gls{toctou} issues during shutdown, a busy wait with a \Go{select} statement is often used to add or remove elements from a channel.
-Hence, due to Go's asymmetric approach to channel shutdown, separate synchronization between producers and consumers of a channel has to occur during shutdown.
+Due to Go's asymmetric approach to channel shutdown, separate synchronization between producers and consumers of a channel has to occur during shutdown.
 
 \paragraph{\CFA channels} have access to an extensive exception handling mechanism~\cite{Beach21}.
@@ -165 +161 @@
 When a channel in \CFA is closed, all subsequent calls to the channel raise a resumption exception at the caller.
 If the resumption is handled, the caller attempts to complete the channel operation.
-However, if the channel operation would block, a termination exception is thrown.
+However, if channel operation would block, a termination exception is thrown.
 If the resumption is not handled, the exception is rethrown as a termination.
 These termination exceptions allow for non-local transfer that is used to great effect to eagerly and gracefully shut down a thread.
 When a channel is closed, if there are any blocked producers or consumers inside the channel, they are woken up and also have a resumption thrown at them.
-The resumption exception, @channel_closed@, has internal fields to aid in handling the exception.
-The exception contains a pointer to the channel it is thrown from and a pointer to a buffer element.
-For exceptions thrown from @remove@, the buffer element pointer is null.
-For exceptions thrown from @insert@, the element pointer points to the buffer element that the thread attempted to insert.
+The resumption exception, @channel_closed@, has a couple fields to aid in handling the exception.
+The exception contains a pointer to the channel it was thrown from, and a pointer to an element.
+In exceptions thrown from remove the element pointer will be null.
+In the case of insert the element pointer points to the element that the thread attempted to insert.
 This element pointer allows the handler to know which operation failed and also allows the element to not be lost on a failed insert since it can be moved elsewhere in the handler.
-Furthermore, due to \CFA's powerful exception system, this data can be used to choose handlers based on which channel and operation failed.
-For example, exception handlers in \CFA have an optional predicate which can be used to trigger or skip handlers based on the content of the matching exception.
-It is worth mentioning that using exceptions for termination may incur a larger performance cost than the Go approach.
-However, this should not be an issue, since termination is rarely on the fast-path of an application.
-In contrast, ensuring termination can be easily implemented correctly is the aim of the exception approach.
+Furthermore, due to \CFA's powerful exception system, this data can be used to choose handlers based which channel and operation failed.
+Exception handlers in \CFA have an optional predicate after the exception type which can be used to optionally trigger or skip handlers based on the content of an exception.
+It is worth mentioning that the approach of exceptions for termination may incur a larger performance cost during termination that the approach used in Go.
+This should not be an issue, since termination is rarely an fast-path of an application and ensuring that termination can be implemented correctly with ease is the aim of the exception approach.
 
 \section{\CFA / Go channel Examples}
-To highlight the differences between \CFA's and Go's close semantics, three examples are presented.
+To highlight the differences between \CFA's and Go's close semantics, three examples will be presented.
 The first example is a simple shutdown case, where there are producer threads and consumer threads operating on a channel for a fixed duration.
-Once the duration ends, producers and consumers terminate immediately leaving unprocessed elements in the channel.
-The second example extends the first by requiring the channel to be empty after shutdown.
+Once the duration ends, producers and consumers terminate without worrying about any leftover values in the channel.
+The second example extends the first example by requiring the channel to be empty upon shutdown.
 Both the first and second example are shown in Figure~\ref{f:ChannelTermination}.
+
+
+First the Go solutions to these examples shown in Figure~\ref{l:go_chan_term} are discussed.
+Since some of the elements being passed through the channel are zero-valued, closing the channel in Go does not aid in communicating shutdown.
+Instead, a different mechanism to communicate with the consumers and producers needs to be used.
+This use of an additional flag or communication method is common in Go channel shutdown code, since to avoid panics on a channel, the shutdown of a channel often has to be communicated with threads before it occurs.
+In this example, a flag is used to communicate with producers and another flag is used for consumers.
+Producers and consumers need separate avenues of communication both so that producers terminate before the channel is closed to avoid panicking, and to avoid the case where all the consumers terminate first, which can result in a deadlock for producers if the channel is full.
+The producer flag is set first, then after producers terminate the consumer flag is set and the channel is closed.
+In the second example where all values need to be consumed, the main thread iterates over the closed channel to process any remaining values.
+
+
+In the \CFA solutions in Figure~\ref{l:cfa_chan_term}, shutdown is communicated directly to both producers and consumers via the @close@ call.
+In the first example where all values do not need to be consumed, both producers and consumers do not handle the resumption and finish once they receive the termination exception.
+The second \CFA example where all values must be consumed highlights how resumption is used with channel shutdown.
+The @Producer@ thread-main knows to stop producing when the @insert@ call on a closed channel raises exception @channel_closed@.
+The @Consumer@ thread-main knows to stop consuming after all elements of a closed channel are removed and the call to @remove@ would block.
+Hence, the consumer knows the moment the channel closes because a resumption exception is raised, caught, and ignored, and then control returns to @remove@ to return another item from the buffer.
+Only when the buffer is drained and the call to @remove@ would block, a termination exception is raised to stop consuming.
+The \CFA semantics allow users to communicate channel shutdown directly through the channel, without having to share extra state between threads.
+Additionally, when the channel needs to be drained, \CFA provides users with easy options for processing the leftover channel values in the main thread or in the consumer threads.
+If one wishes to consume the leftover values in the consumer threads in Go, extra synchronization between the main thread and the consumer threads is needed.
 
 \begin{figure}
@@ -191 +208 @@
 
 \begin{lrbox}{\myboxA}
-\begin{Golang}[aboveskip=0pt,belowskip=0pt]
-var channel chan int = make( chan int, 128 )
-var prodJoin chan int = make( chan int, 4 )
-var consJoin chan int = make( chan int, 4 )
-var cons_done, prod_done bool = false, false;
-func producer() {
-        for {
-                if prod_done { break }
-                channel <- 5
-        }
-        prodJoin <- 0 // synch with main thd
-}
-
-func consumer() {
-        for {
-                if cons_done { break }
-                <- channel
-        }
-        consJoin <- 0 // synch with main thd
-}
-
-
-func main() {
-        for j := 0; j < 4; j++ { go consumer() }
-        for j := 0; j < 4; j++ { go producer() }
-        time.Sleep( time.Second * 10 )
-        prod_done = true
-        for j := 0; j < 4 ; j++ { <- prodJoin }
-        cons_done = true
-        close(channel) // ensure no cons deadlock
-        @for elem := range channel {@
-                // process leftover values
-        @}@
-        for j := 0; j < 4; j++ { <- consJoin }
-}
-\end{Golang}
+\begin{cfa}[aboveskip=0pt,belowskip=0pt]
+channel( size_t ) Channel{ ChannelSize };
+
+thread Consumer {};
+void main( Consumer & this ) {
+    try {
+        for ( ;; )
+            remove( Channel );
+    @} catchResume( channel_closed * ) { @
+    // handled resume => consume from chan
+    } catch( channel_closed * ) {
+        // empty or unhandled resume
+    } 
+}
+
+thread Producer {};
+void main( Producer & this ) {
+    size_t count = 0;
+    try {
+        for ( ;; )
+            insert( Channel, count++ );
+    } catch ( channel_closed * ) {
+        // unhandled resume or full
+    } 
+}
+
+int main( int argc, char * argv[] ) {
+    Consumer c[Consumers];
+    Producer p[Producers];
+    sleep(Duration`s);
+    close( Channel );
+    return 0;
+}
+\end{cfa}
 \end{lrbox}
 
 \begin{lrbox}{\myboxB}
 \begin{cfa}[aboveskip=0pt,belowskip=0pt]
-channel( size_t ) chan{ 128 };
-thread Consumer {};
-thread Producer {};
-
-void main( Producer & this ) {
-        try {
-                for ()
-                        insert( chan, 5 );
-        } catch( channel_closed * ) {
-                // unhandled resume or full
-        }
-}
-void main( Consumer & this ) {
-        try {
-                for () { int i = remove( chan ); }
-        @} catchResume( channel_closed * ) {@
-                // handled resume => consume from chan
-        } catch( channel_closed * ) {
-                // empty or unhandled resume
-        }
-}
-int main() {
-        Consumer c[4];
-        Producer p[4];
-        sleep( 10`s );
-        close( chan );
-}
-
-
-
-
-
-
-
+var cons_done, prod_done bool = false, false;
+var prodJoin chan int = make(chan int, Producers)
+var consJoin chan int = make(chan int, Consumers)
+
+func consumer( channel chan uint64 ) {
+    for {
+        if cons_done { break }
+        <-channel
+    }
+    consJoin <- 0 // synch with main thd
+}
+
+func producer( channel chan uint64 ) {
+    var count uint64 = 0
+    for {
+        if prod_done { break }
+        channel <- count++
+    }
+    prodJoin <- 0 // synch with main thd
+}
+
+func main() {
+    channel = make(chan uint64, ChannelSize)
+    for j := 0; j < Consumers; j++ {
+        go consumer( channel )
+    }
+    for j := 0; j < Producers; j++ {
+        go producer( channel )
+    }
+    time.Sleep(time.Second * Duration)
+    prod_done = true
+    for j := 0; j < Producers ; j++ {
+        <-prodJoin // wait for prods
+    }
+    cons_done = true
+    close(channel) // ensure no cons deadlock
+    @for elem := range channel { @
+        // process leftover values
+    @}@
+    for j := 0; j < Consumers; j++{
+        <-consJoin // wait for cons
+    }
+}
 \end{cfa}
 \end{lrbox}
 
-\subfloat[Go style]{\label{l:go_chan_term}\usebox\myboxA}
+\subfloat[\CFA style]{\label{l:cfa_chan_term}\usebox\myboxA}
 \hspace*{3pt}
 \vrule
 \hspace*{3pt}
-\subfloat[\CFA style]{\label{l:cfa_chan_term}\usebox\myboxB}
+\subfloat[Go style]{\label{l:go_chan_term}\usebox\myboxB}
 \caption{Channel Termination Examples 1 and 2. Code specific to example 2 is highlighted.}
 \label{f:ChannelTermination}
 \end{figure}
 
-Figure~\ref{l:go_chan_term} shows the Go solution.
-Since some of the elements being passed through the channel are zero-valued, closing the channel in Go does not aid in communicating shutdown.
-Instead, a different mechanism to communicate with the consumers and producers needs to be used.
-Flag variables are common in Go-channel shutdown-code to avoid panics on a channel, meaning the channel shutdown has to be communicated with threads before it occurs.
-Hence, the two flags @cons_done@ and @prod_done@ are used to communicate with the producers and consumers, respectively.
-Furthermore, producers and consumers need separate shutdown channels so producers terminate before the channel is closed to avoid panicking, and to avoid the case where all the consumers terminate first, which can result in a deadlock for producers if the channel is full.
-The producer flag is set first;
-then after all producers terminate, the consumer flag is set and the channel is closed leaving elements in the buffer.
-To purge the buffer, a loop is added (red) that iterates over the closed channel to process any remaining values.
-
-Figure~\ref{l:cfa_chan_term} shows the \CFA solution.
-Here, shutdown is communicated directly to both producers and consumers via the @close@ call.
-A @Producer@ thread knows to stop producing when the @insert@ call on a closed channel raises exception @channel_closed@.
-If a @Consumer@ thread ignores the first resumption exception from the @close@, the exception is reraised as a termination exception and elements are left in the buffer.
-If a @Consumer@ thread handles the resumptions exceptions (red), control returns to complete the remove.
-A @Consumer@ thread knows to stop consuming after all elements of a closed channel are removed and the consumer would block, which causes a termination raise of @channel_closed@.
-The \CFA semantics allow users to communicate channel shutdown directly through the channel, without having to share extra state between threads.
-Additionally, when the channel needs to be drained, \CFA provides users with easy options for processing the leftover channel values in the main thread or in the consumer threads.
-
-Figure~\ref{f:ChannelBarrierTermination} shows a final shutdown example using channels to implement a barrier.
-A Go and \CFA style solution are presented but both are implemented using \CFA syntax so they can be easily compared.
-Implementing a barrier is interesting because threads are both producers and consumers on the barrier-internal channels, @entryWait@ and @barWait@.
-The outline for the barrier implementation starts by initially filling the @entryWait@ channel with $N$ tickets in the barrier constructor, allowing $N$ arriving threads to remove these values and enter the barrier.
-After @entryWait@ is empty, arriving threads block when removing from @entryWait@.
-However, the arriving threads that entered the barrier cannot leave the barrier until $N$ threads have arrived.
-Hence, the entering threads block on the @barWait@ channel until the $N$th arriving thread inserts $N-1$ elements into @barWait@ to unblock the $N-1$ threads calling @remove@ on the @barWait@ channel.
-The race between these arriving threads blocking on @barWait@ and the $N$th thread inserting values into @barWait@ does not affect correctness;
-\ie an arriving thread may or may not block on channel @barWait@ to get its value.
-
-Now, the two channels makes termination synchronization between producers and consumers difficult.
-Interestingly, the shutdown details for this problem are also applicable to other problems with threads producing and consuming from the same channel.
-The Go-style solution cannot use the Go @close@ call since all threads are both potentially producers and consumers, causing panics on close to be unavoidable without complex synchronization.
-As such in Figure \ref{l:go_chan_bar}, a flush routine is needed to insert a sentinel value, @-1@, to inform threads waiting in the buffer they need to leave the barrier.
-This sentinel value has to be checked at two points along the fast-path and sentinel values daisy-chained into the buffers.
+The final shutdown example uses channels to implement a barrier.
+It is shown in Figure~\ref{f:ChannelBarrierTermination}.
+The problem of implementing a barrier is chosen since threads are both producers and consumers on the barrier-internal channels, which removes the ability to easily synchronize producers before consumers during shutdown.
+As such, while the shutdown details will be discussed with this problem in mind, they are also applicable to other problems taht have individual threads both producing and consuming from channels.
+Both of these examples are implemented using \CFA syntax so that they can be easily compared.
+Figure~\ref{l:cfa_chan_bar} uses \CFA-style channel close semantics and Figure~\ref{l:go_chan_bar} uses Go-style close semantics.
+In this example it is infeasible to use the Go @close@ call since all threads are both potentially producers and consumers, causing panics on close to be unavoidable without complex synchronization.
+As such in Figure~\ref{l:go_chan_bar} to implement a flush routine for the buffer, a sentinel value of @-1@ has to be used to indicate to threads that they need to leave the barrier.
+This sentinel value has to be checked at two points.
 Furthermore, an additional flag @done@ is needed to communicate to threads once they have left the barrier that they are done.
+
+In the \CFA version~\ref{l:cfa_chan_bar}, the barrier shutdown results in an exception being thrown at threads operating on it, which informs the threads that they must terminate.
+This avoids the need to use a separate communication method other than the barrier, and avoids extra conditional checks on the fast path of the barrier implementation.
 Also note that in the Go version~\ref{l:go_chan_bar}, the size of the barrier channels has to be larger than in the \CFA version to ensure that the main thread does not block when attempting to clear the barrier.
-For The \CFA solution~\ref{l:cfa_chan_bar}, the barrier shutdown results in an exception being thrown at threads operating on it, to inform waiting threads they must leave the barrier.
-This avoids the need to use a separate communication method other than the barrier, and avoids extra conditional checks on the fast path of the barrier implementation.
 
 \begin{figure}
@@ -320 +320 @@
 
 \begin{lrbox}{\myboxA}
+\begin{cfa}[aboveskip=0pt,belowskip=0pt]
+struct barrier {
+        channel( int ) barWait, entryWait;
+        int size;
+};
+void ?{}( barrier & this, int size ) with(this) {
+        barWait{size};   entryWait{size};
+        this.size = size;
+        for ( i; size )
+                insert( entryWait, i );
+}
+void wait( barrier & this ) with(this) {
+        int ticket = remove( entryWait );
+
+        if ( ticket == size - 1 ) {
+                for ( i; size - 1 )
+                        insert( barWait, i );
+                return;
+        }
+        ticket = remove( barWait );
+
+        if ( size == 1 || ticket == size - 2 ) { // last ?
+                for ( i; size )
+                        insert( entryWait, i );
+        }
+}
+void flush(barrier & this) with(this) {
+        @close( barWait );   close( entryWait );@
+}
+enum { Threads = 4 };
+barrier b{Threads};
+
+thread Thread {};
+void main( Thread & this ) {
+        @try {@
+                for ()
+                        wait( b );
+        @} catch ( channel_closed * ) {}@
+}
+int main() {
+        Thread t[Threads];
+        sleep(10`s);
+
+        flush( b );
+} // wait for threads to terminate
+\end{cfa}
+\end{lrbox}
+
+\begin{lrbox}{\myboxB}
 \begin{cfa}[aboveskip=0pt,belowskip=0pt]
 struct barrier {
@@ -368 +417 @@
 \end{lrbox}
 
-\begin{lrbox}{\myboxB}
-\begin{cfa}[aboveskip=0pt,belowskip=0pt]
-struct barrier {
-        channel( int ) barWait, entryWait;
-        int size;
-};
-void ?{}( barrier & this, int size ) with(this) {
-        barWait{size};   entryWait{size};
-        this.size = size;
-        for ( i; size )
-                insert( entryWait, i );
-}
-void wait( barrier & this ) with(this) {
-        int ticket = remove( entryWait );
-
-        if ( ticket == size - 1 ) {
-                for ( i; size - 1 )
-                        insert( barWait, i );
-                return;
-        }
-        ticket = remove( barWait );
-
-        if ( size == 1 || ticket == size - 2 ) { // last ?
-                for ( i; size )
-                        insert( entryWait, i );
-        }
-}
-void flush(barrier & this) with(this) {
-        @close( barWait );   close( entryWait );@
-}
-enum { Threads = 4 };
-barrier b{Threads};
-
-thread Thread {};
-void main( Thread & this ) {
-        @try {@
-                for ()
-                        wait( b );
-        @} catch ( channel_closed * ) {}@
-}
-int main() {
-        Thread t[Threads];
-        sleep(10`s);
-
-        flush( b );
-} // wait for threads to terminate
-\end{cfa}
-\end{lrbox}
-
-\subfloat[Go style]{\label{l:go_chan_bar}\usebox\myboxA}
+\subfloat[\CFA style]{\label{l:cfa_chan_bar}\usebox\myboxA}
 \hspace*{3pt}
 \vrule
 \hspace*{3pt}
-\subfloat[\CFA style]{\label{l:cfa_chan_bar}\usebox\myboxB}
+\subfloat[Go style]{\label{l:go_chan_bar}\usebox\myboxB}
 \caption{Channel Barrier Termination}
 \label{f:ChannelBarrierTermination}

doc/theses/colby_parsons_MMAth/thesis.tex

@@ -111 +111 @@
     colorlinks=true,        % false: boxed links; true: colored links
     linkcolor=blue,         % color of internal links
-    citecolor=blue,         % color of links to bibliography
+    citecolor=blue,        % color of links to bibliography
     filecolor=magenta,      % color of file links
-    urlcolor=cyan,          % color of external links
-    breaklinks=true
+    urlcolor=cyan           % color of external links
 }
 \ifthenelse{\boolean{PrintVersion}}{   % for improved print quality, change some hyperref options
@@ -127 +126 @@
 % \usepackage[acronym]{glossaries}
 \usepackage[automake,toc,abbreviations]{glossaries-extra} % Exception to the rule of hyperref being the last add-on package
-\renewcommand*{\glstextformat}[1]{\textcolor{black}{#1}}
 % If glossaries-extra is not in your LaTeX distribution, get it from CTAN (http://ctan.org/pkg/glossaries-extra), 
 % although it's supposed to be in both the TeX Live and MikTeX distributions. There are also documentation and