Skip to content

Commit

Permalink
WG Feedback: Vectorized PE quiet
Browse files Browse the repository at this point in the history
  • Loading branch information
manjugv committed Oct 7, 2021
1 parent 489c2b6 commit 7cf268c
Showing 1 changed file with 14 additions and 10 deletions.
24 changes: 14 additions & 10 deletions content/shmem_pe_quiet.tex
Original file line number Diff line number Diff line change
Expand Up @@ -2,35 +2,39 @@
Waits for completion of all outstanding memory store, blocking
\PUT{}, \ac{AMO}, and \emph{put-with-signal}, as well as
nonblocking \PUT{}, \emph{put-with-signal}, and \GET{} routines
to symmetric data objects issued by the calling \ac{PE} at the target \ac{PE}.
to symmetric data objects issued by the calling \ac{PE} at the target
\acp{PE}.
}

\begin{apidefinition}

\begin{Csynopsis}
void @\FuncDecl{shmem\_pe\_quiet}@(int target_pe);
void @\FuncDecl{shmem\_ctx\_pe\_quiet}@(shmem_ctx_t ctx, int target_pe);
void @\FuncDecl{shmem\_pe\_quiet}@(int *target_pes, size_t npes);
void @\FuncDecl{shmem\_ctx\_pe\_quiet}@(shmem_ctx_t ctx, int *target_pes, size_t
npes);
\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}
\apiargument{IN}{target\_pes}{Address of target \ac{PE} array where the
operations need to be completed}
\apiargument{IN}{npes}{The number of \acp{PE} in the target \ac{PE} array}

\end{apiarguments}

\apidescription{
The \FUNC{shmem\_pe\_quiet} ensures completion of memory store, blocking
\PUT{}, \ac{AMO}, and \emph{put-with-signal}, as well as
nonblocking \PUT{}, \emph{put-with-signal}, and \GET{} routines
on the symmetric data objects issued by the
calling \ac{PE} to the target \ac{PE} and on the given context.
calling \ac{PE} to the target \acp{PE} and on the given context.

The completion and visibility semantics of these routines are same as the
\FUNC{shmem\_quiet} routine, however, it applies only to the target \ac{PE}
.i.e., the routines to target \ac{PE} are guaranteed to be completed and
visible to all \ac{PE} when \FUNC{shmem\_pe\_quiet} returns.
The completion and visibility semantics of these routines are the same as the
\FUNC{shmem\_quiet} routine. However, it applies only to the target \acp{PE}
.i.e., the routines to the target \acp{PE} are guaranteed to be complete and
visible to all \acp{PE} when \FUNC{shmem\_pe\_quiet} returns.
}
\apireturnvalues{
None.
Expand Down

0 comments on commit 7cf268c

Please sign in to comment.