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(7) 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(7)

June 8, 2001
RSM_MEMSEG_IMPORT_INIT_BARRIER(3RSM)