Remote Shared Memory Library Functions
                             rsmmemsegimportopenbarrier(3RSM)



NAME
     rsmmemsegimportopenbarrier,
     rsmmemsegimportorderbarrier,
     rsmmemsegimportclosebarrier - remote memory access error
     detection functions

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

     int rsmmemsegimportopenbarrier(rsmapibarriert *barrier);


     int rsmmemsegimportorderbarrier(rsmapibarriert *barrier);


     int rsmmemsegimportclosebarrier(rsmapibarriert *barrier);


DESCRIPTION
     The           rsmmemsegimportopenbarrier()           and
     rsmmemsegimportclosebarrier()  functions provide a means
     of remote memory access error  detection  when  the  barrier
     mode  is  set  to  RSMBARIERMODEXPLICIT. 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 rsmmemsegimportorderbarrier() 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.

ERORS
     The                        rsmmemsegimportopenbarrier(),
     rsmmemsegimportorderbarrier(),                       and
     rsmmemsegimportclosebarrier() functions can  return  the
     following errors:




SunOS 5.11           Last change: 8 Jun 2001                    1






Remote Shared Memory Library Functions
                             rsmmemsegimportopenbarrier(3RSM)



     RSMERBADSEGHNDL        Invalid segment handle


     RSMERBADBARIERPTR     Invalid barrier pointer.



     The              rsmmemsegclosebarrier()              and
     rsmmemsegorderbarrier()  functions can return the follow-
     ing errors:

     RSMERBARIERUNINITIALIZED

         Barrier not initialized.


     RSMERBARIERNOTOPENED

         Barrier not opened.


     RSMERBARIERFAILURE

         Memory access error.


     RSMERCONABORTED

         Connection aborted.


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



     
     ATRIBUTE TYPE               ATRIBUTE VALUE             
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     rsmmemsegimportinitbarrier(3RSM),
     rsmmemsegimportsetmode(3RSM), attributes(5)





SunOS 5.11           Last change: 8 Jun 2001                    2






Remote Shared Memory Library Functions
                             rsmmemsegimportopenbarrier(3RSM)






















































SunOS 5.11           Last change: 8 Jun 2001                    3