rsm_memseg_import_init_barrier(3RSM)		      Remote Shared Memory Library Functions		      rsm_memseg_import_init_barrier(3RSM)

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  bar-
       rier 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)

SunOS 5.11							    8 Jun 2001				      rsm_memseg_import_init_barrier(3RSM)