Summary

Shares the segment which was previously created as a shared symmetric heap
segment

Synopsis

dsmml_return_t dsmml_share_ssheap_seg(int segment_id);

Arguments

segment_id   segment id

Description

Shares the segment which was previously created as a shared symmetric
heap segment using the dsmml_create_ssheap_seg(3) operation. To process
this operation, all clients has to make sure that the segment is created
in all processes where the segment is to be shared. Hence, a barrier-like
operation is required before calling this routine.

Shared symmetric heap segments are usable only after being shared and
initialized. It is initialized using dsmml_init_ssheap_seg(3).

Return Values

DSMML_RC_SUCCESS         - segment successfully initialized
DSMML_RC_INVALID_PARAM   - invalid parameter like NULL pointer passed
DSMML_RC_RESOURCE_ERROR  - unavailable memkind or hugepage size requested
DSMML_RC_NO_MEMORY       - heap memory cannot be mapped or heap too huge
DSMML_RC_UNKNOWN_FAIL    - unknown error

Notes

Refer dsmml_create_ssheap_seg(3), dsmml_init_ssheap_seg(3)