Skip to content

Commit

Permalink
teams: clarify behavior of split with strides <= 0
Browse files Browse the repository at this point in the history
  • Loading branch information
davidozog committed Jul 11, 2024
1 parent ea5ef5e commit a392d40
Show file tree
Hide file tree
Showing 2 changed files with 12 additions and 3 deletions.
4 changes: 4 additions & 0 deletions content/backmatter.tex
Original file line number Diff line number Diff line change
Expand Up @@ -703,6 +703,10 @@ \section{Version 1.6}
additional arguments.
\ChangelogRef{subsec:shmem_pcontrol}
%
\item Clarified the behavior of \FUNC{shmem\_team\_split\_strided} when the
stride argument is 0 or negative.
\ChangelogRef{subsec:shmem_team_split_strided}
%
\end{itemize}

\section{Version 1.5}
Expand Down
11 changes: 8 additions & 3 deletions content/shmem_team_split_strided.tex
Original file line number Diff line number Diff line change
Expand Up @@ -50,10 +50,15 @@
i \in \mathbb{Z}_{size-1}
\end{equation*}
where $\mathbb{Z}$ is the set of natural numbers ($0, 1, \dots$), $N$ is the
number of \acp{PE} in the parent team and $size$ is a positive number indicating
the number of \acp{PE} in the new team. The index $i$ specifies the number of
the given PE in the new team. Thus, \acp{PE} in the new team remain in the same
number of \acp{PE} in the parent team, $size$ is a positive number indicating
the number of \acp{PE} in the new team, and $stride$ is an integer.
The index $i$ specifies the number of the given PE in the new team.
When $stride$ is greater than zero, PEs in the new team remain in the same
relative order as in the parent team.
When $stride$ is less than zero, PEs in the new team are in \textit{reverse}
relative order with respect to the parent team.
If a $stride$ value equal to 0 is passed to \FUNC{shmem\_team\_split\_strided},
then the $size$ argument passed must be 1, or the behavior is undefined.

This routine must be called by all \acp{PE} in the parent team.
All \acp{PE} must provide the same values for the \ac{PE} triplet.
Expand Down

0 comments on commit a392d40

Please sign in to comment.