Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PMIX_INIT(3)			    OpenPMIx			    PMIX_INIT(3)

PMIx_Init - Initialize the PMIx Client

SYNOPSIS
	#include <pmix.h>

	pmix_status_t PMIx_Init(pmix_proc_t *proc);

ARGUMENTS
     * proc: Pointer to a pmix_proc_t object in which the clientas namespace and
       rank are to be returned.

DESCRIPTION
     Initialize  the  PMIx  client, returning the process identifier assigned to
     this clientas application in the provided pmix_proc_t struct. Passing a pa-
     rameter of NULL for this parameter is allowed if the user wishes solely  to
     initialize the PMIx system and does not require return of the identifier at
     that time.

     When  called, the PMIx client will check for the required connection infor-
     mation of the local PMIx server and will establish the connection.  If  the
     information is not found, or the server connection fails, then an appropri-
     ate error constant will be returned.

     If successful, the function will return PMIX_SUCCESS and will fill the pro-
     vided  structure with the server-assigned namespace and rank of the process
     within the application.

     Note that the PMIx client library is referenced counted,  and  so	multiple
     calls  to	PMIx_Init are allowed. Thus, one way to obtain the namespace and
     rank of the process is to simply call PMIx_Init with a non-NULL parameter.

RETURN VALUE
     Returns PMIX_SUCCESS on success. On error, a negative  value  corresponding
     to a PMIx errno is returned.

ERRORS
     PMIx errno values are defined in pmix_common.h.

     See also:
	PMIx_Initialized(3),  PMIx_Abort(3)  <#man3-pmix-abort>, PMIx_Commit(3),
	PMIx_Finalize(3) <#man3-pmix-finalize>, PMIx_Put(3),  pmiAddInstance(3),
	pmiAddMetric(3)

Copyright
     2014-2026, OpenPMIx Community

				  Jan 24, 2026			    PMIX_INIT(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=PMIx_Init&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help