Make a new object unique¶
ss_pers_unique
is a function defined in sspers.c.
Synopsis:
-
herr_t
ss_pers_unique
(ss_pers_t *pers)¶
Formal Arguments:
pers
: Persistent object to make unique
Description: If N
MPI tasks each create an object that is identical across all the tasks (such as happens when
saf_declare_set
is called with all arguments the same) then SSlib will merge those N
new objects into a
single permanent object. A similar thing happens when a single tasks creates multiple new identical objects.
The merging happens during a synchronization operation and only for objects that are new (i.e., objects that
were not created with the SS_ALLSAME bit flag).
By calling this function on a persistent object, the persistent object is modified in a unique manner which causes it to be different than any other object on this MPI task or any other MPI task. The uniqueness should only be set for new objects.
Return Value: Returns non-negative on success; negative on failure.
Parallel Notes: Independent
See Also:
- Persistent Objects: Introduction for current chapter