ssg.c 49.4 KB
Newer Older
1 2 3 4 5 6
/*
 * Copyright (c) 2016 UChicago Argonne, LLC
 *
 * See COPYRIGHT in top-level directory.
 */

7
#include "ssg-config.h"
Shane Snyder's avatar
Shane Snyder committed
8

Jonathan Jenkins's avatar
Jonathan Jenkins committed
9 10 11 12
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <unistd.h>
13
#include <errno.h>
Jonathan Jenkins's avatar
Jonathan Jenkins committed
14 15
#include <stdlib.h>
#include <string.h>
16
#include <time.h>
17
#include <linux/limits.h>
Jonathan Jenkins's avatar
Jonathan Jenkins committed
18
#include <assert.h>
Shane Snyder's avatar
Shane Snyder committed
19
#ifdef SSG_HAVE_MPI
20 21
#include <mpi.h>
#endif
Shane Snyder's avatar
Shane Snyder committed
22 23 24
#ifdef SSG_HAVE_PMIX
#include <pmix.h>
#endif
Jonathan Jenkins's avatar
Jonathan Jenkins committed
25

Shane Snyder's avatar
Shane Snyder committed
26
#include <mercury.h>
27
#include <abt.h>
Shane Snyder's avatar
Shane Snyder committed
28
#include <margo.h>
29

30
#include "ssg.h"
Shane Snyder's avatar
Shane Snyder committed
31 32 33
#ifdef SSG_HAVE_MPI
#include "ssg-mpi.h"
#endif
Shane Snyder's avatar
Shane Snyder committed
34 35 36
#ifdef SSG_HAVE_PMIX
#include "ssg-pmix.h"
#endif
37
#include "ssg-internal.h"
Shane Snyder's avatar
Shane Snyder committed
38
#include "swim-fd/swim-fd.h"
39

40 41 42
/* arguments for group lookup ULTs */
struct ssg_group_lookup_ult_args
{
43
    const char *addr_str;
44
    ssg_group_view_t *view;
Shane Snyder's avatar
Shane Snyder committed
45
    ABT_rwlock lock;
46
    int out;
47 48 49
};
static void ssg_group_lookup_ult(void * arg);

50
/* SSG helper routine prototypes */
Shane Snyder's avatar
Shane Snyder committed
51 52 53 54 55 56 57
static ssg_group_t * ssg_group_create_internal(
    const char * group_name, const char * const group_addr_strs[],
    int group_size, ssg_membership_update_cb update_cb, void *update_cb_dat);
static int ssg_group_view_create(
    const char * const group_addr_strs[], int group_size,
    const char * self_addr_str, ABT_rwlock view_lock,
    ssg_group_view_t * view, ssg_member_id_t * self_id);
58
static ssg_member_state_t * ssg_group_view_add_member(
59 60
    const char * addr_str, hg_addr_t addr, ssg_member_id_t member_id,
    ssg_group_view_t * view);
61
static ssg_group_descriptor_t * ssg_group_descriptor_create(
62
    uint64_t name_hash, const char * leader_addr_str, int owner_status);
63 64 65 66 67 68
static ssg_group_descriptor_t * ssg_group_descriptor_dup(
    ssg_group_descriptor_t * descriptor);
static void ssg_group_destroy_internal(
    ssg_group_t * g);
static void ssg_attached_group_destroy(
    ssg_attached_group_t * ag);
Shane Snyder's avatar
Shane Snyder committed
69 70 71 72 73 74
static void ssg_group_view_destroy(
    ssg_group_view_t * view);
static void ssg_group_descriptor_free(
    ssg_group_descriptor_t * descriptor);
static ssg_member_id_t ssg_gen_member_id(
    const char * addr_str);
75 76
static const char ** ssg_addr_str_buf_to_list(
    const char * buf, int num_addrs);
77 78 79 80 81 82 83 84
#ifdef SSG_HAVE_PMIX
void ssg_pmix_proc_failure_notify_fn(
    size_t evhdlr_registration_id, pmix_status_t status, const pmix_proc_t *source,
    pmix_info_t info[], size_t ninfo, pmix_info_t results[], size_t nresults,
    pmix_event_notification_cbfunc_fn_t cbfunc, void *cbdata);
void ssg_pmix_proc_failure_reg_cb(
    pmix_status_t status, size_t evhdlr_ref, void *cbdata);
#endif 
85

86 87
/* XXX: i think we ultimately need per-mid ssg instances rather than 1 global? */
ssg_instance_t *ssg_inst = NULL;
88

89 90 91
/***************************************************
 *** SSG runtime intialization/shutdown routines ***
 ***************************************************/
92

93 94
int ssg_init(
    margo_instance_id mid)
Jonathan Jenkins's avatar
Jonathan Jenkins committed
95
{
96 97
    struct timespec ts;

98 99 100 101 102 103 104 105 106
    if (ssg_inst)
        return SSG_FAILURE;

    /* initialize an SSG instance for this margo instance */
    ssg_inst = malloc(sizeof(*ssg_inst));
    if (!ssg_inst)
        return SSG_FAILURE;
    memset(ssg_inst, 0, sizeof(*ssg_inst));
    ssg_inst->mid = mid;
107
    ABT_rwlock_create(&ssg_inst->lock);
108

109
    ssg_register_rpcs();
110

111 112 113 114
    /* seed RNG */
    clock_gettime(CLOCK_MONOTONIC, &ts);
    srand(ts.tv_nsec + getpid());

115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130
#ifdef SSG_HAVE_PMIX
    if (PMIx_Initialized())
    {
        /* use PMIx event registrations to inform us of terminated/aborted procs */
        pmix_status_t err_codes[2] = {PMIX_PROC_TERMINATED, PMIX_ERR_PROC_ABORTED};
        PMIx_Register_event_handler(err_codes, 2, NULL, 0,
            ssg_pmix_proc_failure_notify_fn, ssg_pmix_proc_failure_reg_cb, NULL /* XXX */);
    }
    else
    {
        fprintf(stderr, "Warning: skipping PMIx event notification registration -- "\
                        "PMIx not initialized\n");
    }

#endif

131 132
    return SSG_SUCCESS;
}
Jonathan Jenkins's avatar
Jonathan Jenkins committed
133

134
int ssg_finalize()
135
{
136 137
    ssg_group_t *g, *g_tmp;
    ssg_attached_group_t *ag, *ag_tmp;
138 139 140 141

    if (!ssg_inst)
        return SSG_FAILURE;

142 143
    ABT_rwlock_wrlock(ssg_inst->lock);

144
    /* destroy all active groups */
145
    HASH_ITER(hh, ssg_inst->group_table, g, g_tmp)
146 147
    {
        HASH_DELETE(hh, ssg_inst->group_table, g);
148
        ABT_rwlock_unlock(ssg_inst->lock);
149
        ssg_group_destroy_internal(g);
150
        ABT_rwlock_wrlock(ssg_inst->lock);
151 152
    }

153 154 155 156 157 158
    /* detach from all attached groups */
    HASH_ITER(hh, ssg_inst->attached_group_table, ag, ag_tmp)
    {
        ssg_attached_group_destroy(ag);
    }

159 160 161
    ABT_rwlock_unlock(ssg_inst->lock);
    ABT_rwlock_free(&ssg_inst->lock);

162 163 164
    free(ssg_inst);
    ssg_inst = NULL;

165
    return SSG_SUCCESS;
166
}
Jonathan Jenkins's avatar
Jonathan Jenkins committed
167

