<no title> — OpenPMIx 6.1.1rc2 documentation

    /*
     * Copyright (c) 2004-2010 The Trustees of Indiana University and Indiana
     *                         University Research and Technology
     *                         Corporation.  All rights reserved.
     * Copyright (c) 2004-2011 The University of Tennessee and The University
     *                         of Tennessee Research Foundation.  All rights
     *                         reserved.
     * Copyright (c) 2004-2005 High Performance Computing Center Stuttgart,
     *                         University of Stuttgart.  All rights reserved.
     * Copyright (c) 2004-2005 The Regents of the University of California.
     *                         All rights reserved.
     * Copyright (c) 2006-2013 Los Alamos National Security, LLC.
     *                         All rights reserved.
     * Copyright (c) 2009-2012 Cisco Systems, Inc.  All rights reserved.
     * Copyright (c) 2011      Oak Ridge National Labs.  All rights reserved.
     * Copyright (c) 2013-2020 Intel, Inc.  All rights reserved.
     * Copyright (c) 2015      Mellanox Technologies, Inc.  All rights reserved.
     * Copyright (c) 2019      IBM Corporation.  All rights reserved.
     * Copyright (c) 2021-2025 Nanook Consulting  All rights reserved.
     * $COPYRIGHT$
     *
     * Additional copyrights may follow
     *
     * $HEADER$
     *
     */

    #include <pthread.h>
    #include <stdbool.h>
    #include <stdio.h>
    #include <stdlib.h>
    #include <time.h>
    #include <unistd.h>
    #include <libgen.h>

    #include <pmix.h>

    int main(int argc, char **argv)
    {
        pmix_proc_t myproc;
        int rc, ret;
        pmix_value_t *val = NULL;
        uint32_t nprocs;
        pmix_proc_t proc, *parray = NULL;
        pmix_info_t *results = NULL, info[3];
        size_t nresults, cid, n, m, psize = 0;
        pmix_data_array_t dry;
        char hostname[1024];

        gethostname(hostname, 1024);

        /* init us */
        if (PMIX_SUCCESS != (rc = PMIx_Init(&myproc, NULL, 0))) {
            fprintf(stderr, "Client ns %s rank %d: PMIx_Init failed: %s\n", myproc.nspace, myproc.rank,
                    PMIx_Error_string(rc));
            exit(1);
        }
        fprintf(stderr, "Client ns %s rank %d: Running on host %s\n", myproc.nspace, myproc.rank, hostname);

        PMIX_PROC_CONSTRUCT(&proc);
        PMIX_LOAD_PROCID(&proc, myproc.nspace, PMIX_RANK_WILDCARD);

        /* get our job size */
        if (PMIX_SUCCESS != (rc = PMIx_Get(&proc, PMIX_JOB_SIZE, NULL, 0, &val))) {
            fprintf(stderr, "Client ns %s rank %d: PMIx_Get job size failed: %s\n", myproc.nspace,
                    myproc.rank, PMIx_Error_string(rc));
            goto done;
        }
        nprocs = val->data.uint32;
        PMIX_VALUE_RELEASE(val);
        if (nprocs < 6) {
            if (0 == myproc.rank) {
                fprintf(stderr, "This example with add-members requires a minimum of 6 processes\n");
            }
            exit(1);
        }
        fprintf(stderr, "Client %s:%d job size %u\n", myproc.nspace, myproc.rank, nprocs);

        /* call fence to sync */
        PMIX_PROC_CONSTRUCT(&proc);
        PMIX_LOAD_PROCID(&proc, myproc.nspace, PMIX_RANK_WILDCARD);
        if (PMIX_SUCCESS != (rc = PMIx_Fence(&proc, 1, NULL, 0))) {
            fprintf(stderr, "Client ns %s rank %d: PMIx_Fence failed: %d\n", myproc.nspace, myproc.rank,
                    rc);
            goto done;
        }

        /* rank=0 and 3 bootstrap a new group */
        if (0 == myproc.rank || 3 == myproc.rank) {
            fprintf(stderr, "%d executing Group_construct\n", myproc.rank);
            PMIX_INFO_LOAD(&info[0], PMIX_GROUP_ASSIGN_CONTEXT_ID, NULL, PMIX_BOOL);
            // two procs are performing the bootstrap
            n = 2;
            PMIX_INFO_LOAD(&info[1], PMIX_GROUP_BOOTSTRAP, &n, PMIX_SIZE);

            PMIX_DATA_ARRAY_CONSTRUCT(&dry, 1, PMIX_PROC);
            parray = (pmix_proc_t*)dry.array;
            if (3 == myproc.rank) {
                fprintf(stderr, "[%u]: Adding members\n", myproc.rank);
                PMIX_LOAD_PROCID(&parray[0], myproc.nspace, 4);
            } else {
                fprintf(stderr, "[%u]: Adding members\n", myproc.rank);
                PMIX_LOAD_PROCID(&parray[0], myproc.nspace, 5);
            }
            PMIX_INFO_LOAD(&info[2], PMIX_GROUP_ADD_MEMBERS, &dry, PMIX_DATA_ARRAY);
            PMIX_DATA_ARRAY_DESTRUCT(&dry);
            rc = PMIx_Group_construct("ourgroup", &myproc, 1, info, 3, &results, &nresults);
            if (PMIX_SUCCESS != rc) {
                fprintf(stderr, "Client ns %s rank %d: PMIx_Group_construct failed: %s\n",
                        myproc.nspace, myproc.rank, PMIx_Error_string(rc));
                goto done;
            }
        } else if (4 == myproc.rank || 5 == myproc.rank) {
            fprintf(stderr, "%d executing Group_construct\n", myproc.rank);
            fflush(stderr);
            rc = PMIx_Group_construct("ourgroup", NULL, 0, NULL, 0, &results, &nresults);
            if (PMIX_SUCCESS != rc) {
                fprintf(stderr, "Client ns %s rank %d: PMIx_Group_construct failed: %s\n",
                        myproc.nspace, myproc.rank, PMIx_Error_string(rc));
                goto done;
            }
        }
        fprintf(stderr, "%d GROUP CONSTRUCT COMPLETE\n", myproc.rank);
        fflush(stderr);

        if (0 == myproc.rank || 3 == myproc.rank ||
            4 == myproc.rank || 5 == myproc.rank) {
            /* we should have a single results object */
            if (NULL != results) {
                cid = 0;
                for (n=0; n < nresults; n++) {
                    if (PMIX_CHECK_KEY(&results[n], PMIX_GROUP_CONTEXT_ID)) {
                        PMIX_VALUE_GET_NUMBER(rc, &results[n].value, cid, size_t);
                        fprintf(stderr, "%d Group construct complete with status %s KEY %s CID %lu\n",
                                myproc.rank, PMIx_Error_string(rc), results[n].key, (unsigned long) cid);
                    } else if (PMIX_CHECK_KEY(&results[n], PMIX_GROUP_MEMBERSHIP)) {
                        parray = (pmix_proc_t*)results[n].value.data.darray->array;
                        psize = results[n].value.data.darray->size;
                        fprintf(stderr, "[%u] NUM MEMBERS: %u MEMBERSHIP:\n", myproc.rank, (unsigned)psize);
                        for (m=0; m < psize; m++) {
                            fprintf(stderr, "\t%s:%u\n", parray[m].nspace, parray[m].rank);
                        }
                    }
                }
            } else {
                fprintf(stderr, "%d Group construct complete, but no results returned\n", myproc.rank);
            }
            if (NULL == parray) {
                fprintf(stderr, "%d NULL proc array\n", myproc.rank);
                goto done;
            }

            fprintf(stderr, "%d Executing group fence\n", myproc.rank);
            PMIX_PROC_CONSTRUCT(&proc);
            PMIX_LOAD_PROCID(&proc, "ourgroup", PMIX_RANK_WILDCARD);
            if (PMIX_SUCCESS != (rc = PMIx_Fence(&proc, 1, NULL, 0))) {
                fprintf(stderr, "Client ns %s rank %d: PMIx_Fence failed: %d\n", myproc.nspace, myproc.rank,
                        rc);
                goto done;
            }

            fprintf(stderr, "%d executing Group_destruct\n", myproc.rank);
            rc = PMIx_Group_destruct("ourgroup", NULL, 0);
            if (PMIX_SUCCESS != rc) {
                fprintf(stderr, "Client ns %s rank %d: PMIx_Group_destruct failed: %s\n", myproc.nspace,
                        myproc.rank, PMIx_Error_string(rc));
                goto done;
            }
        }

    done:
        /* finalize us */
        fprintf(stderr, "Client ns %s rank %d: Finalizing\n", myproc.nspace, myproc.rank);
        if (PMIX_SUCCESS != (ret = PMIx_Finalize(NULL, 0))) {
            fprintf(stderr, "Client ns %s rank %d:PMIx_Finalize failed: %s\n", myproc.nspace,
                    myproc.rank, PMIx_Error_string(ret));
            rc = ret;
        } else {
            fprintf(stderr, "Client ns %s rank %d:PMIx_Finalize successfully completed\n",
                    myproc.nspace, myproc.rank);
        }
        fprintf(stderr, "%s:%d COMPLETE\n", myproc.nspace, myproc.rank);
        fflush(stderr);
        return (rc);
    }