[Mochi-devel] new SSG version 0.5.0 out -- important API changes

[Snyder, Shane]

Hi all,

Christmas comes early this year and we have a new version of SSG out for Mochi users! This new release contains some key changes to SSG's API and semantics that users should consider. That said, we are hopeful this newly refactored version of SSG will address some usability/stability concerns that users have brought up in the past.

Important changes:

  *   All SSG functions return error codes now, which means that the return values from prior versions of SSG functions have been shifted into functional arguments that are passed by reference
     *   ssg_strerror() function can be used to obtain an error string
  *   ssg_group_observe()/ssg_group_unobserve() have been removed and replaced with ssg_group_refresh()
     *   this function may be repeatedly called by non-group members to obtain updated group views from group members
     *   group members do not need to use this call, as their views are automatically managed by the SWIM protocol
  *   ssg_init() can no longer be called before margo_init(), a capability we originally added to allow users to extract key group info before initializing Margo. New helper functions have been added to support these use cases:
     *   ssg_get_group_cred_from_buf()/ssg_get_group_cred_from_file() to retrieve a group credential from a group file or buffer, before initializing SSG
     *   ssg_get_group_transport_from_buf()/ssg_get_group_transport_from_file() to retrieve the group transport protocol from a group file or buffer, before initializing SSG
  *   ssg_group_id_get_cred() and ssg_group_id_get_addr_str() functions have been removed
     *   The former is replaced by the credential helper function mentioned above
     *   The latter is replaced by new function ssg_get_group_member_addr_str()
  *   ssg_group_join_target(), ssg_group_leave_target(), and ssg_group_refresh_target() all expect input in form of a Mercury address now, rather than an address string

Please let us know if you have any questions/feedback about the changes or if you run into any problems!

Happy holidays!

--Shane
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.mcs.anl.gov/pipermail/mochi-devel/attachments/20211223/4277a75d/attachment.html>