168 169 170
/*************************************
 *** SSG group management routines ***
 *************************************/
Jonathan Jenkins's avatar
Jonathan Jenkins committed
171

Shane Snyder's avatar
Shane Snyder committed
172 173 174 175 176 177
ssg_group_id_t ssg_group_create(
    const char * group_name,
    const char * const group_addr_strs[],
    int group_size,
    ssg_membership_update_cb update_cb,
    void * update_cb_dat)
178
{
Shane Snyder's avatar
Shane Snyder committed
179 180
    ssg_group_t *g;
    ssg_group_id_t g_id = SSG_GROUP_ID_NULL;
181

Shane Snyder's avatar
Shane Snyder committed
182 183 184
    g = ssg_group_create_internal(group_name, group_addr_strs,
            group_size, update_cb, update_cb_dat);
    if (g)
Shane Snyder's avatar
Shane Snyder committed
185
        g_id = (ssg_group_id_t)g->descriptor;
Shane Snyder's avatar
Shane Snyder committed
186 187

    return g_id;
188
}
Shane Snyder's avatar
Shane Snyder committed
189

Shane Snyder's avatar
Shane Snyder committed
190 191 192 193 194
ssg_group_id_t ssg_group_create_config(
    const char * group_name,
    const char * file_name,
    ssg_membership_update_cb update_cb,
    void * update_cb_dat)
195
{
Shane Snyder's avatar
Shane Snyder committed
196 197 198 199 200 201 202 203
    int fd;
    struct stat st;
    char *rd_buf = NULL;
    ssize_t rd_buf_size;
    char *tok;
    void *addr_str_buf = NULL;
    int addr_str_buf_len = 0, num_addrs = 0;
    const char **addr_strs = NULL;
Shane Snyder's avatar
Shane Snyder committed
204
    int ret;
Shane Snyder's avatar
Shane Snyder committed
205
    ssg_group_id_t group_id = SSG_GROUP_ID_NULL;
206

Shane Snyder's avatar
Shane Snyder committed
207 208 209 210 211 212 213 214
    /* open config file for reading */
    fd = open(file_name, O_RDONLY);
    if (fd == -1)
    {
        fprintf(stderr, "Error: SSG unable to open config file %s for group %s\n",
            file_name, group_name);
        goto fini;
    }
215

Shane Snyder's avatar
Shane Snyder committed
216 217 218
    /* get file size and allocate a buffer to store it */
    ret = fstat(fd, &st);
    if (ret == -1)
Shane Snyder's avatar
Shane Snyder committed
219
    {
Shane Snyder's avatar
Shane Snyder committed
220 221 222
        fprintf(stderr, "Error: SSG unable to stat config file %s for group %s\n",
            file_name, group_name);
        goto fini;
Shane Snyder's avatar
Shane Snyder committed
223
    }
Shane Snyder's avatar
Shane Snyder committed
224 225
    rd_buf = malloc(st.st_size+1);
    if (rd_buf == NULL) goto fini;
Shane Snyder's avatar
Shane Snyder committed
226

Shane Snyder's avatar
Shane Snyder committed
227 228 229
    /* load it all in one fell swoop */
    rd_buf_size = read(fd, rd_buf, st.st_size);
    if (rd_buf_size != st.st_size)
Shane Snyder's avatar
Shane Snyder committed
230
    {
Shane Snyder's avatar
Shane Snyder committed
231 232 233
        fprintf(stderr, "Error: SSG unable to read config file %s for group %s\n",
            file_name, group_name);
        goto fini;
Shane Snyder's avatar
Shane Snyder committed
234
    }
Shane Snyder's avatar
Shane Snyder committed
235 236 237 238 239 240 241
    rd_buf[rd_buf_size]='\0';

    /* strtok the result - each space-delimited address is assumed to be
     * a unique mercury address
     */
    tok = strtok(rd_buf, "\r\n\t ");
    if (tok == NULL) goto fini;
Shane Snyder's avatar
Shane Snyder committed
242

Shane Snyder's avatar
Shane Snyder committed
243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260
    /* build up the address buffer */
    addr_str_buf = malloc(rd_buf_size);
    if (addr_str_buf == NULL) goto fini;
    do
    {
        int tok_size = strlen(tok);
        memcpy((char*)addr_str_buf + addr_str_buf_len, tok, tok_size+1);
        addr_str_buf_len += tok_size+1;
        num_addrs++;
        tok = strtok(NULL, "\r\n\t ");
    } while (tok != NULL);
    if (addr_str_buf_len != rd_buf_size)
    {
        /* adjust buffer size if our initial guess was wrong */
        void *tmp = realloc(addr_str_buf, addr_str_buf_len);
        if (tmp == NULL) goto fini;
        addr_str_buf = tmp;
    }
Shane Snyder's avatar
Shane Snyder committed
261

Shane Snyder's avatar
Shane Snyder committed
262 263 264
    /* set up address string array for group members */
    addr_strs = ssg_addr_str_buf_to_list(addr_str_buf, num_addrs);
    if (!addr_strs) goto fini;
Shane Snyder's avatar
Shane Snyder committed
265

Shane Snyder's avatar
Shane Snyder committed
266 267 268
    /* invoke the generic group create routine using our list of addrs */
    group_id = ssg_group_create(group_name, addr_strs, num_addrs,
        update_cb, update_cb_dat);
Shane Snyder's avatar
Shane Snyder committed
269

Shane Snyder's avatar
Shane Snyder committed
270 271 272 273 274 275
fini:
    /* cleanup before returning */
    if (fd != -1) close(fd);
    free(rd_buf);
    free(addr_str_buf);
    free(addr_strs);
Shane Snyder's avatar
Shane Snyder committed
276

Shane Snyder's avatar
Shane Snyder committed
277
    return group_id;
Shane Snyder's avatar
Shane Snyder committed
278 279
}

Shane Snyder's avatar
Shane Snyder committed
280 281 282 283 284 285
#ifdef SSG_HAVE_MPI
ssg_group_id_t ssg_group_create_mpi(
    const char * group_name,
    MPI_Comm comm,
    ssg_membership_update_cb update_cb,
    void * update_cb_dat)
