source: doc/proposals/concurrency/concurrency.tex @ 0d10090

% requires tex packages: texlive-base texlive-latex-base tex-common texlive-humanities texlive-latex-extra texlive-fonts-recommended

% inline code ©...© (copyright symbol) emacs: C-q M-)
% red highlighting ®...® (registered trademark symbol) emacs: C-q M-.
% blue highlighting ß...ß (sharp s symbol) emacs: C-q M-_
% green highlighting ¢...¢ (cent symbol) emacs: C-q M-"
% LaTex escape §...§ (section symbol) emacs: C-q M-'
% keyword escape ¶...¶ (pilcrow symbol) emacs: C-q M-^
% math escape $...$ (dollar symbol)

\documentclass[twoside,11pt]{article}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

% Latex packages used in the document.
\usepackage[T1]{fontenc}                                        % allow Latin1 (extended ASCII) characters
\usepackage{textcomp}
\usepackage[latin1]{inputenc}
\usepackage{fullpage,times,comment}
\usepackage{epic,eepic}
\usepackage{upquote}                                            % switch curled `'" to straight
\usepackage{calc}
\usepackage{xspace}
\usepackage{graphicx}
\usepackage{tabularx}
\usepackage[acronym]{glossaries}
\usepackage{varioref}                                           % extended references
\usepackage{inconsolata}
\usepackage{listings}                                           % format program code
\usepackage[flushmargin]{footmisc}                              % support label/reference in footnote
\usepackage{latexsym}                                           % \Box glyph
\usepackage{mathptmx}                                           % better math font with "times"
\usepackage[usenames]{color}
\usepackage[pagewise]{lineno}
\usepackage{fancyhdr}
\renewcommand{\linenumberfont}{\scriptsize\sffamily}
\input{style}                                                   % bespoke macros used in the document
\usepackage[dvips,plainpages=false,pdfpagelabels,pdfpagemode=UseNone,colorlinks=true,pagebackref=true,linkcolor=blue,citecolor=blue,urlcolor=blue,pagebackref=true,breaklinks=true]{hyperref}
\usepackage{breakurl}

\usepackage{tikz}
\def\checkmark{\tikz\fill[scale=0.4](0,.35) -- (.25,0) -- (1,.7) -- (.25,.15) -- cycle;}

\renewcommand{\UrlFont}{\small\sf}

\setlength{\topmargin}{-0.45in}                         % move running title into header
\setlength{\headsep}{0.25in}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

% Names used in the document.

\newcommand{\Version}{1.0.0}
\newcommand{\CS}{C\raisebox{-0.9ex}{\large$^\sharp$}\xspace}

\newcommand{\Textbf}[2][red]{{\color{#1}{\textbf{#2}}}}
\newcommand{\Emph}[2][red]{{\color{#1}\textbf{\emph{#2}}}}
\newcommand{\R}[1]{\Textbf{#1}}
\newcommand{\B}[1]{{\Textbf[blue]{#1}}}
\newcommand{\G}[1]{{\Textbf[OliveGreen]{#1}}}
\newcommand{\uC}{$\mu$\CC}
\newcommand{\cit}{\textsuperscript{[Citation Needed]}\xspace}
\newcommand{\code}[1]{\lstinline[language=CFA]{#1}}
\newcommand{\pseudo}[1]{\lstinline[language=Pseudo]{#1}}

\input{glossary}

\newsavebox{\LstBox}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\setcounter{secnumdepth}{3}                             % number subsubsections
\setcounter{tocdepth}{3}                                % subsubsections in table of contents
% \linenumbers                                            % comment out to turn off line numbering
\makeindex
\pagestyle{fancy}
\fancyhf{}
\cfoot{\thepage}
\rfoot{v\input{version}}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\begin{document}
% \linenumbers

\title{Concurrency in \CFA}
\author{Thierry Delisle \\
School of Computer Science, University of Waterloo, \\ Waterloo, Ontario, Canada
}

\maketitle

% ### #     # ####### ######  #######
%  #  ##    #    #    #     # #     #
%  #  # #   #    #    #     # #     #
%  #  #  #  #    #    ######  #     #
%  #  #   # #    #    #   #   #     #
%  #  #    ##    #    #    #  #     #
% ### #     #    #    #     # #######

\section{Introduction}
This proposal provides a minimal core concurrency API that is both simple, efficient and can be reused to build higher-level features. The simplest possible concurrency core is a thread and a lock but this low-level approach is hard to master. An easier approach for users is to support higher-level constructs as the basis of the concurrency in \CFA. Indeed, for highly productive parallel programming, high-level approaches are much more popular~\cite{HPP:Study}. Examples are task based, message passing and implicit threading.

There are actually two problems that need to be solved in the design of the concurrency for a programming language: which concurrency tools are available to the users and which parallelism tools are available. While these two concepts are often seen together, they are in fact distinct concepts that require different sorts of tools~\cite{Buhr05a}. Concurrency tools need to handle mutual exclusion and synchronization, while parallelism tools are more about performance, cost and resource utilization.

%  #####  ####### #     #  #####  #     # ######  ######  ####### #     #  #####  #     #
% #     # #     # ##    # #     # #     # #     # #     # #       ##    # #     #  #   #
% #       #     # # #   # #       #     # #     # #     # #       # #   # #         # #
% #       #     # #  #  # #       #     # ######  ######  #####   #  #  # #          #
% #       #     # #   # # #       #     # #   #   #   #   #       #   # # #          #
% #     # #     # #    ## #     # #     # #    #  #    #  #       #    ## #     #    #
%  #####  ####### #     #  #####   #####  #     # #     # ####### #     #  #####     #

\section{Concurrency}
Several tool can be used to solve concurrency challenges. Since these challenges always appear with the use of mutable shared-state, some languages and libraries simply disallow mutable shared-state (Erlang~\cite{Erlang}, Haskell~\cite{Haskell}, Akka (Scala)~\cite{Akka}). In these paradigms, interaction among concurrent objects relies on message passing~\cite{Thoth,Harmony,V-Kernel} or other paradigms that closely relate to networking concepts (channels\cit for example). However, in languages that use routine calls as their core abstraction mechanism, these approaches force a clear distinction between concurrent and non-concurrent paradigms (i.e., message passing versus routine call). Which in turn means that, in order to be effective, programmers need to learn two sets of designs patterns. This distinction can be hidden away in library code, but effective use of the librairy still has to take both paradigms into account. Approaches based on shared memory are more closely related to non-concurrent paradigms since they often rely on basic constructs like routine calls and objects. At a lower level these can be implemented as locks and atomic operations. Many such mechanisms have been proposed, including semaphores~\cite{Dijkstra68b} and path expressions~\cite{Campbell74}. However, for productivity reasons it is desireable to have a higher-level construct be the core concurrency paradigm~\cite{HPP:Study}. An approach that is worth mentionning because it is gaining in popularity is transactionnal memory~\cite{Dice10}[Check citation]. While this approach is even pursued by system languages like \CC\cit, the performance and feature set is currently too restrictive to add such a paradigm to a language like C or \CC\cit, which is why it was rejected as the core paradigm for concurrency in \CFA. One of the most natural, elegant, and efficient mechanisms for synchronization and communication, especially for shared memory systems, is the \emph{monitor}. Monitors were first proposed by Brinch Hansen~\cite{Hansen73} and later described and extended by C.A.R.~Hoare~\cite{Hoare74}. Many programming languages---e.g., Concurrent Pascal~\cite{ConcurrentPascal}, Mesa~\cite{Mesa}, Modula~\cite{Modula-2}, Turing~\cite{Turing:old}, Modula-3~\cite{Modula-3}, NeWS~\cite{NeWS}, Emerald~\cite{Emerald}, \uC~\cite{Buhr92a} and Java~\cite{Java}---provide monitors as explicit language constructs. In addition, operating-system kernels and device drivers have a monitor-like structure, although they often use lower-level primitives such as semaphores or locks to simulate monitors. For these reasons, this project proposes monitors as the core concurrency construct.

% #     # ####### #     # ### ####### ####### ######   #####
% ##   ## #     # ##    #  #     #    #     # #     # #     #
% # # # # #     # # #   #  #     #    #     # #     # #
% #  #  # #     # #  #  #  #     #    #     # ######   #####
% #     # #     # #   # #  #     #    #     # #   #         #
% #     # #     # #    ##  #     #    #     # #    #  #     #
% #     # ####### #     # ###    #    ####### #     #  #####

\subsection{Monitors}
A monitor is a set of routines that ensure mutual exclusion when accessing shared state. This concept is generally associated with Object-Oriented Languages like Java~\cite{Java} or \uC~\cite{uC++book} but does not strictly require OOP semantics. The only requirements is the ability to declare a handle to a shared object and a set of routines that act on it :
\begin{lstlisting}
        typedef /*some monitor type*/ monitor;
        int f(monitor & m);

        int main() {
                monitor m;
                f(m);
        }
\end{lstlisting}

%  #####     #    #       #
% #     #   # #   #       #
% #        #   #  #       #
% #       #     # #       #
% #       ####### #       #
% #     # #     # #       #
%  #####  #     # ####### #######

\subsubsection{Call semantics} \label{call}
The above monitor example displays some of the intrinsic characteristics. Indeed, it is necessary to use pass-by-reference over pass-by-value for monitor routines. This semantics is important because at their core, monitors are implicit mutual-exclusion objects (locks), and these objects cannot be copied. Therefore, monitors are implicitly non-copyable.

Another aspect to consider is when a monitor acquires its mutual exclusion. For example, a monitor may need to be passed through multiple helper routines that do not acquire the monitor mutual-exclusion on entry. Pass through can be both generic helper routines (\code{swap}, \code{sort}, etc.) or specific helper routines like the following to implement an atomic counter :

\begin{lstlisting}
        mutex struct counter_t { /*...see section §\ref{data}§...*/ };

        void ?{}(counter_t & nomutex this); //constructor
        size_t ++?(counter_t & mutex this); //increment

        //need for mutex is platform dependent here
        void ?{}(size_t * this, counter_t & mutex cnt); //conversion
\end{lstlisting}

Here, the constructor(\code{?\{\}}) uses the \code{nomutex} keyword to signify that it does not acquire the monitor mutual exclusion when constructing. This semantics is because an object not yet constructed should never be shared and therefore does not require mutual exclusion. The prefix increment operator uses \code{mutex} to protect the incrementing process from race conditions. Finally, there is a conversion operator from \code{counter_t} to \code{size_t}. This conversion may or may not require the \code{mutex} key word depending on whether or not reading an \code{size_t} is an atomic operation or not.

Having both \code{mutex} and \code{nomutex} keywords could be argued to be redundant based on the meaning of a routine having neither of these keywords. For example, given a routine without quualifiers \code{void foo(counter_t & this)} then one could argue that it should default to the safest option \code{mutex}. On the other hand, the option of having routine \code{void foo(counter_t & this)} mean \code{nomutex} is unsafe by default and may easily cause subtle errors. It can be argued that \code{nomutex} is the more "normal" behaviour, the \code{nomutex} keyword effectively stating explicitly that "this routine has nothing special". Another alternative is to make having exactly one of these keywords mandatory, which would provide the same semantics but without the ambiguity of supporting routine \code{void foo(counter_t & this)}. Mandatory keywords would also have the added benefice of being self-documented but at the cost of extra typing. In the end, which solution should be picked is still up for debate. For the reminder of this proposal, the explicit approach is used for clarity.

The next semantic decision is to establish when mutex/nomutex may be used as a type qualifier. Consider the following declarations:
\begin{lstlisting}
        int f1(monitor & mutex m);
        int f2(const monitor & mutex m);
        int f3(monitor ** mutex m);
        int f4(monitor *[] mutex m);
        int f5(graph(monitor*) & mutex m);
\end{lstlisting}
The problem is to indentify which object(s) should be acquired. Furthermore, each object needs to be acquired only once. In the case of simple routines like \code{f1} and \code{f2} it is easy to identify an exhaustive list of objects to acquire on entry. Adding indirections (\code{f3}) still allows the compiler and programmer to indentify which object is acquired. However, adding in arrays (\code{f4}) makes it much harder. Array lengths are not necessarily known in C and even then making sure we only acquire objects once becomes also none trivial. This can be extended to absurd limits like \code{f5}, which uses a graph of monitors. To keep everyone as sane as possible~\cite{Chicken}, this projects imposes the requirement that a routine may only acquire one monitor per parameter and it must be the type of the parameter (ignoring potential qualifiers and indirections). Also note that while routine \code{f3} can be supported, meaning that monitor \code{**m} is be acquired, passing an array to this routine would be type safe and yet result in undefined behavior because only the first element of the array is acquired. However, this ambiguity is part of the C type system with respects to arrays. For this reason, it would also be reasonnable to disallow mutex in the context where arrays may be passed.

% ######     #    #######    #
% #     #   # #      #      # #
% #     #  #   #     #     #   #
% #     # #     #    #    #     #
% #     # #######    #    #######
% #     # #     #    #    #     #
% ######  #     #    #    #     #

\subsubsection{Data semantics} \label{data}
Once the call semantics are established, the next step is to establish data semantics. Indeed, until now a monitor is used simply as a generic handle but in most cases monitors contian shared data. This data should be intrinsic to the monitor declaration to prevent any accidental use of data without its appropriate protection. For example, here is a complete version of the counter showed in section \ref{call}:
\begin{lstlisting}
        mutex struct counter_t {
                int value;
        };

        void ?{}(counter_t & nomutex this) {
                this.cnt = 0;
        }

        int ++?(counter_t & mutex this) {
                return ++this.value;
        }

        //need for mutex is platform dependent here
        void ?{}(int * this, counter_t & mutex cnt) {
                *this = (int)cnt;
        }
\end{lstlisting}

This simple counter is used as follows:
\begin{center}
\begin{tabular}{c @{\hskip 0.35in} c @{\hskip 0.35in} c}
\begin{lstlisting}
        //shared counter
        counter_t cnt;

        //multiple threads access counter
        thread 1 : cnt++;
        thread 2 : cnt++;
        thread 3 : cnt++;
          ...
        thread N : cnt++;
\end{lstlisting}
\end{tabular}
\end{center}

Notice how the counter is used without any explicit synchronisation and yet supports thread-safe semantics for both reading and writting. Unlike object-oriented monitors, where calling a mutex member \emph{implicitly} acquires mutual-exclusion, \CFA uses an explicit mechanism to acquire mutual-exclusion. A consequence of this approach is that it extends to multi-monitor calls.
\begin{lstlisting}
        int f(MonitorA & mutex a, MonitorB & mutex b);

        MonitorA a;
        MonitorB b;
        f(a,b);
\end{lstlisting}
This code acquires both locks before entering the critical section, called \emph{\gls{group-acquire}}. In practice, writing multi-locking routines that do not lead to deadlocks is tricky. Having language support for such a feature is therefore a significant asset for \CFA. In the case presented above, \CFA guarantees that the order of aquisition is consistent across calls to routines using the same monitors as arguments. However, since \CFA monitors use multi-acquisition locks, users can effectively force the acquiring order. For example, notice which routines use \code{mutex}/\code{nomutex} and how this affects aquiring order :
\begin{lstlisting}
        void foo(A & mutex a, B & mutex b) { //acquire a & b
                //...
        }

        void bar(A & mutex a, B & nomutex b) { //acquire a
                //...
                foo(a, b); //acquire b
                //...
        }

        void baz(A & nomutex a, B & mutex b) { //acquire b
                //...
                foo(a, b); //acquire a
                //...
        }
\end{lstlisting}

The multi-acquisition monitor lock allows a monitor lock to be acquired by both \code{bar} or \code{baz} and acquired again in \code{foo}. In the calls to \code{bar} and \code{baz} the monitors are acquired in opposite order. such use leads to nested monitor call problems~\cite{Lister77}, which is a specific implementation of the lock acquiring order problem. In the example above, the user uses implicit ordering in the case of function \code{foo} but explicit ordering in the case of \code{bar} and \code{baz}. This subtle mistake means that calling these routines concurrently may lead to deadlock and is therefore undefined behavior. As shown on several occasion\cit, solving this problem requires :
\begin{enumerate}
        \item Dynamically tracking of the monitor-call order.
        \item Implement rollback semantics.
\end{enumerate}

While the first requirement is already a significant constraint on the system, implementing a general rollback semantics in a C-like language is prohibitively complex \cit. In \CFA, users simply need to be carefull when acquiring multiple monitors at the same time.

% ######  ####### #######    #    ### #        #####
% #     # #          #      # #    #  #       #     #
% #     # #          #     #   #   #  #       #
% #     # #####      #    #     #  #  #        #####
% #     # #          #    #######  #  #             #
% #     # #          #    #     #  #  #       #     #
% ######  #######    #    #     # ### #######  #####
%
%             ######  ####### #       #     # #     # ####### ######  #     #
%             #     # #     # #        #   #  ##   ## #     # #     # #     #
%             #     # #     # #         # #   # # # # #     # #     # #     #
%  #####    ######  #     # #          #    #  #  # #     # ######  #######
%             #       #     # #          #    #     # #     # #   #   #     #
%             #       #     # #          #    #     # #     # #    #  #     #
%             #       ####### #######    #    #     # ####### #     # #     #

\subsubsection{Implementation Details: Interaction with polymorphism}
At first glance, interaction between monitors and \CFA's concept of polymorphism seems complex to support. However, it is shown that entry-point locking can solve most of the issues.

Before looking into complex control flow, it is important to present the difference between the two acquiring options : \gls{callsite-locking} and \gls{entry-point-locking}, i.e. acquiring the monitors before making a mutex call or as the first instruction of the mutex call. For example:

\begin{center}
\begin{tabular}{|c|c|c|}
Code & \gls{callsite-locking} & \gls{entry-point-locking} \\
\CFA & pseudo-code & pseudo-code \\
\hline
\begin{lstlisting}
void foo(monitor & mutex a) {



        //Do Work
        //...

}

void main() {
        monitor a;



        foo(a);

}
\end{lstlisting} &\begin{lstlisting}
foo(& a) {



        //Do Work
        //...

}

main() {
        monitor a;
        //calling routine
        //handles concurrency
        acquire(a);
        foo(a);
        release(a);
}
\end{lstlisting} &\begin{lstlisting}
foo(& a) {
        //called routine
        //handles concurrency
        acquire(a);
        //Do Work
        //...
        release(a);
}

main() {
        monitor a;



        foo(a);

}
\end{lstlisting}
\end{tabular}
\end{center}

First of all, interaction between \code{otype} polymorphism and monitors is impossible since monitors do not support copying. Therefore, the main question is how to support \code{dtype} polymorphism. Since a monitor's main purpose is to ensure mutual exclusion when accessing shared data, this implies that mutual exclusion is only required for routines that do in fact access shared data. However, since \code{dtype} polymorphism always handles incomplete types (by definition), no \code{dtype} polymorphic routine can access shared data since the data requires knowledge about the type. Therefore, the only concern when combining \code{dtype} polymorphism and monitors is to protect access to routines. \Gls{callsite-locking} would require a significant amount of work, since any \code{dtype} routine may have to obtain some lock before calling a routine, depending on whether or not the type passed is a monitor. However, with \gls{entry-point-locking} calling a monitor routine becomes exactly the same as calling it from anywhere else.



% ### #     # #######         #####   #####  #     # ####### ######
%  #  ##    #    #           #     # #     # #     # #       #     #
%  #  # #   #    #           #       #       #     # #       #     #
%  #  #  #  #    #            #####  #       ####### #####   #     #
%  #  #   # #    #    ###          # #       #     # #       #     #
%  #  #    ##    #    ###    #     # #     # #     # #       #     #
% ### #     #    #    ###     #####   #####  #     # ####### ######

\subsection{Internal scheduling} \label{insched}

\begin{center}
\begin{tabular}{ c @{\hskip 0.65in} c }
\begin{lstlisting}[language=Pseudo]
acquire A
        wait A
release A
\end{lstlisting}&\begin{lstlisting}[language=Pseudo]
acquire A
        signal A
release A
\end{lstlisting}
\end{tabular}
\end{center}

Easy : like uC++

\begin{center}
\begin{tabular}{ c @{\hskip 0.65in} c }
\begin{lstlisting}[language=Pseudo]
acquire A
        acquire B
                wait B
        release B
release A
\end{lstlisting}&\begin{lstlisting}[language=Pseudo]
acquire A
        acquire B
                signal B
        release B
release A
\end{lstlisting}
\end{tabular}
\end{center}

Also easy : like uC++

\begin{center}
\begin{tabular}{ c @{\hskip 0.65in} c }
\begin{lstlisting}[language=Pseudo]
acquire A & B
        wait A & B
release A & B
\end{lstlisting}&\begin{lstlisting}[language=Pseudo]
acquire A & B
        signal A & B
release A & B
\end{lstlisting}
\end{tabular}
\end{center}

Simplest extension : can be made like uC++ by tying B to A

\begin{center}
\begin{tabular}{ c @{\hskip 0.65in} c }
\begin{lstlisting}[language=Pseudo]
acquire A
        // Code Section 1
        acquire B
                // Code Section 2
                wait A & B
                // Code Section 3
        release B
        // Code Section 4
release A
\end{lstlisting}&\begin{lstlisting}[language=Pseudo]
acquire A
        // Code Section 5
        acquire B
                // Code Section 6
                signal A & B
                // Code Section 7
        release B
        // Code Section 8
release A
\end{lstlisting}
\end{tabular}
\end{center}

Hard extension :

Incorrect options for the signal : 

\begin{description}
 \item[-] Release B and baton pass after Code Section 8 : Passing b without having it
 \item[-] Keep B during Code Section 8 : Can lead to deadlocks since we secretly keep a lock longer than specified by the user
 \item[-] Instead of release B transfer A and B to waiter then try to reacquire A before running Code Section 8 : This allows barging 
\end{description}

Since we don't want barging we need to pass A \& B and somehow block and get A back.

\begin{center}
\begin{tabular}{ c @{\hskip 0.65in} c }
\begin{lstlisting}[language=Pseudo]
acquire A
        acquire B
                acquire C
                        wait A & B & C
                1: release C
        2: release B
3: release A
\end{lstlisting}&\begin{lstlisting}[language=Pseudo]
acquire A
        acquire B
                acquire C
                        signal A & B & C
                4: release C
        5: release B
6: release A
\end{lstlisting}
\end{tabular}
\end{center}

To prevent barging :

\begin{description}
 \item[-] When the signaller hits 4 : pass A, B, C to waiter
 \item[-] When the waiter hits 2 : pass A, B to signaller
 \item[-] When the signaller hits 5 : pass A to waiter
\end{description}


\begin{center}
\begin{tabular}{ c @{\hskip 0.65in} c }
\begin{lstlisting}[language=Pseudo]
acquire A
        acquire C
                acquire B
                        wait A & B & C
                1: release B
        2: release C
3: release A
\end{lstlisting}&\begin{lstlisting}[language=Pseudo]
acquire B
        acquire A
                acquire C
                        signal A & B & C
                4: release C
        5: release A
6: release B
\end{lstlisting}
\end{tabular}
\end{center}

To prevent barging : When the signaller hits 4 : pass A, B, C to waiter. When the waiter hits 1 it must release B, 

\begin{description}
 \item[-] 
 \item[-] When the waiter hits 1 : pass A, B to signaller
 \item[-] When the signaller hits 5 : pass A, B to waiter
 \item[-] When the waiter hits 2 : pass A to signaller
\end{description}

% Monitors also need to schedule waiting threads internally as a mean of synchronization. Internal scheduling is one of the simple examples of such a feature. It allows users to declare condition variables and have threads wait and signaled from them. Here is a simple example of such a technique :

% \begin{lstlisting}
%       mutex struct A {
%               condition e;
%       }

%       void foo(A & mutex a) {
%               //...
%               wait(a.e);
%               //...
%       }

%       void bar(A & mutex a) {
%               signal(a.e);
%       }
% \end{lstlisting}

% Note that in \CFA, \code{condition} have no particular need to be stored inside a monitor, beyond any software engineering reasons. Here routine \code{foo} waits for the \code{signal} from \code{bar} before making further progress, effectively ensuring a basic ordering. 

% As for simple mutual exclusion, these semantics must also be extended to include \gls{group-acquire} :
% \begin{center}
% \begin{tabular}{ c @{\hskip 0.65in} c }
% Thread 1 & Thread 2 \\
% \begin{lstlisting}
% void foo(A & mutex a,
%            A & mutex b) {
%       //...
%       wait(a.e);
%       //...
% }

% foo(a, b);
% \end{lstlisting} &\begin{lstlisting}
% void bar(A & mutex a,
%            A & mutex b) {
%       signal(a.e);
% }



% bar(a, b);
% \end{lstlisting}
% \end{tabular}
% \end{center}

% To define the semantics of internal scheduling, it is important to look at nesting and \gls{group-acquire}. Indeed, beyond concerns about lock ordering, without scheduling the two following pseudo codes are mostly equivalent. In fact, if we assume monitors are ordered alphabetically, these two pseudo codes would probably lead to exactly the same implementation :

% \begin{table}[h!]
% \centering
% \begin{tabular}{c c}
% \begin{lstlisting}[language=pseudo]
% monitor A, B, C

% acquire A
%       acquire B & C

%                       //Do stuff

%       release B & C
% release A
% \end{lstlisting} &\begin{lstlisting}[language=pseudo]
% monitor A, B, C

% acquire A
%       acquire B
%               acquire C
%                       //Do stuff
%               release C
%       release B
% release A
% \end{lstlisting}
% \end{tabular}
% \end{table}

% Once internal scheduling is introduce however, semantics of \gls{group-acquire} become relevant. For example, let us look into the semantics of the following pseudo-code :

% \begin{lstlisting}[language=Pseudo]
% 1: monitor A, B, C
% 2: condition c1
% 3: 
% 4: acquire A
% 5:            acquire A & B & C
% 6:                            signal c1
% 7:            release A & B & C
% 8: release A
% \end{lstlisting}

% Without \gls{group-acquire} signal simply baton passes the monitor lock on the next release. In the case above, we therefore need to indentify the next release. If line 8 is picked at the release point, then the signal will attempt to pass A \& B \& C, without having ownership of B \& C. Since this violates mutual exclusion, we conclude that line 7 is the only valid location where signalling can occur. The traditionnal meaning of signalling is to transfer ownership of the monitor(s) and immediately schedule the longest waiting task. However, in the discussed case, the signalling thread expects to maintain ownership of monitor A. This can be expressed in two differents ways : 1) the thread transfers ownership of all locks and reacquires A when it gets schedulled again or 2) it transfers ownership of all three monitors and then expects the ownership of A to be transferred back. 

% However, the question is does these behavior motivate supporting acquireing non-disjoint set of monitors. Indeed, if the previous example was modified to only acquire B \& C at line 5 (an release the accordingly) then in respects to scheduling, we could add the simplifying constraint that all monitors in a bulk will behave the same way, simplifying the problem back to a single monitor problem which has already been solved. For this constraint to be acceptble however, we need to demonstrate that in does not prevent any meaningful possibilities. And, indeed, we can look at the two previous interpretation of the above pseudo-code and conclude that supporting the acquiring of non-disjoint set of monitors does not add any expressiveness to the language.

% Option 1 reacquires the lock after the signal statement, this can be rewritten as follows without the need for non-disjoint sets :
% \begin{lstlisting}[language=Pseudo]
% monitor A, B, C
% condition c1

% acquire A & B & C
%       signal c1
% release A & B & C
% acquire A

% release A
% \end{lstlisting}

% This pseudo code has almost exaclty the same semantics as the code acquiring intersecting sets of monitors. 

% Option 2 uses two-way lock ownership transferring instead of reacquiring monitor A. Two-way monitor ownership transfer is normally done using signalBlock semantics, which immedietely transfers ownership of a monitor before getting the ownership back when the other thread no longer needs the monitor. While the example pseudo-code for Option 2 seems toe transfer ownership of A, B and C and only getting A back, this is not a requirement. Getting back all 3 monitors and releasing B and C differs only in performance. For this reason, the second option could arguably be rewritten as : 

% \begin{lstlisting}[language=Pseudo]
% monitor A, B, C
% condition c1

% acquire A
%       acquire B & C
%               signalBlock c1
%       release B & C
% release A
% \end{lstlisting}

% Obviously, the difference between these two snippets of pseudo code is that the first one transfers ownership of A, B and C while the second one only transfers ownership of B and C. However, this limitation can be removed by allowing user to release extra monitors when using internal scheduling, referred to as extended internal scheduling (pattent pending) from this point on. Extended internal scheduling means the two following pseudo-codes are functionnaly equivalent : 
% \begin{table}[h!]
% \centering
% \begin{tabular}{c @{\hskip 0.65in} c}
% \begin{lstlisting}[language=pseudo]
% monitor A, B, C
% condition c1

% acquire A
%       acquire B & C
%               signalBlock c1 with A
%       release B & C
% release A
% \end{lstlisting} &\begin{lstlisting}[language=pseudo]
% monitor A, B, C
% condition c1

% acquire A
%       acquire A & B & C
%               signal c1
%       release A & B & C
% release A
% \end{lstlisting}
% \end{tabular}
% \end{table}

% It must be stated that the extended internal scheduling only makes sense when using wait and signalBlock, since they need to prevent barging, which cannot be done in the context of signal since the ownership transfer is strictly one-directionnal. 

% One critic that could arise is that extended internal schedulling is not composable since signalBlock must be explicitly aware of which context it is in. However, this argument is not relevant since acquire A, B and C in a context where a subset of them is already acquired cannot be achieved without spurriously releasing some locks or having an oracle aware of all monitors. Therefore, composability of internal scheduling is no more an issue than composability of monitors in general.

% The main benefit of using extended internal scheduling is that it offers the same expressiveness as intersecting monitor set acquiring but greatly simplifies the selection of a leader (or representative) for a group of monitor. Indeed, when using intersecting sets, it is not obvious which set intersects with other sets which means finding a leader representing only the smallest scope is a hard problem. Where as when using disjoint sets, any monitor that would be intersecting must be specified in the extended set, the leader can be chosen as any monitor in the primary set.

% We need to make sure the semantics for internally scheduling N monitors are a natural extension of the single monitor semantics. For this reason, we introduce the concept of \gls{mon-ctx}. In terms of context internal scheduling means "releasing a \gls{mon-ctx} and waiting for an other thread to acquire the same \gls{mon-ctx} and baton-pass it back to the initial thread". This definitions requires looking into what a \gls{mon-ctx} is and what the semantics of waiting and baton-passing are.

% \subsubsection{Internal scheduling: Context} \label{insched-context}
% Monitor scheduling operations are defined in terms of the context they are in. In languages that only supports operations on a single monitor at once, the context is completly defined by which most recently acquired monitors. Indeed, acquiring several monitors will form a stack of monitors which will be released in FILO order. In \CFA, a \gls{mon-ctx} cannot be simply defined by the last monitor that was acquired since \gls{group-acquire} means multiple monitors can be "the last monitor acquired". The \gls{mon-ctx} is therefore defined as the last set of monitors to have been acquired. This means taht when any new monitor is acquired, the group it belongs to is the new \gls{mon-ctx}. Correspondingly, if any monitor is released, the \gls{mon-ctx} reverts back to the context that was used prior to the monitor being acquired. In the most common case, \gls{group-acquire} means every monitor of a group will be acquired in released at the same time. However, since every monitor has its own recursion level, \gls{group-acquire} does not prevent users from reacquiring certain monitors while acquireing new monitors in the same operation. For example :

% \begin{lstlisting}
% //Forward declarations
% monitor a, b, c
% void foo( monitor & mutex a, 
%             monitor & mutex b);
% void bar( monitor & mutex a, 
%             monitor & mutex b);
% void baz( monitor & mutex a, 
%             monitor & mutex b, 
%             monitor & mutex c);

% //Routines defined inline to illustrate context changed compared to the stack

% //main thread
% foo(a, b) {
%       //thread calls foo
%       //acquiring context a & b

%       baz(a, b) {
%               //thread calls baz
%               //no context change

%               bar(a, b, c) {
%                       //thread calls bar
%                       //acquiring context a & b & c

%                       //Do stuff

%                       return;              
%                       //call to bar returns
%               }
%               //context back to a & b

%               return;
%               //call to baz returns
%       }
%       //no context change

%       return;
%       //call to foo returns
% }
% //context back to initial state

% \end{lstlisting}

% As illustrated by the previous example, context changes can be caused by only one of the monitors comming into context or going out of context.

% \subsubsection{Internal scheduling: Waiting} \label{insched-wait}

% \subsubsection{Internal scheduling: Baton Passing} \label{insched-signal}
% Baton passing in internal scheduling is done in terms of \code{signal} and \code{signalBlock}\footnote{Arguably, \code{signal_now} is a more evocative name and \code{signal} could be changed appropriately. }. While \code{signalBlock} is the more straight forward way of baton passing, transferring ownership immediately, it must rely on \code{signal} which is why t is discussed first.
% \code{signal} has for effect to transfer the current context to another thread when the context would otherwise be released. This means that instead of releasing the concerned monitors, the first thread on the condition ready-queue is scheduled to run. The monitors are not released and when the signalled thread runs, it assumes it regained ownership of all the monitors it had in its context.

% \subsubsection{Internal scheduling: Implementation} \label{insched-impl}
% Too implement internal scheduling, three things are need : a data structure for waiting tasks, a data structure for signalled task and a leaving procedure to run the signalled task. In the case of both data structures, it is desireable to have to use intrusive data structures in order to prevent the need for any dynamic allocation. However, in both cases being able to queue several items in the same position in a queue is non trivial, even more so in the presence of concurrency. However, within a given \gls{mon-ctx}, all monitors have exactly the same behavior in regards to scheduling. Therefore, the problem of queuing multiple monitors at once can be ignored by choosing one monitor to represent every monitor in a context. While this could prove difficult in other situations, \gls{group-acquire} requires that the monitors be sorted according to some stable predicate. Since monitors are sorted in all contexts, the representative can simply be the first in the list. Choosing a representative means a simple intrusive queue inside the condition is sufficient to implement the data structure for both waiting and signalled monitors. 

% Since \CFA monitors don't have a complete image of the \gls{mon-ctx}, choosing the representative and maintaning the current context information cannot easily be done by any single monitors. However, as discussed in section [Missing section here], monitor mutual exclusion is implemented using an raii object which is already in charge of sorting monitors. This object has a complete picture of the \gls{mon-ctx} which means it is well suited to choose the reprensentative and detect context changes. 

% \newpage
% \begin{lstlisting}
% void ctor( monitor ** _monitors, int _count ) {
%       bool ctx_changed = false;
%       for( mon in _monitors ) {
%               ctx_changed = acquire( mon ) || ctx_changed;
%       }

%       if( ctx_changed ) {
%               set_representative();
%               set_context();
%       }
% }

% void dtor( monitor ** _monitors, int _count ) {
%       if( context_will_exit( _monitors, count ) ) {
%               baton_pass();
%               return;
%       }

%       for( mon in _monitors ) {
%               release( mon );
%       }
% }

% \end{lstlisting}



% A direct extension of the single monitor semantics is to release all locks when waiting and transferring ownership of all locks when signalling. However, for the purpose of synchronization it may be usefull to only release some of the locks but keep others. It is possible to support internal scheduling and \gls{group-acquire} without any extra syntax by relying on order of acquisition. Here is an example of the different contexts in which internal scheduling can be used. (Note that here the use of helper routines is irrelevant, only routines acquire mutual exclusion have an impact on internal scheduling):

% \begin{table}[h!]
% \centering
% \begin{tabular}{|c|c|c|}
% Context 1 & Context 2 & Context 3 \\
% \hline
% \begin{lstlisting}
% condition e;

% //acquire a & b
% void foo(monitor & mutex a,
%            monitor & mutex b) {

%       wait(e); //release a & b
% }






% foo(a,b);
% \end{lstlisting} &\begin{lstlisting}
% condition e;

% //acquire a
% void bar(monitor & mutex a,
%            monitor & nomutex b) {
%       foo(a,b);
% }

% //acquire a & b
% void foo(monitor & mutex a,
%            monitor & mutex b) {
%       wait(e);  //release a & b
% }

% bar(a, b);
% \end{lstlisting} &\begin{lstlisting}
% condition e;

% //acquire a
% void bar(monitor & mutex a,
%            monitor & nomutex b) {
%       baz(a,b);
% }

% //acquire b
% void baz(monitor & nomutex a,
%            monitor & mutex b) {
%       wait(e);  //release b
% }

% bar(a, b);
% \end{lstlisting}
% \end{tabular}
% \end{table}

% Context 1 is the simplest way of acquiring more than one monitor (\gls{group-acquire}), using a routine with multiple parameters having the \code{mutex} keyword. Context 2 also uses \gls{group-acquire} as well in routine \code{foo}. However, the routine is called by routine \code{bar}, which only acquires monitor \code{a}. Since monitors can be acquired multiple times this does not cause a deadlock by itself but it does force the acquiring order to \code{a} then \code{b}. Context 3 also forces the acquiring order to be \code{a} then \code{b} but does not use \gls{group-acquire}. The previous example tries to illustrate the semantics that must be established to support releasing monitors in a \code{wait} statement. In all cases, the behavior of the wait statment is to release all the locks that were acquired my the inner-most monitor call. That is \code{a & b} in context 1 and 2 and \code{b} only in context 3. Here are a few other examples of this behavior.


% \begin{center}
% \begin{tabular}{|c|c|c|}
% \begin{lstlisting}
% condition e;

% //acquire b
% void foo(monitor & nomutex a,
%            monitor & mutex b) {
%       bar(a,b);
% }

% //acquire a
% void bar(monitor & mutex a,
%            monitor & nomutex b) {

%       wait(e); //release a
%                 //keep b
% }

% foo(a, b);
% \end{lstlisting} &\begin{lstlisting}
% condition e;

% //acquire a & b
% void foo(monitor & mutex a,
%            monitor & mutex b) {
%       bar(a,b);
% }

% //acquire b
% void bar(monitor & mutex a,
%            monitor & nomutex b) {

%       wait(e); //release b
%                 //keep a
% }

% foo(a, b);
% \end{lstlisting} &\begin{lstlisting}
% condition e;

% //acquire a & b
% void foo(monitor & mutex a,
%            monitor & mutex b) {
%       bar(a,b);
% }

% //acquire none
% void bar(monitor & nomutex a,
%            monitor & nomutex b) {

%       wait(e); //release a & b
%                 //keep none
% }

% foo(a, b);
% \end{lstlisting}
% \end{tabular}
% \end{center}
% Note the right-most example is actually a trick pulled on the reader. Monitor state information is stored in thread local storage rather then in the routine context, which means that helper routines and other \code{nomutex} routines are invisible to the runtime system in regards to concurrency. This means that in the right-most example, the routine parameters are completly unnecessary. However, calling this routine from outside a valid monitor context is undefined.

% These semantics imply that in order to release of subset of the monitors currently held, users must write (and name) a routine that only acquires the desired subset and simply calls wait. While users can use this method, \CFA offers the \code{wait_release}\footnote{Not sure if an overload of \code{wait} would work...} which will release only the specified monitors. In the center previous examples, the code in the center uses the \code{bar} routine to only release monitor \code{b}. Using the \code{wait_release} helper, this can be rewritten without having the name two routines :
% \begin{center}
% \begin{tabular}{ c c c }
% \begin{lstlisting}
%       condition e;

%       //acquire a & b
%       void foo(monitor & mutex a,
%                  monitor & mutex b) {
%               bar(a,b);
%       }

%       //acquire b
%       void bar(monitor & mutex a,
%                  monitor & nomutex b) {

%               wait(e); //release b
%                         //keep a
%       }

%       foo(a, b);
% \end{lstlisting} &\begin{lstlisting}
%       =>
% \end{lstlisting} &\begin{lstlisting}
%       condition e;

%       //acquire a & b
%       void foo(monitor & mutex a,
%                  monitor & mutex b) {
%               wait_release(e,b); //release b
%                                        //keep a
%       }

%       foo(a, b);
% \end{lstlisting}
% \end{tabular}
% \end{center}

% Regardless of the context in which the \code{wait} statement is used, \code{signal} must be called holding the same set of monitors. In all cases, signal only needs a single parameter, the condition variable that needs to be signalled. But \code{signal} needs to be called from the same monitor(s) that call to \code{wait}. Otherwise, mutual exclusion cannot be properly transferred back to the waiting monitor.

% Finally, an additional semantic which can be very usefull is the \code{signal_block} routine. This routine behaves like signal for all of the semantics discussed above, but with the subtelty that mutual exclusion is transferred to the waiting task immediately rather than wating for the end of the critical section.
% \\

% ####### #     # #######         #####   #####  #     # ####### ######
% #        #   #     #           #     # #     # #     # #       #     #
% #         # #      #           #       #       #     # #       #     #
% #####      #       #            #####  #       ####### #####   #     #
% #         # #      #    ###          # #       #     # #       #     #
% #        #   #     #    ###    #     # #     # #     # #       #     #
% ####### #     #    #    ###     #####   #####  #     # ####### ######
\newpage
\subsection{External scheduling} \label{extsched}
An alternative to internal scheduling is to use external scheduling instead. This method is more constrained and explicit which may help users tone down the undeterministic nature of concurrency. Indeed, as the following examples demonstrates, external scheduling allows users to wait for events from other threads without the concern of unrelated events occuring. External scheduling can generally be done either in terms of control flow (ex: \uC) or in terms of data (ex: Go). Of course, both of these paradigms have their own strenghts and weaknesses but for this project control flow semantics where chosen to stay consistent with the rest of the languages semantics. Two challenges specific to \CFA arise when trying to add external scheduling with loose object definitions and multi-monitor routines. The following example shows a simple use \code{accept} versus \code{wait}/\code{signal} and its advantages.

\begin{center}
\begin{tabular}{|c|c|}
Internal Scheduling & External Scheduling \\
\hline
\begin{lstlisting}
        _Monitor blarg {
                condition c;
        public:
                void f() { signal(c)}
                void g() { wait(c); }
        private:
        }
\end{lstlisting}&\begin{lstlisting}
        _Monitor blarg {

        public:
                void f() { /*...*/ }
                void g() { _Accept(f); }
        private:
        }
\end{lstlisting}
\end{tabular}
\end{center}

In the case of internal scheduling, the call to \code{wait} only guarantees that \code{g} is the last routine to access the monitor. This intails that the routine \code{f} may have acquired mutual exclusion several times while routine \code{h} was waiting. On the other hand, external scheduling guarantees that while routine \code{h} was waiting, no routine other than \code{g} could acquire the monitor.
\\

% #       ####### #######  #####  #######    ####### ######        #  #####
% #       #     # #     # #     # #          #     # #     #       # #     #
% #       #     # #     # #       #          #     # #     #       # #
% #       #     # #     #  #####  #####      #     # ######        #  #####
% #       #     # #     #       # #          #     # #     # #     #       #
% #       #     # #     # #     # #          #     # #     # #     # #     #
% ####### ####### #######  #####  #######    ####### ######   #####   #####

\subsubsection{Loose object definitions}
In \uC, monitor declarations include an exhaustive list of monitor operations. Since \CFA is not object oriented it becomes both more difficult to implement but also less clear for the user :

\begin{lstlisting}
        mutex struct A {};

        void f(A & mutex a);
        void g(A & mutex a) { accept(f); }
\end{lstlisting}

However, external scheduling is an example where implementation constraints become visible from the interface. Indeed, ince there is no hard limit to the number of threads trying to acquire a monitor concurrently, performance is a significant concern. Here is the pseudo code for the entering phase of a monitor :

\begin{center}
\begin{tabular}{l}
\begin{lstlisting}[language=Pseudo]
        if monitor is free :
                enter
        elif monitor accepts me :
                enter
        else :
                block
\end{lstlisting}
\end{tabular}
\end{center}

For the \pseudo{monitor is free} condition it is easy to implement a check that can evaluate the condition in a few instruction. However, a fast check for \pseudo{monitor accepts me} is much harder to implement depending on the constraints put on the monitors. Indeed, monitors are often expressed as an entry queue and some acceptor queue as in the following figure :

\begin{center}
{\resizebox{0.4\textwidth}{!}{\input{monitor}}}
\end{center}

There are other alternatives to these pictures but in the case of this picture implementing a fast accept check is relatively easy. Indeed simply updating a bitmask when the acceptor queue changes is enough to have a check that executes in a single instruction, even with a fairly large number of acceptor. However, this relies on the fact that all the acceptable routines are declared with the monitor type. For OO languages this doesn't compromise much since monitors already have an exhaustive list of member routines. However, for \CFA this isn't the case, routines can be added to a type anywhere after its declaration. Its important to note that the bitmask approach does not actually require an exhaustive list of routines, but it requires a dense unique ordering of routines with an upper-bound and that ordering must be consistent across translation units.
The alternative would be to have a picture more like this one:

\begin{center}
{\resizebox{0.4\textwidth}{!}{\input{ext_monitor}}}
\end{center}

Not storing the queues inside the monitor means that the storage can vary between routines, allowing for more flexibility and extensions. Storing an array of function-pointers would solve the issue of uniquely identifying acceptable routines. However, the single instruction bitmask compare has been replaced by dereferencing a pointer followed by a linear search. Furthermore, supporting nested external scheduling may now require additionnal searches on calls to accept to check if a routine is already queued in.

At this point we must make a decision between flexibility and performance. Many design decisions in \CFA achieve both flexibility and performance, for example polymorphic routines add significant flexibility but inlining them means the optimizer can easily remove any runtime cost. Here however, the cost of flexibility cannot be trivially removed.

In either cases here are a few alternatives for the different syntaxes this syntax : \\
\begin{center}
{\renewcommand{\arraystretch}{1.5}
\begin{tabular}[t]{l @{\hskip 0.35in} l}
\hline
\multicolumn{2}{ c }{\code{accept} on type}\\
\hline
Alternative 1 & Alternative 2 \\
\begin{lstlisting}
mutex struct A
accept( void f(A & mutex a) )
{};
\end{lstlisting} &\begin{lstlisting}
mutex struct A {}
accept( void f(A & mutex a) );

\end{lstlisting} \\
Alternative 3 & Alternative 4 \\
\begin{lstlisting}
mutex struct A {
        accept( void f(A & mutex a) )
};

\end{lstlisting} &\begin{lstlisting}
mutex struct A {
        accept :
                void f(A & mutex a) );
};
\end{lstlisting}\\
\hline
\multicolumn{2}{ c }{\code{accept} on routine}\\
\hline
\begin{lstlisting}
mutex struct A {};

void f(A & mutex a)

accept( void f(A & mutex a) )
void g(A & mutex a) {
        /*...*/
}
\end{lstlisting}&\\
\end{tabular}
}
\end{center}

An other aspect to consider is what happens if multiple overloads of the same routine are used. For the time being it is assumed that multiple overloads of the same routine should be scheduled regardless of the overload used. However, this could easily be extended in the future.

% #     # #     # #       ####### ###    #     # ####### #     #
% ##   ## #     # #          #     #     ##   ## #     # ##    #
% # # # # #     # #          #     #     # # # # #     # # #   #
% #  #  # #     # #          #     #     #  #  # #     # #  #  #
% #     # #     # #          #     #     #     # #     # #   # #
% #     # #     # #          #     #     #     # #     # #    ##
% #     #  #####  #######    #    ###    #     # ####### #     #

\subsubsection{Multi-monitor scheduling}

External scheduling, like internal scheduling, becomes orders of magnitude more complex when we start introducing multi-monitor syntax. Even in the simplest possible case some new semantics need to be established :
\begin{lstlisting}
        accept( void f(mutex struct A & mutex this))
        mutex struct A {};

        mutex struct B {};

        void g(A & mutex a, B & mutex b) {
                accept(f); //ambiguous, which monitor
        }
\end{lstlisting}

The obvious solution is to specify the correct monitor as follows :

\begin{lstlisting}
        accept( void f(mutex struct A & mutex this))
        mutex struct A {};

        mutex struct B {};

        void g(A & mutex a, B & mutex b) {
                accept( f, b );
        }
\end{lstlisting}

This is unambiguous. Both locks will be acquired and kept, when routine \code{f} is called the lock for monitor \code{a} will be temporarily transferred from \code{g} to \code{f} (while \code{g} still holds lock \code{b}). This behavior can be extended to multi-monitor accept statment as follows.

\begin{lstlisting}
        accept( void f(mutex struct A & mutex, mutex struct A & mutex))
        mutex struct A {};

        mutex struct B {};

        void g(A & mutex a, B & mutex b) {
                accept( f, b, a );
        }
\end{lstlisting}

Note that the set of monitors passed to the \code{accept} statement must be entirely contained in the set of monitor already acquired in the routine. \code{accept} used in any other context is Undefined Behaviour.

% ######  ####### #######    #    ### #        #####
% #     # #          #      # #    #  #       #     #
% #     # #          #     #   #   #  #       #
% #     # #####      #    #     #  #  #        #####
% #     # #          #    #######  #  #             #
% #     # #          #    #     #  #  #       #     #
% ######  #######    #    #     # ### #######  #####
%
%                #####  #     # ####### #     # #######  #####
%             #     # #     # #       #     # #       #     #
%             #     # #     # #       #     # #       #
%    #####    #     # #     # #####   #     # #####    #####
%             #   # # #     # #       #     # #             #
%             #    #  #     # #       #     # #       #     #
%                #### #  #####  #######  #####  #######  #####


\subsubsection{Implementation Details: External scheduling queues}
To support multi-monitor external scheduling means that some kind of entry-queues must be used that is aware of both monitors. However, acceptable routines must be aware of the entry queues which means they must be stored inside at least one of the monitors that will be acquired. This in turn adds the requirement a systematic algorithm of disambiguating which queue is relavant regardless of user ordering. The proposed algorithm is to fall back on monitors lock ordering and specify that the monitor that is acquired first is the lock with the relevant entry queue. This assumes that the lock acquiring order is static for the lifetime of all concerned objects but that is a reasonnable constraint. This algorithm choice has two consequences, the entry queue of the highest priority monitor is no longer a true FIFO queue and the queue of the lowest priority monitor is both required and probably unused. The queue can no longer be a FIFO queue because instead of simply containing the waiting threads in order arrival, they also contain the second mutex. Therefore, another thread with the same highest priority monitor but a different lowest priority monitor may arrive first but enter the critical section after a thread with the correct pairing. Secondly, since it may not be known at compile time which monitor will be the lowest priority monitor, every monitor needs to have the correct queues even though it is probable that half the multi-monitor queues will go unused for the entire duration of the program.

\subsection{Other concurrency tools}
TO BE CONTINUED...










\newpage
% ######     #    ######     #    #       #       ####### #       ###  #####  #     #
% #     #   # #   #     #   # #   #       #       #       #        #  #     # ##   ##
% #     #  #   #  #     #  #   #  #       #       #       #        #  #       # # # #
% ######  #     # ######  #     # #       #       #####   #        #   #####  #  #  #
% #       ####### #   #   ####### #       #       #       #        #        # #     #
% #       #     # #    #  #     # #       #       #       #        #  #     # #     #
% #       #     # #     # #     # ####### ####### ####### ####### ###  #####  #     #
\section{Parallelism}
Historically, computer performance was about processor speeds and instructions count. However, with heat dissipation being a direct consequence of speed increase, parallelism has become the new source for increased performance~\cite{Sutter05, Sutter05b}. In this decade, it is not longer reasonnable to create a high-performance application without caring about parallelism. Indeed, parallelism is an important aspect of performance and more specifically throughput and hardware utilization. The lowest-level approach of parallelism is to use \glspl{kthread} in combination with semantics like \code{fork}, \code{join}, etc. However, since these have significant costs and limitations, \glspl{kthread} are now mostly used as an implementation tool rather than a user oriented one. There are several alternatives to solve these issues that all have strengths and weaknesses. While there are many variations of the presented paradigms, most of these variations do not actually change the guarantees or the semantics, they simply move costs in order to achieve better performance for certain workloads.

\subsection{User-level threads}
A direct improvement on the \gls{kthread} approach is to use \glspl{uthread}. These threads offer most of the same features that the operating system already provide but can be used on a much larger scale. This approach is the most powerfull solution as it allows all the features of multi-threading, while removing several of the more expensives costs of using kernel threads. The down side is that almost none of the low-level threading problems are hidden, users still have to think about data races, deadlocks and synchronization issues. These issues can be somewhat alleviated by a concurrency toolkit with strong garantees but the parallelism toolkit offers very little to reduce complexity in itself.

Examples of languages that support \glspl{uthread} are Erlang~\cite{Erlang} and \uC~\cite{uC++book}.

\subsubsection{Fibers : user-level threads without preemption}
A popular varient of \glspl{uthread} is what is often reffered to as \glspl{fiber}. However, \glspl{fiber} do not present meaningful semantical differences with \glspl{uthread}. Advocates of \glspl{fiber} list their high performance and ease of implementation as majors strenghts of \glspl{fiber} but the performance difference between \glspl{uthread} and \glspl{fiber} is controversial and the ease of implementation, while true, is a weak argument in the context of language design. Therefore this proposal largely ignore fibers.

An example of a language that uses fibers is Go~\cite{Go}

\subsection{Jobs and thread pools}
The approach on the opposite end of the spectrum is to base parallelism on \glspl{pool}. Indeed, \glspl{pool} offer limited flexibility but at the benefit of a simpler user interface. In \gls{pool} based systems, users express parallelism as units of work and a dependency graph (either explicit or implicit) that tie them together. This approach means users need not worry about concurrency but significantly limits the interaction that can occur among jobs. Indeed, any \gls{job} that blocks also blocks the underlying worker, which effectively means the CPU utilization, and therefore throughput, suffers noticeably. It can be argued that a solution to this problem is to use more workers than available cores. However, unless the number of jobs and the number of workers are comparable, having a significant amount of blocked jobs always results in idles cores.

The gold standard of this implementation is Intel's TBB library~\cite{TBB}.

\subsection{Paradigm performance}
While the choice between the three paradigms listed above may have significant performance implication, it is difficult to pindown the performance implications of chosing a model at the language level. Indeed, in many situations one of these paradigms may show better performance but it all strongly depends on the workload. Having a large amount of mostly independent units of work to execute almost guarantess that the \gls{pool} based system has the best performance thanks to the lower memory overhead. However, interactions between jobs can easily exacerbate contention. User-level threads allow fine-grain context switching, which results in better resource utilisation, but context switches will be more expansive and the extra control means users need to tweak more variables to get the desired performance. Furthermore, if the units of uninterrupted work are large enough the paradigm choice is largely amorticised by the actual work done.

%  #####  #######    #          ####### ######  ######
% #     # #         # #            #    #     # #     #
% #       #        #   #           #    #     # #     #
% #       #####   #     # #####    #    ######  ######
% #       #       #######          #    #     # #     #
% #     # #       #     #          #    #     # #     #
%  #####  #       #     #          #    ######  ######

\section{\CFA 's Thread Building Blocks}
As a system-level language, \CFA should offer both performance and flexibilty as its primary goals, simplicity and user-friendliness being a secondary concern. Therefore, the core of parallelism in \CFA should prioritize power and efficiency. With this said, deconstructing popular paradigms in order to get simple building blocks yields \glspl{uthread} as the core parallelism block. \Glspl{pool} and other parallelism paradigms can then be built on top of the underlying threading model.

\subsection{Coroutines : A stepping stone}\label{coroutine}
While the main focus of this proposal is concurrency and paralellism, it is important to adress coroutines which are actually a significant underlying aspect of the concurrency system. Indeed, while having nothing todo with parallelism and arguably very little to do with concurrency, coroutines need to deal with context-switchs and and other context management operations. Therefore, this proposal includes coroutines both as an intermediate step for the implementation of threads and a first class feature of \CFA.

The core API of coroutines revolve around two features : independent stacks and \code{suspend}/\code{resume}.
Here is an example of a solution to the fibonnaci problem using \CFA coroutines :
\begin{lstlisting}
        struct Fibonacci {
              int fn; // used for communication
              coroutine_descriptor c;
        };

        void ?{}(Fibonacci* this) {
              this->fn = 0;
        }

        coroutine_descriptor* get_¶coroutine¶(Fibonacci* this) {
              return &this->c;
        }

        void co_main(Fibonacci* this) {
                int fn1, fn2;           // retained between resumes
                this->fn = 0;
                fn1 = this->fn;
                suspend(this);          // return to last resume

                this->fn = 1;
                fn2 = fn1;
                fn1 = this->fn;
                suspend(this);          // return to last resume

                for ( ;; ) {
                        this->fn = fn1 + fn2;
                        fn2 = fn1;
                        fn1 = this->fn;
                        suspend(this);  // return to last resume
                }
        }

        int next(Fibonacci* this) {
                resume(this); // transfer to last suspend
                return this.fn;
        }

        void main() {
                Fibonacci f1, f2;
                for ( int i = 1; i <= 10; i += 1 ) {
                        sout | next(&f1) | '§\verb+ +§' | next(&f2) | endl;
                }
        }
\end{lstlisting}

\subsubsection{Construction}
One important design challenge for coroutines and threads (shown in section \ref{threads}) is that the runtime system needs to run some code after the user-constructor runs. In the case of the coroutines this challenge is simpler since there is no loss of determinism brough by preemption or scheduling, however, the underlying challenge remains the same for coroutines and threads.

The runtime system needs to create the coroutine's stack and more importantly prepare it for the first resumption. The timing of the creation is non trivial since users both expect to have fully constructed objects once the main is called and to be able to resume the coroutine from the main (Obviously we only solve cases where these two statements don't conflict). There are several solutions to this problem but the chosen options effectively forces the design of the coroutine.

Furthermore, \CFA faces an extra challenge which is that polymorphique routines rely on invisible thunks when casted to non-polymorphic routines and these thunks have function scope, for example :

TODO : Simple case where a thunk would be created.



\subsubsection{Alternative: Inheritance}
One solution to this challenge would be to use inheritence,

\begin{lstlisting}
        struct Fibonacci {
              int fn; // used for communication
              coroutine c;
        };

        void ?{}(Fibonacci* this) {
              this->fn = 0;
                (&this->c){};
        }
\end{lstlisting}

There are two downsides to the approach. The first, which is relatively minor, is that the base class needs to be made aware of the main routine pointer, regardless of whether we use a parameter or a virtual pointer, this means the coroutine data must be made larger to store a value that is actually a compile time constant (The address of the main routine). The second problem which is both subtle but significant, is that now can get the initialisation order of there coroutines wrong. Indeed, every field of a \CFA struct will be constructed but in the order of declaration, unless users explicitly write otherwise. This means that users who forget to initialize a the coroutine at the right time may resume the coroutine at with an uninitilized object. For coroutines, this is unlikely to be a problem, for threads however, this is a significant problem.

\subsubsection{Alternative: Reserved keyword}
The next alternative is to use language support to annotate coroutines as follows :

\begin{lstlisting}
        coroutine struct Fibonacci {
              int fn; // used for communication
        };
\end{lstlisting}

This mean the compiler can solve problems by injecting code where needed. The downside of this approach is that it makes coroutine a special case in the language. Users who would want to extend coroutines or build their own for various reasons can only do so in ways offered by the language. Furthermore, implementing coroutines without language supports also displays the power of \CFA.

\subsubsection{Alternative: Lamda Objects}

Boost does not use objects...
TO BE CONTINUED...

\subsubsection{Trait based coroutines}

Finally the approach chosen, which is the one closest to \CFA idioms, is to use trait-based lazy coroutines, the approach shown in section \ref{coroutine}. This approach defines a coroutine as anything that satisfies the \code{is_coroutine} and is used as a coroutine is a coroutine. This entails the an object is not a coroutine until \code{resume} (and \code{prime}) is called on the object. Correspondingly, any object that is passed to \code{resume} is a coroutine since it must satisfy the \code{is_coroutine} trait to compile.

% ####### #     # ######  #######    #    ######   #####
%    #    #     # #     # #         # #   #     # #     #
%    #    #     # #     # #        #   #  #     # #
%    #    ####### ######  #####   #     # #     #  #####
%    #    #     # #   #   #       ####### #     #       #
%    #    #     # #    #  #       #     # #     # #     #
%    #    #     # #     # ####### #     # ######   #####

\subsection{Thread Interface}\label{threads}
The basic building blocks of \CFA are \glspl{cfathread}. By default these are implemented as \glspl{uthread}, and as such, offer a flexible and lightweight threading interface (lightweight compared to \glspl{kthread}). A thread can be declared using a struct declaration with prefix \code{thread} as follows :

\begin{lstlisting}
        trait is_¶thread¶(dtype T) {
                void co_main(T* this);
                coroutine* get_coroutine(T* this);
        };

        thread struct foo {};
\end{lstlisting}

Obviously, for this thread implementation to be usefull it must run some user code. Several other threading interfaces use a function-pointer representation as the interface of threads (for example : \Csharp~\cite{Csharp} and Scala~\cite{Scala}). However, this proposal considers that statically tying a \code{main} routine to a thread superseeds this approach. Since the \code{main} routine is already a special routine in \CFA (where the program begins), the existing syntax for declaring routines names with special semantics can be extended, i.e. operator overloading. As such the \code{main} routine of a thread can be defined as :
\begin{lstlisting}
        thread struct foo {};

        void ?main(foo* this) {
                sout | "Hello World!" | endl;
        }
\end{lstlisting}

In this example, threads of type \code{foo} will start there execution in the \code{void ?main(foo*)} routine which in this case prints \code{"Hello World!"}. While this proposoal encourages this approach which is enforces strongly type programming. Users may prefer to use the routine based thread semantics for the sake of simplicity. With these semantics it is trivial to write a thread type that takes a function pointer as parameter and executes it on its stack asynchronously :
\begin{lstlisting}
        typedef void (*voidFunc)(void);

        thread struct FuncRunner {
                voidFunc func;
        };

        //ctor
        void ?{}(FuncRunner* this, voidFunc inFunc) {
                func = inFunc;
        }

        //main
        void t_main(FuncRunner* this) {
                this->func();
        }
\end{lstlisting}

Of course for threads to be useful, it must be possible to start and stop threads and wait for them to complete execution. While using an \acrshort{api} such as \code{fork} and \code{join} is relatively common in the literature, such an interface is unnecessary. Indeed, the simplest approach is to use \acrshort{raii} principles and have threads \code{fork} once the constructor has completed and \code{join} before the destructor runs.
\begin{lstlisting}
thread struct World; //FuncRunner declared above

void ?main(thread World* this) {
        sout | "World!" | endl;
}

void main() {
        World w;
        //Thread run forks here

        //Print to "Hello " and "World!" will be run concurrently
        sout | "Hello " | endl;

        //Implicit join at end of scope
}
\end{lstlisting}
This semantic has several advantages over explicit semantics : typesafety is guaranteed, a thread is always started and stopped exaclty once and users cannot make any progamming errors. However, one of the apparent drawbacks of this system is that threads now always form a lattice, that is they are always destroyed in opposite order of construction. While this seems like a significant limitation, existing \CFA semantics can solve this problem. Indeed, by using dynamic allocation to create threads will naturally let threads outlive the scope in which the thread was created much like dynamically allocating memory will let objects outlive the scope in which thy were created :

\begin{lstlisting}
        thread struct MyThread {
                //...
        };

        //ctor
        void ?{}(MyThread* this,
                     bool is_special = false) {
                //...
        }

        //main
        void ?main(MyThread* this) {
                //...
        }

        void foo() {
                MyThread* special_thread;
                {
                        MyThread thrds = {false};
                        //Start a thread at the beginning of the scope

                        DoStuff();

                        //create a other thread that will outlive the thread in this scope
                        special_thread = new MyThread{true};

                        //Wait for the thread to finish
                }
                DoMoreStuff();

                //Now wait for the special
        }
\end{lstlisting}

Another advantage of this semantic is that it naturally scale to multiple threads meaning basic synchronisation is very simple :

\begin{lstlisting}
        thread struct MyThread {
                //...
        };

        //ctor
        void ?{}(MyThread* this) {}

        //main
        void ?main(MyThread* this) {
                //...
        }

        void foo() {
                MyThread thrds[10];
                //Start 10 threads at the beginning of the scope

                DoStuff();

                //Wait for the 10 threads to finish
        }
\end{lstlisting}

\newpage
\bf{WORK IN PROGRESS}
\subsection{The \CFA Kernel : Processors, Clusters and Threads}\label{kernel}


\subsection{Paradigms}\label{cfaparadigms}
Given these building blocks we can then reproduce the all three of the popular paradigms. Indeed, we get \glspl{uthread} as the default paradigm in \CFA. However, disabling \glspl{preemption} on the \gls{cfacluster} means \glspl{cfathread} effectively become \glspl{fiber}. Since several \glspl{cfacluster} with different scheduling policy can coexist in the same application, this allows \glspl{fiber} and \glspl{uthread} to coexist in the runtime of an application.

% \subsection{High-level options}\label{tasks}
%
% \subsubsection{Thread interface}
% constructors destructors
%       initializer lists
% monitors
%
% \subsubsection{Futures}
%
% \subsubsection{Implicit threading}
% Finally, simpler applications can benefit greatly from having implicit parallelism. That is, parallelism that does not rely on the user to write concurrency. This type of parallelism can be achieved both at the language level and at the system level.
%
% \begin{center}
% \begin{tabular}[t]{|c|c|c|}
% Sequential & System Parallel & Language Parallel \\
% \begin{lstlisting}
% void big_sum(int* a, int* b,
%                int* out,
%                size_t length)
% {
%       for(int i = 0; i < length; ++i ) {
%               out[i] = a[i] + b[i];
%       }
% }
%
%
%
%
%
% int* a[10000];
% int* b[10000];
% int* c[10000];
% //... fill in a and b ...
% big_sum(a, b, c, 10000);
% \end{lstlisting} &\begin{lstlisting}
% void big_sum(int* a, int* b,
%                int* out,
%                size_t length)
% {
%       range ar(a, a + length);
%       range br(b, b + length);
%       range or(out, out + length);
%       parfor( ai, bi, oi,
%       [](int* ai, int* bi, int* oi) {
%               oi = ai + bi;
%       });
% }
%
% int* a[10000];
% int* b[10000];
% int* c[10000];
% //... fill in a and b ...
% big_sum(a, b, c, 10000);
% \end{lstlisting}&\begin{lstlisting}
% void big_sum(int* a, int* b,
%                int* out,
%                size_t length)
% {
%       for (ai, bi, oi) in (a, b, out) {
%               oi = ai + bi;
%       }
% }
%
%
%
%
%
% int* a[10000];
% int* b[10000];
% int* c[10000];
% //... fill in a and b ...
% big_sum(a, b, c, 10000);
% \end{lstlisting}
% \end{tabular}
% \end{center}
%
% \subsection{Machine setup}\label{machine}
% Threads are all good and well but wee still some OS support to fully utilize available hardware.
%
% \textbf{\large{Work in progress...}} Do wee need something beyond specifying the number of kernel threads?

%    #    #       #
%   # #   #       #
%  #   #  #       #
% #     # #       #
% ####### #       #
% #     # #       #
% #     # ####### #######
\section{Putting it all together}










% ####### #     # ####### #     # ######  #######
% #       #     #    #    #     # #     # #
% #       #     #    #    #     # #     # #
% #####   #     #    #    #     # ######  #####
% #       #     #    #    #     # #   #   #
% #       #     #    #    #     # #    #  #
% #        #####     #     #####  #     # ######
\section{Future work}
Concurrency and parallelism is still a very active field that strongly benefits from hardware advances. As such certain features that aren't necessarily mature enough in their current state could become relevant in the lifetime of \CFA.
\subsection{Transactions}

% ####### #     # ######
% #       ##    # #     #
% #       # #   # #     #
% #####   #  #  # #     #
% #       #   # # #     #
% #       #    ## #     #
% ####### #     # ######
\section*{Acknowledgements}

\clearpage
\printglossary[type=\acronymtype]
\printglossary

\clearpage
\bibliographystyle{plain}
\bibliography{cw92,distSharedMem,lfp92,mlw92,parallel,parallelIO,partheory,pl,pldi92,ps,realtime,techreportsPAB,visual,local}


\end{document}