pmix-standard.tex

% Welcome to pmix-standard.tex.
% This is the master LaTex file for the PMIx Standard document.
%
% The files in this set include:
%
%    pmix-standard.tex                - this file, the master file
%    Makefile                         - makes the document
%    pmix.sty                         - the main style file
%    Title_Page.tex                   - the title page
%    Chap_Introduction.tex            - unnumbered introductory chapter
%    figs/*.png                       - Figures
%    sources/*.c, *.f                 - C/C++/Fortran example source files
%
% When editing this file:
%
%    1. To change formatting, appearance, or style, please edit pmix.sty.
%
%    2. Custom commands and macros are defined in pmix.sty.
%
%    3. Be kind to other editors -- keep a consistent style by copying-and-pasting to
%       create new content.
%
%    4. We use semantic markup, e.g. (see pmix.sty for a full list):
%         \code{}     % for bold monospace keywords, code, operators, etc.
%
%    5. Other recommendations:
%         Use the convenience macros defined in pmix.sty for the minor headers
%         such as Comments, Syntax, etc.
%
%         To keep items together on the same page, prefer the use of
%         \begin{samepage}.... Avoid \parbox for text blocks as it interrupts line numbering.
%         When possible, avoid \filbreak, \pagebreak, \newpage, \clearpage unless that's
%         what you mean. Use \needspace{} cautiously for troublesome paragraphs.
%
%         Avoid absolute lengths and measures in this file; use relative units when possible.
%         Vertical space can be relative to \baselineskip or ex units. Horizontal space
%         can be relative to \linewidth or em units.
%
%         Prefer \emph{} to italicize terminology, e.g.:
%             This is a \emph{definition}, not a placeholder.
%             This is a \plc{var-name}.
%

% The following says letter size, but the style sheet may change the size
\documentclass[10pt,letterpaper,twoside,makeidx,hidelinks]{scrreprt}

%%%%%%%%%%%%%%%%%%%
% Release Managers:
% - Set is_unofficial_draft = false to remove the watermark
% - Set VER to the correct version number
% - Set VERDATE to the Month+Year of the release
%%%%%%%%%%%%%%%%%%%
\usepackage[us,24hr]{datetime}
\usepackage{ifthen}
\newboolean{is_unofficial_draft}
\setboolean{is_unofficial_draft}{true}

% Text to appear in the footer on even-numbered pages:
\ifthenelse{\boolean{is_unofficial_draft}}
  {\newcommand{\VER}{4.0 (Draft)}
   \newcommand{\VERDATE}{\emph{Created on \today}}
  }
  {\newcommand{\VER}{4.0}
   \newcommand{\VERDATE}{Month Year}
  }
\newcommand{\footerText}{PMIx Standard -- Version \VER{} -- \VERDATE}

% Unified style sheet for PMIx documents:
\input{pmix.sty}
\makeindex[intoc,columns=2]

% Watermark for the Unofficial Drafts
% Note: "allpages","evenpages","oddpages" do not work. Likely because of the index.
\ifthenelse{\boolean{is_unofficial_draft}}
  {\usepackage[printwatermark]{xwatermark}
   \newwatermark[firstpage,color=gray!30,angle=45,scale=3,xpos=-5,ypos=0]{Unofficial Draft}
  }{}

%%%%%%%%%%%%%%%%%%%
\usepackage{acronym}
\acrodef{PMI}[PMI]{Process Management Interface}
\acrodef{PMIx}[PMIx]{Process Management Interface - Exascale}
\acrodef{HPC}[HPC]{High Performance Computing}
\acrodef{MPI}[MPI]{Message Passing Interface}
\acrodef{MPE}[MPE]{Message Passing Environment}

\acrodef{RM}[RM]{resource manager}
\acrodef{RTE}[RTE]{RunTime Environment}
\acrodef{SMS}[SMS]{system management software stack}
\acrodef{WLM}[WLM]{workload manager}
\acrodef{GDS}[GDS]{global data storage}
\acrodef{BCX}[BCX]{business card exchange}

\acrodef{PID}[PID]{process identifier}
\acrodef{URI}[URI]{uniform resource identifier}
\acrodef{CIDR}[CIDR]{Classless Inter-Domain Routing}
\acrodef{XML}[XML]{eXtensible Markup Language}

\acrodef{RAS}[RAS]{Reliability and Survivability}
\acrodef{API}[API]{Application Programming Interface}
\acrodef{PRRTE}[PRRTE]{PMIx-based Reference RunTime Environment}
\acrodef{PRI}[PRI]{PMIx Reference Implementation}
\acrodef{ECC}[ECC]{Error Check and Correction}
\acrodef{FM}[FM]{Fabric Manager}
\acrodef{IO}[IO]{Input/Output}
\acrodef{MPMD}{Multiple Program Multiple Data}
\acrodef{PU}{Processing Unit}
\acrodef{HWLOC}{Hardware Locality}
\acrodef{OS}{Operating System}
\acrodef{PGCID}{Process Group Context IDentifier}
\acrodef{NIC}{Network Interface Card}

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


\begin{document}
%
% Title page
%
    \pagenumbering{roman}
    \input{TitlePage}

%
% Table of contents
%
    \setcounter{page}{0}
    \setcounter{tocdepth}{2}

    \begin{spacing}{1.3}
        \RedeclareSectionCommand[tocnumwidth=2.6em]{section}
        \RedeclareSectionCommand[tocnumwidth=3.7em,tocindent=4.1em]{subsection}
        \tableofcontents
    \end{spacing}

%
% Introductory materials
%
    % Uncomment the next line to enable line numbering on the main body text:
    \linenumbers\pagewiselinenumbers
    \newpage\pagenumbering{arabic}
    \setcounter{chapter}{0}  % start chapter numbering here

%
% Chapters
%
    % Introduction to PMIx
    %  - Overview, Goals, Arch.
    \input{Chap_Introduction.tex}

    % PMIx Terms and Conventions
    \input{Chap_Terms.tex}

    % Data Structures, Types, Constants
    %  - Includes: Reserved attributes, Keys
    \input{Chap_API_Struct.tex}

    % Initialization & Finalization
    %  - Client, Server, Tool interfaces
    \input{Chap_API_Init.tex}

    % Key/Value Management
    %  - put, get, commit, fence, (un)publish, lookup
    \input{Chap_API_Key_Value_Mgmt.tex}

    % Process Management
    %  - spawn, (dis)connect, resolve_peers
    \input{Chap_API_Proc_Mgmt.tex}

    % Job Allocation Management
    %  - Allocation request, process monitoring
    \input{Chap_API_Job_Mgmt.tex}

    % Event Handling
    %  - (de)register_event, notify_event
    \input{Chap_API_Event.tex}

    % Data Packing & Unpacking
    %  - (un)pack, copy
    \input{Chap_API_Data_Mgmt.tex}

    % Security credentials
    \input{Chap_API_Security.tex}

    % PMIx Server Specific Interfaces
    %  - setup_fork, (de)register_nspace, pmix_server_module_t
    \input{Chap_API_Server.tex}

    % PMIx Scheduler Specific Interfaces
    %  - register/deregister fabric, get vertex/index
    \input{Chap_API_Scheduler.tex}

    % PMIx Process Sets and Groups
    \input{Chap_API_Sets_Groups.tex}

    % PMIx Network Coordinates
    \input{Chap_API_Coord.tex}

%
% Appendix
%
    \setcounter{chapter}{0}  % restart chapter numbering with "letter A"
    \renewcommand{\thechapter}{\Alph{chapter}}%
    \appendix

    % Python bindings
    \input{App_Python}

% Revisions, Acknowledgements
    \input{Acknowledgements}

%
% Bibliography
%
	\nolinenumbers
	\bibliography{pmix-standard}{}
	\addcontentsline{toc}{chapter}{Bibliography}
	\bibliographystyle{plain}

%
% Index
%
	\nolinenumbers
	\printindex

\end{document}

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