Shane Snyder's avatar
Shane Snyder committed
286
{
Shane Snyder's avatar
Shane Snyder committed
287 288
    int i;
    char *self_addr_str = NULL;
289
    int self_addr_str_size = 0;
Shane Snyder's avatar
Shane Snyder committed
290 291 292 293 294 295
    char *addr_str_buf = NULL;
    int *sizes = NULL;
    int *sizes_psum = NULL;
    int comm_size = 0, comm_rank = 0;
    const char **addr_strs = NULL;
    ssg_group_id_t group_id = SSG_GROUP_ID_NULL;
Shane Snyder's avatar
Shane Snyder committed
296

Shane Snyder's avatar
Shane Snyder committed
297
    if (!ssg_inst) goto fini;
Shane Snyder's avatar
Shane Snyder committed
298

Shane Snyder's avatar
Shane Snyder committed
299
    /* get my address */
300
    SSG_GET_SELF_ADDR_STR(ssg_inst->mid, self_addr_str);
Shane Snyder's avatar
Shane Snyder committed
301
    if (self_addr_str == NULL) goto fini;
302
    self_addr_str_size = (int)strlen(self_addr_str) + 1;
303

Shane Snyder's avatar
Shane Snyder committed
304 305 306 307 308
    /* gather the buffer sizes */
    MPI_Comm_size(comm, &comm_size);
    MPI_Comm_rank(comm, &comm_rank);
    sizes = malloc(comm_size * sizeof(*sizes));
    if (sizes == NULL) goto fini;
309
    sizes[comm_rank] = self_addr_str_size;
Shane Snyder's avatar
Shane Snyder committed
310
    MPI_Allgather(MPI_IN_PLACE, 0, MPI_BYTE, sizes, 1, MPI_INT, comm);
311

Shane Snyder's avatar
Shane Snyder committed
312 313
    /* compute a exclusive prefix sum of the data sizes, including the
     * total at the end
314
     */
Shane Snyder's avatar
Shane Snyder committed
315 316 317 318 319
    sizes_psum = malloc((comm_size+1) * sizeof(*sizes_psum));
    if (sizes_psum == NULL) goto fini;
    sizes_psum[0] = 0;
    for (i = 1; i < comm_size+1; i++)
        sizes_psum[i] = sizes_psum[i-1] + sizes[i-1];
320

Shane Snyder's avatar
Shane Snyder committed
321 322 323
    /* allgather the addresses */
    addr_str_buf = malloc(sizes_psum[comm_size]);
    if (addr_str_buf == NULL) goto fini;
324
    MPI_Allgatherv(self_addr_str, self_addr_str_size, MPI_BYTE,
Shane Snyder's avatar
Shane Snyder committed
325
            addr_str_buf, sizes, sizes_psum, MPI_BYTE, comm);
Shane Snyder's avatar
Shane Snyder committed
326

Shane Snyder's avatar
Shane Snyder committed
327 328 329
    /* set up address string array for group members */
    addr_strs = ssg_addr_str_buf_to_list(addr_str_buf, comm_size);
    if (!addr_strs) goto fini;
330

Shane Snyder's avatar
Shane Snyder committed
331 332 333
    /* invoke the generic group create routine using our list of addrs */
    group_id = ssg_group_create(group_name, addr_strs, comm_size,
        update_cb, update_cb_dat);
Shane Snyder's avatar
Shane Snyder committed
334

Shane Snyder's avatar
Shane Snyder committed
335 336 337 338 339 340 341
fini:
    /* cleanup before returning */
    free(self_addr_str);
    free(sizes);
    free(sizes_psum);
    free(addr_str_buf);
    free(addr_strs);
Shane Snyder's avatar
Shane Snyder committed
342

Shane Snyder's avatar
Shane Snyder committed
343
    return group_id;
Shane Snyder's avatar
Shane Snyder committed
344
}
Shane Snyder's avatar
Shane Snyder committed
345
#endif
Shane Snyder's avatar
Shane Snyder committed
346

Shane Snyder's avatar
Shane Snyder committed
347 348 349
#ifdef SSG_HAVE_PMIX
ssg_group_id_t ssg_group_create_pmix(
    const char * group_name,
Shane Snyder's avatar
Shane Snyder committed
350
    const pmix_proc_t proc,
Shane Snyder's avatar
Shane Snyder committed
351 352 353
    ssg_membership_update_cb update_cb,
    void * update_cb_dat)
{
Shane Snyder's avatar
Shane Snyder committed
354 355 356
    char *self_addr_str = NULL;
    pmix_proc_t tmp_proc;
    pmix_value_t value;
357
    pmix_value_t *val_p;
Shane Snyder's avatar
Shane Snyder committed
358 359 360 361 362 363 364 365
    pmix_value_t *addr_vals = NULL;
    unsigned int nprocs;
    char key[128];
    pmix_info_t *info;
    bool flag;
    const char **addr_strs = NULL;
    unsigned int n;
    pmix_status_t ret;
Shane Snyder's avatar
Shane Snyder committed
366 367
    ssg_group_id_t group_id = SSG_GROUP_ID_NULL;

Shane Snyder's avatar
Shane Snyder committed
368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383
    if (!ssg_inst || !PMIx_Initialized()) goto fini;

    /* get my address */
    SSG_GET_SELF_ADDR_STR(ssg_inst->mid, self_addr_str);
    if (self_addr_str == NULL) goto fini;

    /* XXX note we are assuming every process in the job wants to join this group... */
    /* get the total nprocs in the job */
    PMIX_PROC_LOAD(&tmp_proc, proc.nspace, PMIX_RANK_WILDCARD);
    ret = PMIx_Get(&tmp_proc, PMIX_JOB_SIZE, NULL, 0, &val_p);
    if (ret != PMIX_SUCCESS) goto fini;
    nprocs = (int)val_p->data.uint32;
    PMIX_VALUE_RELEASE(val_p);

    /* put my address string using a well-known key */
    if (snprintf(key, 128, "%s-%d-hg-addr", proc.nspace, proc.rank) >= 128) goto fini;
384 385
    PMIX_VALUE_LOAD(&value, self_addr_str, PMIX_STRING);
    ret = PMIx_Put(PMIX_GLOBAL, key, &value);
Shane Snyder's avatar
Shane Snyder committed
386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406
    if (ret != PMIX_SUCCESS) goto fini;

    /* commit the put data to the local pmix server */
    ret = PMIx_Commit();
    if (ret != PMIX_SUCCESS) goto fini;

    /* barrier, additionally requesting to collect relevant process data */
    PMIX_INFO_CREATE(info, 1);
    flag = true;
    PMIX_INFO_LOAD(info, PMIX_COLLECT_DATA, &flag, PMIX_BOOL);
    ret = PMIx_Fence(&proc, 1, info, 1);
    PMIX_INFO_FREE(info, 1);

    addr_strs = malloc(nprocs * sizeof(*addr_strs));
    if (addr_strs == NULL) goto fini;

    /* finalize exchange by getting each member's address */
    PMIX_VALUE_CREATE(addr_vals, nprocs);
    for (n = 0; n < nprocs; n++)
    {
        /* skip ourselves */
407 408 409 410 411
        if(n == proc.rank)
        {
            addr_strs[n] = self_addr_str;
            continue;
        }
Shane Snyder's avatar
Shane Snyder committed
412 413 414 415 416 417 418 419 420 421

        if (snprintf(key, 128, "%s-%d-hg-addr", proc.nspace, n) >= 128) goto fini;

        tmp_proc.rank = n;
        val_p = &addr_vals[n];
        ret = PMIx_Get(&tmp_proc, key, NULL, 0, &val_p);
        if (ret != PMIX_SUCCESS) goto fini;

        addr_strs[n] = val_p->data.string;
    }
Shane Snyder's avatar
Shane Snyder committed
422

Shane Snyder's avatar
Shane Snyder committed
423 424 425
    /* invoke the generic group create routine using our list of addrs */
    group_id = ssg_group_create(group_name, addr_strs, nprocs,
        update_cb, update_cb_dat);
Shane Snyder's avatar
Shane Snyder committed
426 427

fini:
Shane Snyder's avatar
Shane Snyder committed
428 429 430 431
    /* cleanup before returning */
    free(self_addr_str);
    free(addr_strs);
    PMIX_VALUE_FREE(addr_vals, nprocs);
Shane Snyder's avatar
Shane Snyder committed
432 433 434 435 436

    return group_id;
}
#endif 

Shane Snyder's avatar
Shane Snyder committed
437 438
int ssg_group_destroy(
    ssg_group_id_t group_id)
