RSM_MEMSEG_IMPORT_INIT_BARRIER(3RSM) Remote Shared Memory Library Functions


NAME


rsm_memseg_import_init_barrier, rsm_memseg_import_destroy_barrier -
create or destroy barrier for imported segment

SYNOPSIS


cc [ flag... ] file... -lrsm [ library... ]
#include <rsmapi.h>

int rsm_memseg_import_init_barrier(
rsm_memseg_import_handle_t memseg, rsm_barrier_type_t type,
rsmapi_barrier_t *barrier);


int rsm_memseg_import_destroy_barrier(rsmapi_barrier_t *barrier);


DESCRIPTION


The rsm_memseg_import_init_barrier() function creates a barrier for the
imported segment specified by memseg. The barrier type is specified by
the type argument. Currently, only RSM_BAR_DEFAULT is supported as a
barrier type. A handle to the barrier is obtained through the barrier
argument and is used in subsequent barrier calls.


The rsm_memseg_import_destroy_barrier() function deallocates all the
resources associated with the barrier.

RETURN VALUES


Upon successful completion, these functions return 0. Otherwise, an error
value is returned to indicate the error.

ERRORS


The rsm_memseg_import_init_barrier() and
rsm_memseg_import_destroy_barrier() functions can return the following
errors:

RSMERR_BAD_SEG_HNDL
Invalid segment handle.


RSMERR_BAD_BARRIER_PTR
Invalid barrier pointer.


The rsm_memseg_import_init_barrier() function can return the following
errors:

RSMERR_INSUFFICIENT_MEM
Insufficient memory.


ATTRIBUTES


See attributes(5) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO


rsm_memseg_import_open_barrier(3RSM), rsm_memseg_import_set_mode(3RSM),
attributes(5)


June 8, 2001
RSM_MEMSEG_IMPORT_INIT_BARRIER(3RSM)