Skip to content

Commit

Permalink
Issue414: add a remark as to why group contruction behaves differentl…
Browse files Browse the repository at this point in the history
…y than PMIx_Connect (req. during 23Q4)
  • Loading branch information
abouteiller committed Jan 25, 2024
1 parent dff11f0 commit ca67509
Show file tree
Hide file tree
Showing 2 changed files with 2 additions and 1 deletion.
1 change: 1 addition & 0 deletions Chap_API_Sets_Groups.tex
Original file line number Diff line number Diff line change
Expand Up @@ -365,6 +365,7 @@ \subsection{\code{PMIx_Group_construct}}
The ordering of the entries in the \refarg{procs} has no significance, neither is the method used for identifying processes.
Some callers may describe the target set of processes using PMIX_RANK_WILDCARD while other
callers may list the individual processes of a namespace explicitly.
This is unlike \refapi{PMIx_Connect}, because in this group operation, the group name \refarg{grp} is used to determine the uniqueness of the collective.

If the \refattr{PMIX_GROUP_NOTIFY_TERMINATION} attribute is provided and has a value of \code{true}, then either the construct leader (if \refattr{PMIX_GROUP_LEADER} is provided) or all participants who register for the \refconst{PMIX_GROUP_MEMBER_FAILED} event will receive events whenever a process fails or terminates prior to calling \refapi{PMIx_Group_construct} – i.e. if a \emph{group leader} is declared, \textit{only} that process will receive the event. In the absence of a declared leader, \textit{all} specified group members will receive the event.

Expand Down
2 changes: 1 addition & 1 deletion Chap_API_Sync.tex
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,7 @@ \section{\code{PMIx_Fence}}
Passing a \code{NULL} pointer as the \refarg{procs} parameter indicates that the fence is to span all processes in the client's namespace.
Each provided \refstruct{pmix_proc_t} struct can pass \refconst{PMIX_RANK_WILDCARD} to indicate that all processes in the given namespace are participating.
The ordering of the entries in the \refarg{procs} has no significance. However, all processes engaged in a given
\refapi{PMIx_Fence}
\refapi{PMIx_Fence}
operation must use the same method to identify processes. Callers which describe
the target set of processes using PMIX_RANK_WILDCARD will not be matched with
callers which list the individual processes of a namespace explicitly.
Expand Down

0 comments on commit ca67509

Please sign in to comment.