439
{
Shane Snyder's avatar
Shane Snyder committed
440 441
    ssg_group_descriptor_t *group_descriptor = (ssg_group_descriptor_t *)group_id;
    ssg_group_t *g;
442

Shane Snyder's avatar
Shane Snyder committed
443
    if (!ssg_inst || group_id == SSG_GROUP_ID_NULL) return SSG_FAILURE;
444

Shane Snyder's avatar
Shane Snyder committed
445
    if (group_descriptor->owner_status != SSG_OWNER_IS_MEMBER)
446
    {
Shane Snyder's avatar
Shane Snyder committed
447 448
        fprintf(stderr, "Error: SSG unable to destroy a group it is not a member of\n");
        return SSG_FAILURE;
449
    }
450

451 452
    ABT_rwlock_wrlock(ssg_inst->lock);

Shane Snyder's avatar
Shane Snyder committed
453 454 455 456
    /* find the group structure and destroy it */
    HASH_FIND(hh, ssg_inst->group_table, &group_descriptor->name_hash,
        sizeof(uint64_t), g);
    if (!g)
457
    {
458
        ABT_rwlock_unlock(ssg_inst->lock);
Shane Snyder's avatar
Shane Snyder committed
459 460
        fprintf(stderr, "Error: SSG unable to find expected group reference\n");
        return SSG_FAILURE;
461
    }
462 463
    HASH_DELETE(hh, ssg_inst->group_table, g);
    ABT_rwlock_unlock(ssg_inst->lock);
Shane Snyder's avatar
Shane Snyder committed
464
    ssg_group_destroy_internal(g);
465

Shane Snyder's avatar
Shane Snyder committed
466
    return SSG_SUCCESS;
467 468
}

Shane Snyder's avatar
Shane Snyder committed
469 470
ssg_group_id_t ssg_group_join(
    ssg_group_id_t in_group_id,
471 472
    ssg_membership_update_cb update_cb,
    void * update_cb_dat)
473
{
Shane Snyder's avatar
Shane Snyder committed
474 475
    ssg_group_descriptor_t *in_group_descriptor = (ssg_group_descriptor_t *)in_group_id;
    char *self_addr_str = NULL;
476
    hg_addr_t group_target_addr = HG_ADDR_NULL;
Shane Snyder's avatar
Shane Snyder committed
477 478 479 480
    char *group_name = NULL;
    int group_size;
    void *view_buf = NULL;
    const char **addr_strs = NULL;
481
    hg_return_t hret;
482
    int sret;
Shane Snyder's avatar
Shane Snyder committed
483 484
    ssg_group_t *g = NULL;
    ssg_group_id_t g_id = SSG_GROUP_ID_NULL;
485

Shane Snyder's avatar
Shane Snyder committed
486
    if (!ssg_inst || in_group_id == SSG_GROUP_ID_NULL) goto fini;
487

Shane Snyder's avatar
Shane Snyder committed
488
    if (in_group_descriptor->owner_status == SSG_OWNER_IS_MEMBER)
489
    {
Shane Snyder's avatar
Shane Snyder committed
490
        fprintf(stderr, "Error: SSG unable to join a group it is already a member of\n");
491 492
        goto fini;
    }
Shane Snyder's avatar
Shane Snyder committed
493
    else if (in_group_descriptor->owner_status == SSG_OWNER_IS_ATTACHER)
494
    {
Shane Snyder's avatar
Shane Snyder committed
495
        fprintf(stderr, "Error: SSG unable to join a group it is attached to\n");
496 497
        goto fini;
    }
498

499 500 501 502 503 504 505 506 507
    /* lookup the address of the target group member in the GID */
    hret = margo_addr_lookup(ssg_inst->mid, in_group_descriptor->addr_str,
        &group_target_addr);
    if (hret != HG_SUCCESS) goto fini;

    sret = ssg_group_join_send(in_group_descriptor, group_target_addr,
        &group_name, &group_size, &view_buf);
    if (sret != SSG_SUCCESS || !group_name || !view_buf) goto fini;

Shane Snyder's avatar
Shane Snyder committed
508
    /* get my address string */
509
    SSG_GET_SELF_ADDR_STR(ssg_inst->mid, self_addr_str);
Jonathan Jenkins's avatar
Jonathan Jenkins committed
510 511
    if (self_addr_str == NULL) goto fini;

Shane Snyder's avatar
Shane Snyder committed
512 513
    /* set up address string array for all group members */
    addr_strs = ssg_addr_str_buf_to_list(view_buf, group_size);
514 515
    if (!addr_strs) goto fini;

Shane Snyder's avatar
Shane Snyder committed
516 517 518 519 520 521 522 523 524
    /* append self address string to list of group member address strings */
    addr_strs = realloc(addr_strs, (group_size+1)*sizeof(char *));
    if(!addr_strs) goto fini;
    addr_strs[group_size++] = self_addr_str;

    g = ssg_group_create_internal(group_name, addr_strs, group_size,
            update_cb, update_cb_dat);
    if (g)
    {
Shane Snyder's avatar
Shane Snyder committed
525
        g_id = (ssg_group_id_t)g->descriptor;
526 527 528

        /* don't free on success */
        group_name = NULL;
Shane Snyder's avatar
Shane Snyder committed
529
    }
Shane Snyder's avatar
Shane Snyder committed
530 531

fini:
532 533
    if (group_target_addr != HG_ADDR_NULL)
        margo_addr_free(ssg_inst->mid, group_target_addr);
Shane Snyder's avatar
Shane Snyder committed
534 535 536
    free(addr_strs);
    free(view_buf);
    free(group_name);
537
    free(self_addr_str);
538

Shane Snyder's avatar
Shane Snyder committed
539
    return g_id;
Shane Snyder's avatar
Shane Snyder committed
540 541
}

Shane Snyder's avatar
Shane Snyder committed
542
int ssg_group_leave(
543
    ssg_group_id_t group_id)
Shane Snyder's avatar
Shane Snyder committed
544
{
Shane Snyder's avatar
Shane Snyder committed
545
    ssg_group_descriptor_t *group_descriptor = (ssg_group_descriptor_t *)group_id;
546 547 548 549
    ssg_group_t *g = NULL;
    hg_addr_t group_target_addr = HG_ADDR_NULL;
    hg_return_t hret;
    int sret = SSG_FAILURE;
550

551
    if (!ssg_inst || group_id == SSG_GROUP_ID_NULL) goto fini;
552

553 554
    if (group_descriptor->owner_status != SSG_OWNER_IS_MEMBER)
    {
Shane Snyder's avatar
Shane Snyder committed
555
        fprintf(stderr, "Error: SSG unable to leave group it is not a member of\n");
556
        goto fini;
557 558
    }

559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593
    ABT_rwlock_rdlock(ssg_inst->lock);
    HASH_FIND(hh, ssg_inst->group_table, &group_descriptor->name_hash,
        sizeof(uint64_t), g);
    if (!g)
    {
        ABT_rwlock_unlock(ssg_inst->lock);
        goto fini;
    }

    /* send the leave req to the first member in the view */
    hret = margo_addr_dup(ssg_inst->mid, g->view.member_map->addr, &group_target_addr);
    if (hret != HG_SUCCESS)
    {
        ABT_rwlock_unlock(ssg_inst->lock);
        goto fini;
    }
    ABT_rwlock_unlock(ssg_inst->lock);

    sret = ssg_group_leave_send(group_descriptor, g->self_id, group_target_addr);
    if (sret != SSG_SUCCESS) goto fini;

    /* at least one group member knows of the leave request -- safe to
     * shutdown the group locally
     */

    /* re-lookup the group as we don't hold the lock while sending the leave req */
    ABT_rwlock_wrlock(ssg_inst->lock);
    HASH_FIND(hh, ssg_inst->group_table, &group_descriptor->name_hash,
        sizeof(uint64_t), g);
    if (g)
    {
        HASH_DELETE(hh, ssg_inst->group_table, g);
        ABT_rwlock_unlock(ssg_inst->lock);
        ssg_group_destroy_internal(g);
    }
Shane Snyder's avatar
Shane Snyder committed
594 595
    else
        ABT_rwlock_unlock(ssg_inst->lock);
596 597 598 599 600 601 602 603

    sret = SSG_SUCCESS;

fini:
    if (group_target_addr != HG_ADDR_NULL)
        margo_addr_free(ssg_inst->mid, group_target_addr);

    return sret;
Jonathan Jenkins's avatar
Jonathan Jenkins committed
604 605
}

