Manual Pages for UNIX Operating System command usage for man rsm_memseg_import_open_barrier

Remote Shared Memory Library Functions
                             rsm_memseg_import_open_barrier(3RSM)



NAME
     rsm_memseg_import_open_barrier,
     rsm_memseg_import_order_barrier,
     rsm_memseg_import_close_barrier - remote memory access error
     detection functions

SYNOPSIS
     cc [ flag... ] file... -lrsm [ library... ]
     #include 

     int rsm_memseg_import_open_barrier(rsmapi_barrier_t *barrier);


     int rsm_memseg_import_order_barrier(rsmapi_barrier_t *barrier);


     int rsm_memseg_import_close_barrier(rsmapi_barrier_t *barrier);


DESCRIPTION
     The           rsm_memseg_import_open_barrier()           and
     rsm_memseg_import_close_barrier()  functions provide a means
     of remote memory access error  detection  when  the  barrier
     mode  is  set  to  RSM_BARRIER_MODE_EXPLICIT. Open and close
     barrier operations define a span-of-time interval for  error
     detection. A successful close barrier guarantees that remote
     memory access covered between the  open  barrier  and  close
     barrier have completed successfully. Any individual failures
     which may have occured between the open  barrier  and  close
     barrier  occur  without  any notification and the failure is
     not reported until the close barrier.


     The rsm_memseg_import_order_barrier() function  imposes  the
     order-of-write  completion  whereby,  with an order barrier,
     the write operations issued before the order barrier are all
     completed  before  the  operations  after the order barrier.
     Effectively, with the order barrier call, all writes  within
     one  barrier  scope  are  ordered  with  respect to those in
     another barrier scope.

RETURN VALUES
     Upon successful completion, these functions return 0. Other-
     wise, an error value is returned to indicate the error.

ERRORS
     The                        rsm_memseg_import_open_barrier(),
     rsm_memseg_import_order_barrier(),                       and
     rsm_memseg_import_close_barrier() functions can  return  the
     following errors:




SunOS 5.11           Last change: 8 Jun 2001                    1






Remote Shared Memory Library Functions
                             rsm_memseg_import_open_barrier(3RSM)



     RSMERR_BAD_SEG_HNDL        Invalid segment handle


     RSMERR_BAD_BARRIER_PTR     Invalid barrier pointer.



     The              rsm_memseg_close_barrier()              and
     rsm_memseg_order_barrier()  functions can return the follow-
     ing errors:

     RSMERR_BARRIER_UNINITIALIZED

         Barrier not initialized.


     RSMERR_BARRIER_NOT_OPENED

         Barrier not opened.


     RSMERR_BARRIER_FAILURE

         Memory access error.


     RSMERR_CONN_ABORTED

         Connection aborted.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    | ATTRIBUTE TYPE              | ATTRIBUTE VALUE             |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     rsm_memseg_import_init_barrier(3RSM),
     rsm_memseg_import_set_mode(3RSM), attributes(5)





SunOS 5.11           Last change: 8 Jun 2001                    2






Remote Shared Memory Library Functions
                             rsm_memseg_import_open_barrier(3RSM)






















































SunOS 5.11           Last change: 8 Jun 2001                    3