Skip to content

Commit

Permalink
Move context options to contexts intro
Browse files Browse the repository at this point in the history
Signed-off-by: James Dinan <[email protected]>
  • Loading branch information
jdinan committed Mar 22, 2020
1 parent 4fa036c commit c5985a3
Show file tree
Hide file tree
Showing 2 changed files with 28 additions and 29 deletions.
29 changes: 28 additions & 1 deletion content/context_intro.tex
Original file line number Diff line number Diff line change
Expand Up @@ -42,4 +42,31 @@
All point-to-point routines that operate on this context will do so with
respect to the team-relative \ac{PE} numbering of the associated team.
If the PE number passed to such a routine is invalid, being negative or greater
than or equal to the size of the \openshmem team, then the behavior is undefined.
than or equal to the size of the \openshmem team, then the behavior is undefined.

By default, contexts are {\em shareable} and, when it is allowed by the
threading model provided by the \openshmem library, they can be used concurrently by
multiple threads within the PE where they were created.
%
The following options can be supplied during context creation to restrict
this usage model and enable performance optimizations. When using a given
context, the application must comply with the requirements of all options
set on that context; otherwise, the behavior is undefined.
No options are enabled on the default context.

\apitablerow{\LibConstRef{SHMEM\_CTX\_SERIALIZED}}{
The given context is shareable; however, it will not be used by multiple threads
concurrently. When the \CONST{SHMEM\_CTX\_SERIALIZED} option is
set, the user must ensure that operations involving the given
context are serialized by the application.}

\apitablerow{\LibConstRef{SHMEM\_CTX\_PRIVATE}}{
The given context will be used only by the thread that created it.}

\apitablerow{\LibConstRef{SHMEM\_CTX\_NOSTORE}}{
Quiet and fence operations performed on the given context are not
required to enforce completion and ordering of memory store
operations.
When ordering of store operations is needed, the application must
perform a synchronization operation on a context without the
\CONST{SHMEM\_CTX\_NOSTORE} option enabled.}
28 changes: 0 additions & 28 deletions content/shmem_ctx_create.tex
Original file line number Diff line number Diff line change
Expand Up @@ -35,34 +35,6 @@
respect to the associated \ac{PE} team.
That is, all point-to-point routines operating on this context will use
team-relative \ac{PE} numbering.

By default, contexts are {\em shareable} and, when it is allowed by the
threading model provided by the \openshmem library, they can be used concurrently by
multiple threads within the PE where they were created.
%
The following options can be supplied during context creation to restrict
this usage model and enable performance optimizations. When using a given
context, the application must comply with the requirements of all options
set on that context; otherwise, the behavior is undefined.
No options are enabled on the default context.

\apitablerow{\LibConstRef{SHMEM\_CTX\_SERIALIZED}}{
The given context is shareable; however, it will not be used by multiple threads
concurrently. When the \CONST{SHMEM\_CTX\_SERIALIZED} option is
set, the user must ensure that operations involving the given
context are serialized by the application.}

\apitablerow{\LibConstRef{SHMEM\_CTX\_PRIVATE}}{
The given context will be used only by the thread that created it.}

\apitablerow{\LibConstRef{SHMEM\_CTX\_NOSTORE}}{
Quiet and fence operations performed on the given context are not
required to enforce completion and ordering of memory store
operations.
When ordering of store operations is needed, the application must
perform a synchronization operation on a context without the
\CONST{SHMEM\_CTX\_NOSTORE} option enabled.}

}

\apireturnvalues{
Expand Down

0 comments on commit c5985a3

Please sign in to comment.