606
#if 0
607 608 609
int ssg_group_attach(
    ssg_group_id_t group_id)
{
Shane Snyder's avatar
Shane Snyder committed
610
    ssg_group_descriptor_t *group_descriptor = (ssg_group_descriptor_t *)group_id;
611 612 613 614 615 616
    ssg_attached_group_t *ag = NULL;
    char *group_name = NULL;
    int group_size;
    void *view_buf = NULL;
    const char **addr_strs = NULL;
    int sret = SSG_FAILURE;
617

618
    if (!ssg_inst || group_id == SSG_GROUP_ID_NULL) goto fini;
619

620 621 622 623 624 625 626 627 628 629 630
    if (group_descriptor->owner_status == SSG_OWNER_IS_MEMBER)
    {
        fprintf(stderr, "Error: SSG unable to attach a group it is a member of\n");
        goto fini;
    }
    else if (group_descriptor->owner_status == SSG_OWNER_IS_ATTACHER)
    {
        fprintf(stderr, "Error: SSG unable to attach a group it is" \
            " already attached to\n");
        goto fini;
    }
631

632 633 634 635 636 637 638
    /* send the attach request to a group member to initiate a bulk transfer
     * of the group's membership view
     */
    sret = ssg_group_attach_send(group_descriptor, &group_name,
        &group_size, &view_buf);
    if (sret != SSG_SUCCESS || !group_name || !view_buf) goto fini;

Shane Snyder's avatar
Shane Snyder committed
639
    /* set up address string array for all group members */
640 641 642 643 644 645 646
    addr_strs = ssg_addr_str_buf_to_list(view_buf, group_size);
    if (!addr_strs) goto fini;

    /* allocate an SSG attached group data structure and initialize some of it */
    ag = malloc(sizeof(*ag));
    if (!ag) goto fini;
    memset(ag, 0, sizeof(*ag));
Shane Snyder's avatar
Shane Snyder committed
647
    ag->name = strdup(group_name);
648 649 650 651 652
    ag->descriptor = ssg_group_descriptor_dup(group_descriptor);
    if (!ag->descriptor) goto fini;
    ag->descriptor->owner_status = SSG_OWNER_IS_ATTACHER;

    /* create the view for the group */
Shane Snyder's avatar
Shane Snyder committed
653
    sret = ssg_group_view_create(addr_strs, group_size, NULL, ag->lock, &ag->view, NULL);
654 655 656 657 658 659 660 661 662
    if (sret != SSG_SUCCESS) goto fini;

    /* add this group reference to our group table */
    HASH_ADD(hh, ssg_inst->attached_group_table, descriptor->name_hash,
        sizeof(uint64_t), ag);

    sret = SSG_SUCCESS;

    /* don't free on success */
Shane Snyder's avatar
Shane Snyder committed
663
    group_name = NULL;
664 665
    ag = NULL;
fini:
Shane Snyder's avatar
Shane Snyder committed
666
    if (ag) ssg_attached_group_destroy(ag);
667
    free(addr_strs);
Shane Snyder's avatar
Shane Snyder committed
668 669
    free(view_buf);
    free(group_name);
670 671

    return sret;
672 673 674 675 676
}

int ssg_group_detach(
    ssg_group_id_t group_id)
{
677 678 679
    ssg_group_descriptor_t *group_descriptor = (ssg_group_descriptor_t *)group_id;
    ssg_attached_group_t *ag;

Shane Snyder's avatar
Shane Snyder committed
680 681
    if (!ssg_inst || group_id == SSG_GROUP_ID_NULL) return SSG_FAILURE;

682 683 684 685 686 687 688 689 690 691 692 693
    if (group_descriptor->owner_status != SSG_OWNER_IS_ATTACHER)
    {
        fprintf(stderr, "Error: SSG unable to detach from group that" \
            " was never attached\n");
        return SSG_FAILURE;
    }

    /* find the attached group structure and destroy it */
    HASH_FIND(hh, ssg_inst->attached_group_table, &group_descriptor->name_hash,
        sizeof(uint64_t), ag);
    if (!ag)
    {
Shane Snyder's avatar
Shane Snyder committed
694
        fprintf(stderr, "Error: SSG unable to find expected group attached\n");
695 696 697 698 699
        return SSG_FAILURE;
    }
    HASH_DELETE(hh, ssg_inst->attached_group_table, ag);
    ssg_attached_group_destroy(ag);

700 701
    return SSG_SUCCESS;
}
702
#endif
703

704 705 706
/*********************************
 *** SSG group access routines ***
 *********************************/
Shane Snyder's avatar
Shane Snyder committed
707

708
ssg_member_id_t ssg_get_group_self_id(
709
    ssg_group_id_t group_id)
Shane Snyder's avatar
Shane Snyder committed
710
{
Shane Snyder's avatar
Shane Snyder committed
711
    ssg_group_descriptor_t *group_descriptor = (ssg_group_descriptor_t *)group_id;
712
    ssg_group_t *g;
713
    ssg_member_id_t self_id;
714

Shane Snyder's avatar
Shane Snyder committed
715
    if (!ssg_inst || group_id == SSG_GROUP_ID_NULL) return SSG_MEMBER_ID_INVALID;
716

717 718 719 720
    if (group_descriptor->owner_status != SSG_OWNER_IS_MEMBER)
    {
        fprintf(stderr, "Error: SSG can only obtain a self ID from a group the" \
            " caller is a member of\n");
721
        return SSG_MEMBER_ID_INVALID;
722 723
    }

724
    ABT_rwlock_rdlock(ssg_inst->lock);
Shane Snyder's avatar
Shane Snyder committed
725 726
    HASH_FIND(hh, ssg_inst->group_table, &group_descriptor->name_hash,
        sizeof(uint64_t), g);
727 728 729 730 731
    if (g)
        self_id = g->self_id;
    else
        self_id = SSG_MEMBER_ID_INVALID;
    ABT_rwlock_unlock(ssg_inst->lock);
732

733
    return self_id;
Shane Snyder's avatar
Shane Snyder committed
734 735
}

736 737
int ssg_get_group_size(
    ssg_group_id_t group_id)
