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: