Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Teams: clarify behavior of split ops with strides <= 0 #519

Merged
merged 1 commit into from
Aug 23, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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