Shane Snyder's avatar
Shane Snyder committed
738
{
Shane Snyder's avatar
Shane Snyder committed
739
    ssg_group_descriptor_t *group_descriptor = (ssg_group_descriptor_t *)group_id;
Shane Snyder's avatar
Shane Snyder committed
740
    int group_size = 0;
741

Shane Snyder's avatar
Shane Snyder committed
742
    if (!ssg_inst || group_id == SSG_GROUP_ID_NULL) return 0;
743

744 745 746 747
    if (group_descriptor->owner_status == SSG_OWNER_IS_MEMBER)
    {
        ssg_group_t *g;

748
        ABT_rwlock_rdlock(ssg_inst->lock);
749 750 751
        HASH_FIND(hh, ssg_inst->group_table, &group_descriptor->name_hash,
            sizeof(uint64_t), g);
        if (g)
Shane Snyder's avatar
Shane Snyder committed
752 753 754 755 756
        {
            ABT_rwlock_rdlock(g->lock);
            group_size = g->view.size + 1; /* add ourself to view size */
            ABT_rwlock_unlock(g->lock);
        }
757
        ABT_rwlock_unlock(ssg_inst->lock);
758
    }
759
#if 0
760 761 762 763 764 765 766
    else if (group_descriptor->owner_status == SSG_OWNER_IS_ATTACHER)
    {
        ssg_attached_group_t *ag;

        HASH_FIND(hh, ssg_inst->attached_group_table, &group_descriptor->name_hash,
            sizeof(uint64_t), ag);
        if (ag)
Shane Snyder's avatar
Shane Snyder committed
767 768 769 770 771
        {
            ABT_rwlock_rdlock(ag->lock);
            group_size = ag->view.size;
            ABT_rwlock_unlock(ag->lock);
        }
772
    }
773
#endif
774 775 776 777
    else
    {
        fprintf(stderr, "Error: SSG can only obtain size of groups that the caller" \
            " is a member of or an attacher of\n");
778
        return 0;
779
    }
780

Shane Snyder's avatar
Shane Snyder committed
781
    return group_size;
Shane Snyder's avatar
Shane Snyder committed
782 783
}

784 785 786
hg_addr_t ssg_get_addr(
    ssg_group_id_t group_id,
    ssg_member_id_t member_id)
Shane Snyder's avatar
Shane Snyder committed
787
{
Shane Snyder's avatar
Shane Snyder committed
788
    ssg_group_descriptor_t *group_descriptor = (ssg_group_descriptor_t *)group_id;
789
    ssg_member_state_t *member_state;
Shane Snyder's avatar
Shane Snyder committed
790
    hg_addr_t member_addr = HG_ADDR_NULL;
791

792 793
    if (!ssg_inst || group_id == SSG_GROUP_ID_NULL ||
            member_id == SSG_MEMBER_ID_INVALID)
794 795
        return HG_ADDR_NULL;

796 797 798 799
    if (group_descriptor->owner_status == SSG_OWNER_IS_MEMBER)
    {
        ssg_group_t *g;

800
        ABT_rwlock_rdlock(ssg_inst->lock);
801 802 803
        HASH_FIND(hh, ssg_inst->group_table, &group_descriptor->name_hash,
            sizeof(uint64_t), g);
        if (g)
Shane Snyder's avatar
Shane Snyder committed
804 805 806 807 808 809 810 811
        {
            ABT_rwlock_rdlock(g->lock);
            HASH_FIND(hh, g->view.member_map, &member_id, sizeof(ssg_member_id_t),
                member_state);
            if (member_state) 
                member_addr = member_state->addr;
            ABT_rwlock_unlock(g->lock);
        }
812
        ABT_rwlock_unlock(ssg_inst->lock);
813
    }
814
#if 0
815 816 817 818 819 820 821
    else if (group_descriptor->owner_status == SSG_OWNER_IS_ATTACHER)
    {
        ssg_attached_group_t *ag;

        HASH_FIND(hh, ssg_inst->attached_group_table, &group_descriptor->name_hash,
            sizeof(uint64_t), ag);
        if (ag)
Shane Snyder's avatar
Shane Snyder committed
822 823 824 825 826 827 828 829
        {
            ABT_rwlock_rdlock(ag->lock);
            HASH_FIND(hh, ag->view.member_map, &member_id, sizeof(ssg_member_id_t),
                member_state);
            if (member_state) 
                member_addr = member_state->addr;
            ABT_rwlock_unlock(ag->lock);
        }
830
    }
831
#endif
832 833 834 835 836 837 838
    else
    {
        fprintf(stderr, "Error: SSG can only obtain member addresses of groups" \
            " that the caller is a member of or an attacher of\n");
        return HG_ADDR_NULL;
    }

Shane Snyder's avatar
Shane Snyder committed
839
    return member_addr;
840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856
}

ssg_group_id_t ssg_group_id_dup(
    ssg_group_id_t group_id)
{
    ssg_group_descriptor_t *dup;

    dup = ssg_group_descriptor_dup((ssg_group_descriptor_t *)group_id);
    return (ssg_group_id_t)dup;
}

void ssg_group_id_free(
    ssg_group_id_t group_id)
{
    ssg_group_descriptor_t *descriptor = (ssg_group_descriptor_t *)group_id;

    ssg_group_descriptor_free(descriptor);
Shane Snyder's avatar
Shane Snyder committed
857
    descriptor = SSG_GROUP_ID_NULL;
858 859 860
    return;
}

861 862 863 864 865 866 867 868
char *ssg_group_id_get_addr_str(
    ssg_group_id_t group_id)
{
    ssg_group_descriptor_t *group_descriptor = (ssg_group_descriptor_t *)group_id;

    return strdup(group_descriptor->addr_str);
}

869 870 871 872 873 874 875
void ssg_group_id_serialize(
    ssg_group_id_t group_id,
    char ** buf_p,
    size_t * buf_size_p)
{
    ssg_group_descriptor_t *group_descriptor = (ssg_group_descriptor_t *)group_id;
    size_t alloc_size;
876
    char *gid_buf, *p; 
877 878 879 880 881 882 883 884 885 886 887 888 889

    *buf_p = NULL;
    *buf_size_p = 0;

    /* determine needed buffer size */
    alloc_size = (sizeof(group_descriptor->magic_nr) + sizeof(group_descriptor->name_hash) +
        strlen(group_descriptor->addr_str) + 1);

    gid_buf = malloc(alloc_size);
    if (!gid_buf)
        return;

    /* serialize */
890 891 892 893 894 895
    p = gid_buf;
    *(uint64_t *)p = group_descriptor->magic_nr;
    p += sizeof(uint64_t);
    *(uint64_t *)p = group_descriptor->name_hash;
    p += sizeof(uint64_t);
    strcpy(p, group_descriptor->addr_str);
896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050
    /* the rest of the descriptor is stateful and not appropriate for serializing... */

    *buf_p = gid_buf;
    *buf_size_p = alloc_size;

    return;
}

void ssg_group_id_deserialize(
    const char * buf,
    size_t buf_size,
    ssg_group_id_t * group_id_p)
{
    size_t min_buf_size;
    uint64_t magic_nr;
    uint64_t name_hash;
    const char *addr_str;
    ssg_group_descriptor_t *group_descriptor;

    *group_id_p = SSG_GROUP_ID_NULL;

    /* check to ensure the buffer contains enough data to make a group ID */
    min_buf_size = (sizeof(group_descriptor->magic_nr) +
        sizeof(group_descriptor->name_hash) + 1);
    if (buf_size < min_buf_size)
    {
        fprintf(stderr, "Error: Serialized buffer does not contain a valid SSG group ID\n");
        return;
    }

    /* deserialize */
    magic_nr = *(uint64_t *)buf;
    if (magic_nr != SSG_MAGIC_NR)
    {
        fprintf(stderr, "Error: Magic number mismatch when deserializing SSG group ID\n");
        return;
    }
    buf += sizeof(uint64_t);
    name_hash = *(uint64_t *)buf;
    buf += sizeof(uint64_t);
    addr_str = buf;

    group_descriptor = ssg_group_descriptor_create(name_hash, addr_str,
        SSG_OWNER_IS_UNASSOCIATED);
    if (!group_descriptor)
        return;

    *group_id_p = (ssg_group_id_t)group_descriptor;

    return;
}

