Scroll to navigation

PMIX_XFER_PROCID(3) OpenPMIx PMIX_XFER_PROCID(3)

PMIx_Xfer_procid — Copy one pmix_proc_t(5) <#man5-pmix-proc-t> into another

SYNOPSIS

#include <pmix.h>
void PMIx_Xfer_procid(pmix_proc_t *dst,


                      const pmix_proc_t *src);


Python Syntax

No Python equivalent

INPUT/OUTPUT PARAMETERS

  • dst: Pointer to the destination pmix_proc_t(5) <#man5-pmix-proc-t> structure. The storage must already exist — it is supplied by the caller. Its contents are overwritten.
  • src: Pointer to the source pmix_proc_t(5) <#man5-pmix-proc-t> structure to be copied.

DESCRIPTION

Perform a non-destructive transfer of a process identifier by copying the entire pmix_proc_t <#man5-pmix-proc-t> structure — both the nspace and rank fields — from src to dst. The copy is a simple byte-for-byte memcpy of sizeof(pmix_proc_t) bytes.

Because a pmix_proc_t <#man5-pmix-proc-t> contains no heap-allocated members (the namespace is a fixed-size embedded array), no memory is allocated or freed and src is left unchanged. Callers that already hold the namespace and rank as separate values can instead use PMIx_Load_procid(3) <#man3-pmix-load-procid>.

RETURN VALUE

PMIx_Xfer_procid returns no value (void).

NOTES

PMIx_Xfer_procid is an OpenPMIx convenience routine and is the backing implementation of the PMIX_XFER_PROCID macro. Both arguments must point to valid structures; the routine performs no NULL checking.

See also:

PMIx_Load_procid(3) <#man3-pmix-load-procid>, PMIx_Check_procid(3) <#man3-pmix-check-procid>, pmix_proc_t(5) <#man5-pmix-proc-t>


Copyright

2014-2026, OpenPMIx Community

September 27, 2026