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

Per PE Fence interface #315

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
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
37 changes: 37 additions & 0 deletions content/shmem_pe_fence.tex
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
\apisummary{
Assures ordering of delivery of memory store, blocking \PUT{},
\ac{AMO}, and \OPR{put-with-signal}, as well as nonblocking
\PUT{}, \OPR{put-with-signal}, and \ac{AMO}
routines to symmetric data objects issued by the calling \ac{PE} at the target \ac{PE}.
}

\begin{apidefinition}

\begin{Csynopsis}
void @\FuncDecl{shmem\_fence}@(int target_pe);
Copy link
Collaborator

@davidozog davidozog Jan 10, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Isn't this supposed to be shmem_pe_fence here, or is it really shmem_fence?

void @\FuncDecl{shmem\_ctx\_fence}@(shmem_ctx_t ctx, int target_pe);
\end{Csynopsis}

\begin{apiarguments}
\apiargument{IN}{ctx}{A context handle specifying the context on which to perform the operation.
When this argument is not provided, the operation is performed on
the default context.}
\apiargument{IN}{target\_pe}{The target \ac{PE} where the operations needs
to be completed}
\end{apiarguments}

\apidescription{
The \FUNC{shmem\_pe\_fence} routine assures ordering of operations similar
to \FUNC{shmem\_fence}, expect that ordering is ensured only between the
calling \ac{PE} and the target \ac{PE}. The ordering of operations between
any other \acp{PE} are not guaranteed by the \FUNC{shmem\_pe\_fence} routine.
}

\apireturnvalues{
None.
}

\apinotes{
}

\end{apidefinition}
3 changes: 3 additions & 0 deletions main_spec.tex
Original file line number Diff line number Diff line change
Expand Up @@ -478,6 +478,9 @@ \subsection{Memory Ordering Routines}\label{subsec:memory_order}
\subsubsection{\textbf{SHMEM\_FENCE}}\label{subsec:shmem_fence}
\input{content/shmem_fence.tex}

\subsubsection{\textbf{SHMEM\_PE\_FENCE}}\label{subsec:shmem_pe_fence}
\input{content/shmem_pe_fence.tex}

\subsubsection{\textbf{SHMEM\_QUIET}}\label{subsec:shmem_quiet}
\input{content/shmem_quiet.tex}

Expand Down