int ssg_group_id_store(
    const char * file_name,
    ssg_group_id_t group_id)
{
    int fd;
    char *buf;
    size_t buf_size;
    ssize_t bytes_written;

    fd = open(file_name, O_WRONLY | O_CREAT | O_TRUNC, 0644);
    if (fd < 0)
    {
        fprintf(stderr, "Error: Unable to open file %s for storing SSG group ID\n",
            file_name);
        return SSG_FAILURE;
    }

    ssg_group_id_serialize(group_id, &buf, &buf_size);
    if (buf == NULL)
    {
        fprintf(stderr, "Error: Unable to serialize SSG group ID.\n");
        close(fd);
        return SSG_FAILURE;
    }

    bytes_written = write(fd, buf, buf_size);
    if (bytes_written != (ssize_t)buf_size)
    {
        fprintf(stderr, "Error: Unable to write SSG group ID to file %s\n", file_name);
        close(fd);
        free(buf);
        return SSG_FAILURE;
    }

    close(fd);
    free(buf);
    return SSG_SUCCESS;
}

int ssg_group_id_load(
    const char * file_name,
    ssg_group_id_t * group_id_p)
{
    int fd;
    struct stat fstats;
    char *buf;
    ssize_t bytes_read;
    int ret;

    *group_id_p = SSG_GROUP_ID_NULL;

    fd = open(file_name, O_RDONLY);
    if (fd < 0)
    {
        fprintf(stderr, "Error: Unable to open file %s for loading SSG group ID\n",
            file_name);
        return SSG_FAILURE;
    }

    ret = fstat(fd, &fstats);
    if (ret != 0)
    {
        fprintf(stderr, "Error: Unable to stat file %s\n", file_name);
        close(fd);
        return SSG_FAILURE;
    }
    if (fstats.st_size == 0)
    {
        fprintf(stderr, "Error: SSG group ID file %s is empty\n", file_name);
        close(fd);
        return SSG_FAILURE;
    }

    buf = malloc(fstats.st_size);
    if (buf == NULL)
    {
        close(fd);
        return SSG_FAILURE;
    }

    bytes_read = read(fd, buf, fstats.st_size);
    if (bytes_read != (ssize_t)fstats.st_size)
    {
        fprintf(stderr, "Error: Unable to read SSG group ID from file %s\n", file_name);
        close(fd);
        free(buf);
        return SSG_FAILURE;
    }

    ssg_group_id_deserialize(buf, (size_t)bytes_read, group_id_p);
    if (*group_id_p == SSG_GROUP_ID_NULL)
    {
        fprintf(stderr, "Error: Unable to deserialize SSG group ID\n");
        close(fd);
        free(buf);
        return SSG_FAILURE;
    }

    close(fd);
    free(buf);
    return SSG_SUCCESS;
}

1051 1052 1053 1054 1055
void ssg_group_dump(
    ssg_group_id_t group_id)
{
    ssg_group_descriptor_t *group_descriptor = (ssg_group_descriptor_t *)group_id;
    ssg_group_view_t *group_view = NULL;
1056 1057
    ABT_rwlock group_view_lock;
    int group_size;
1058 1059 1060 1061 1062 1063 1064 1065
    char *group_name = NULL;
    char group_role[32];
    char group_self_id[32];

    if (group_descriptor->owner_status == SSG_OWNER_IS_MEMBER)
    {
        ssg_group_t *g;

1066
        ABT_rwlock_rdlock(ssg_inst->lock);
1067 1068 1069 1070 1071
        HASH_FIND(hh, ssg_inst->group_table, &group_descriptor->name_hash,
            sizeof(uint64_t), g);
        if (g)
        {
            group_view = &g->view;
1072 1073
            group_view_lock = g->lock;
            group_size = g->view.size + 1;
1074 1075
            group_name = g->name;
            strcpy(group_role, "member");
1076
            sprintf(group_self_id, "%lu", g->self_id);
1077
        }
1078
        ABT_rwlock_unlock(ssg_inst->lock);
1079
    }
1080
#if 0
1081 1082 1083 1084 1085 1086 1087 1088 1089
    else if (group_descriptor->owner_status == SSG_OWNER_IS_ATTACHER)
    {
        ssg_attached_group_t *ag;

        HASH_FIND(hh, ssg_inst->attached_group_table, &group_descriptor->name_hash,
            sizeof(uint64_t), ag);
        if (ag)
        {
            group_view = &ag->view;
1090
            group_size = ag->view.size;
1091 1092 1093 1094
            group_name = ag->name;
            strcpy(group_role, "attacher");
        }
    }
1095
#endif
1096 1097 1098 1099 1100 1101 1102 1103 1104
    else
    {
        fprintf(stderr, "Error: SSG can only dump membership information for" \
            " groups that the caller is a member of or an attacher of\n");
        return;
    }

    if (group_view)
    {
1105
        ssg_member_state_t *member_state, *tmp_ms;
1106 1107 1108 1109 1110

        printf("SSG membership information for group '%s':\n", group_name);
        printf("\trole: '%s'\n", group_role);
        if (strcmp(group_role, "member") == 0)
            printf("\tself_id: %s\n", group_self_id);
1111
        printf("\tsize: %d\n", group_size);
1112
        printf("\tview:\n");
1113
        ABT_rwlock_rdlock(group_view_lock);
1114
        HASH_ITER(hh, group_view->member_map, member_state, tmp_ms)
1115
        {
Shane Snyder's avatar
Shane Snyder committed
1116
            printf("\t\tid: %20lu\taddr: %s\n", member_state->id,
1117
                member_state->addr_str);
1118
        }
1119
        ABT_rwlock_unlock(group_view_lock);
1120 1121 1122 1123
    }
    else
        fprintf(stderr, "Error: SSG unable to find group view associated" \
            " with the given group ID\n");
1124

1125
    return;
Shane Snyder's avatar
Shane Snyder committed
1126 1127
}

1128 1129 1130
/************************************
 *** SSG internal helper routines ***
 ************************************/
1131

Shane Snyder's avatar
Shane Snyder committed
1132 1133 1134
static ssg_group_t * ssg_group_create_internal(
    const char * group_name, const char * const group_addr_strs[],
    int group_size, ssg_membership_update_cb update_cb, void *update_cb_dat)
