legion.tex

\documentclass[11pt]{book}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{textcomp}
\usepackage{listings}
\usepackage{hyperref}
\usepackage{url}
\usepackage{graphicx}
\usepackage{microtype}

\lstset{upquote=true}

\newcommand{\legionbook}[1]{{\tt Examples/#1}}
\newcommand{\Cpp}{C++}

\begin{document}

\title{Programming with Legion}
\author{Alex Aiken \and Michael Bauer}
\input{date_and_version}
\maketitle

\subsection*{Preface}
\addcontentsline{toc}{subsection}{Preface}

The first paper describing the Legion programming model
was published in 2012 \cite{Legion12}.  Since then, there has been
enormous progress and many people have contributed to
the project.  Throughout this period new application developers have
learned Legion through a combination of examples, lore from other
members of the project, research papers and reading the source code of
the Legion implementation.  The intention here is to put down in 
a systematic fashion what a programmer who wants to use
Legion to develop high performance applications needs to know.

This book is intended to be a combination tutorial, rationale and
manual.  The first part is the tutorial and rationale, laying out in some
detail what Legion is and why it is that way.  The second part is the manual, which describes
each of the API calls for the Legion \Cpp\ runtime.

The example programs and configuration files referred to in this book can be found in the directory
\legionbook{} included in the Legion distribution.

This book is incomplete and will remain incomplete for
some time to come.  But on the theory that partial documentation is better than no
documentation, the manual is being made available while it is
still in progress in the hope that it will be useful to new Legion
programmers.  Please report any errors or other issues to {\tt
  aiken@cs.stanford.edu}. \\[2in] Alex Aiken\\ Stanford, CA \\
September 2022

\tableofcontents

\part{Legion Runtime Tutorial}
\include{installation}
\include{tasks}
\include{regions}
\include{partitioning}
\include{control_replication}
\include{coherence}
%\include{constraints}
\include{mapping}
%\include{performance}
\include{interop}
%\include{reference}

\bibliographystyle{alpha}
\bibliography{bibliography}

\end{document}