Remote Shared Memory Library Functions
                                       rsmintrsignalpost(3RSM)



NAME
     rsmintrsignalpost, rsmintrsignalwait - signal or  wait
     for an event

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

     int rsmintrsignalpost(void *memseg, uintt flags);


     int rsmintrsignalwait(void *memseg, int timeout);


DESCRIPTION
     The   rsmintrsignalpost()   and    rsmintrsignalwait()
     functions  are  event  functions  that allow synchronization
     between importer processes and exporter processes.   A  pro-
     cess  may  block  to  wait for an event occurance by calling
     rsmintrsignalwait(). A process can signal a waiting  pro-
     cess when an event occurs by calling rsmintrsignalpost().


     The rsmintrsignalpost() function signals an  event  occu-
     rance.      Either      an     import     segment     handle
     (rsmmemsegimporthandlet) or  an  export  segment  handle
     (rsmmemsegexporthandlet)  may  be  type  cast  to a void
     pointer for the memseg argument.  If  memseg  refers  to  an
     import handle, the exporting process is signalled. If memseg
     refers to an export handle, all importers  of  that  segment
     are   signalled.   The   flags   argument   may  be  set  to
     RSMSIGPOSTNOACUMULATE; this will cause this event to  be
     discarded if an event is already pending for the target seg-
     ment.


     The rsmintrsignalwait()  function  allows  a  process  to
     block and wait for an event occurance. Either an import seg-
     ment handle (rsmmemsegimporthandlet) or an  export  seg-
     ment handle (rsmmemsegexporthandlet) may be type cast to
     a void pointer for the memseg argument. The  process  blocks
     for up to timeout milliseconds for an event to occur; if the
     timeout value is -1,  the  process  blocks  until  an  event
     occurs or until interrupted.

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

ERORS




SunOS 5.11           Last change: 7 Nov 2002                    1






Remote Shared Memory Library Functions
                                       rsmintrsignalpost(3RSM)



     The rsmintrsignalpost() and  rsmintrsignalwait() func-
     tions can return the following error:

     RSMERBADSEGHNDL     Invalid segment handle.



     The rsmintrsignalpost() function can return the following
     error:

     RSMERCONABORTED

         Connection aborted.


     RSMEREMOTENODEUNREACHABL

         Remote node not reachable.



     The rsmintrsignalwait() function can return the following
     errors:

     RSMERINTERUPTED     Wait interrupted.


     RSMERTIMEOUT         Timer expired.


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



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


SEE ALSO
     rsmmemseggetpollfd(3RSM), attributes(5)







SunOS 5.11           Last change: 7 Nov 2002                    2






Remote Shared Memory Library Functions
                                       rsmintrsignalpost(3RSM)






















































SunOS 5.11           Last change: 7 Nov 2002                    3