1135
{
Shane Snyder's avatar
Shane Snyder committed
1136 1137 1138 1139
    uint64_t name_hash;
    char *self_addr_str = NULL;
    int sret;
    int success = 0;
1140
    ssg_group_t *g = NULL, *check_g;
1141

Shane Snyder's avatar
Shane Snyder committed
1142
    if (!ssg_inst) return NULL;
Shane Snyder's avatar
Shane Snyder committed
1143

Shane Snyder's avatar
Shane Snyder committed
1144 1145 1146
    name_hash = ssg_hash64_str(group_name);

    /* get my address string */
1147
    SSG_GET_SELF_ADDR_STR(ssg_inst->mid, self_addr_str);
Shane Snyder's avatar
Shane Snyder committed
1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169
    if (self_addr_str == NULL) goto fini;

    /* allocate an SSG group data structure and initialize some of it */
    g = malloc(sizeof(*g));
    if (!g) goto fini;
    memset(g, 0, sizeof(*g));
    g->name = strdup(group_name);
    if (!g->name) goto fini;
    g->update_cb = update_cb;
    g->update_cb_dat = update_cb_dat;
    ABT_rwlock_create(&g->lock);

    /* generate unique descriptor for this group  */
    g->descriptor = ssg_group_descriptor_create(name_hash, self_addr_str,
        SSG_OWNER_IS_MEMBER);
    if (g->descriptor == NULL) goto fini;

    /* initialize the group view */
    sret = ssg_group_view_create(group_addr_strs, group_size, self_addr_str,
        g->lock, &g->view, &g->self_id);
    if (sret != SSG_SUCCESS) goto fini;
    if (g->self_id == SSG_MEMBER_ID_INVALID)
Shane Snyder's avatar
Shane Snyder committed
1170
    {
Shane Snyder's avatar
Shane Snyder committed
1171 1172 1173 1174
        /* if unable to resolve my rank within the group, error out */
        fprintf(stderr, "Error: SSG unable to resolve rank in group %s\n",
            group_name);
        goto fini;
Shane Snyder's avatar
Shane Snyder committed
1175
    }
1176

1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193
#ifdef DEBUG
    /* set debug output pointer */
    char *dbg_log_dir = getenv("SSG_DEBUG_LOGDIR");
    if (dbg_log_dir)
    {
        char dbg_log_path[PATH_MAX];
        snprintf(dbg_log_path, PATH_MAX, "%s/ssg-%s-%lu.log",
            dbg_log_dir, g->name, g->self_id);
        g->dbg_log = fopen(dbg_log_path, "a");
        if (!g->dbg_log) goto fini;
    }
    else
    {
        g->dbg_log = stdout;
    }
#endif

1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204
    /* make sure we aren't re-creating an existing group */
    ABT_rwlock_wrlock(ssg_inst->lock);
    HASH_FIND(hh, ssg_inst->group_table, &name_hash, sizeof(uint64_t), check_g);
    if (check_g) goto fini;

    /* add this group reference to the group table */
    HASH_ADD(hh, ssg_inst->group_table, descriptor->name_hash,
        sizeof(uint64_t), g);
    ABT_rwlock_unlock(ssg_inst->lock);

    /* initialize swim failure detector */
Shane Snyder's avatar
Shane Snyder committed
1205 1206
    sret = swim_init(g, ssg_inst->mid, 1);
    if (sret != SSG_SUCCESS)
1207 1208 1209 1210 1211 1212 1213 1214
    {
        ABT_rwlock_wrlock(ssg_inst->lock);
        HASH_DELETE(hh, ssg_inst->group_table, g);
        ABT_rwlock_unlock(ssg_inst->lock);
        goto fini;
    }

    SSG_DEBUG(g, "group create successful (size=%d, self=%s)\n", group_size, self_addr_str);
Shane Snyder's avatar
Shane Snyder committed
1215
    success = 1;
1216

Shane Snyder's avatar
Shane Snyder committed
1217 1218
fini:
    if (!success && g)
1219
    {
1220 1221 1222 1223 1224
#ifdef DEBUG
        /* if using logfile debug output, close the stream */
        if (getenv("SSG_DEBUG_LOGDIR"))
            fclose(g->dbg_log);
#endif
Shane Snyder's avatar
Shane Snyder committed
1225 1226
        if (g->descriptor) ssg_group_descriptor_free(g->descriptor);
        ssg_group_view_destroy(&g->view);
1227
        ABT_rwlock_free(&g->lock);
Shane Snyder's avatar
Shane Snyder committed
1228 1229 1230
        free(g->name);
        free(g);
        g = NULL;
1231
    }
Shane Snyder's avatar
Shane Snyder committed
1232 1233 1234
    free(self_addr_str);

    return g;
1235
}
1236

1237
static int ssg_group_view_create(
1238
    const char * const group_addr_strs[], int group_size,
Shane Snyder's avatar
Shane Snyder committed
1239 1240
    const char * self_addr_str, ABT_rwlock view_lock,
    ssg_group_view_t * view, ssg_member_id_t * self_id)
1241 1242
{
    int i, j, r;
1243 1244
    ABT_thread *lookup_ults = NULL;
    struct ssg_group_lookup_ult_args *lookup_ult_args = NULL;
1245 1246 1247
    const char *self_addr_substr = NULL;
    const char *addr_substr = NULL;
    int aret;
1248
    int sret = SSG_FAILURE;
1249

1250 1251 1252
    if (self_id)
        *self_id = SSG_MEMBER_ID_INVALID;
        
Shane Snyder's avatar
Shane Snyder committed
1253
    if ((self_id != NULL && self_addr_str == NULL) || !view) goto fini;
Shane Snyder's avatar
Shane Snyder committed
1254

1255 1256
    /* allocate lookup ULTs */
    lookup_ults = malloc(group_size * sizeof(*lookup_ults));
1257 1258
    if (lookup_ults == NULL) goto fini;
    for (i = 0; i < group_size; i++) lookup_ults[i] = ABT_THREAD_NULL;
1259
    lookup_ult_args = malloc(group_size * sizeof(*lookup_ult_args));
1260
    if (lookup_ult_args == NULL) goto fini;
Shane Snyder's avatar
Shane Snyder committed
1261

Shane Snyder's avatar
Shane Snyder committed
1262
    if(self_addr_str)
1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274
    {
        /* strstr is used here b/c there may be inconsistencies in whether the class
         * is included in the address or not (it should not be in HG_Addr_to_string,
         * but it's possible that it is in the list of group address strings)
         */
        self_addr_substr = strstr(self_addr_str, "://");
        if (self_addr_substr == NULL)
            self_addr_substr = self_addr_str;
        else
            self_addr_substr += 3;
    }

1275
    /* construct view using ULTs to lookup the address of each group member */
Shane Snyder's avatar
Shane Snyder committed
1276
    r = rand() % group_size;
1277 1278 1279 1280 1281
    for (i = 0; i < group_size; i++)
    {
        /* randomize our starting index so all group members aren't looking
         * up other group members in the same order
         */
Shane Snyder's avatar
Shane Snyder committed
1282
        j = (r + i) % group_size;
1283

1284 1285
        if (group_addr_strs[j] == NULL || strlen(group_addr_strs[j]) == 0) continue;

1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296
        /* resolve self id in group if caller asked for it */
        if (self_addr_substr)
        {
            addr_substr = strstr(group_addr_strs[j], "://");
            if (addr_substr == NULL)
                addr_substr = group_addr_strs[j];
            else
                addr_substr += 3;

            if (strcmp(self_addr_substr, addr_substr) == 0)
            {
1297
                if (self_id)               
1298
                    *self_id = ssg_gen_member_id(group_addr_strs[j]);
1299 1300 1301

                /* don't look up our own address, we already know it */
                continue;
1302 1303 1304 1305
            }
        }

        /* XXX limit outstanding lookups to some max */
1306
        lookup_ult_args[j].addr_str = group_addr_strs[j];
1307
        lookup_ult_args[j].view = view;
Shane Snyder's avatar
Shane Snyder committed
1308
        lookup_ult_args[j].lock = view_lock;
1309 1310
        ABT_pool pool;
        margo_get_handler_pool(ssg_inst->mid, &pool);
1311 1312
        aret = ABT_thread_create(pool, &ssg_group_lookup_ult,
            &lookup_ult_args[j], ABT_THREAD_ATTR_NULL,
1313
            &lookup_ults[j]);
1314
        if (aret != ABT_SUCCESS) goto fini;
Shane Snyder's avatar