Remote Shared Memory Library Functions
                                      rsmmemseggetpollfd(3RSM)



NAME
     rsmmemseggetpollfd, rsmmemsegreleasepollfd  -  get  or
     release a poll descriptor

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

     int rsmmemseggetpollfd(void *memseg, struct pollfd *fd);


     int rsmmemsegreleasepollfd(void *memseg);


DESCRIPTION
     The rsmmemseggetpollfd() and  rsmmemsegreleasepollfd()
     functions        provide       an       alternative       to
     rsmintrsignalwait(3RSM). The waiting process  can  multi-
     plex  event  waiting  using the poll(2) function after first
     obtaining a poll descriptor  using  rsmmemseggetpollfd().
     The   descriptor   can   subsequently   be   released  using
     rsmmemsegreleasepollfd().


     As a result of a call rsmmemseggetpollfd(), the specified
     pollfd  structure  is  initialized with a descriptor for the
     specified  segment  (memseg)  and  the  event  generated  by
     rsmintrsignalpost(3RSM).  Either an export segment handle
     or an import segment handle can  be  type  cast  to  a  void
     pointer.  The  pollfd argument can subsequently be used with
     the rsmintrsignalwaitpollfd(3RSM) function to  wait  for
     the  event;  it cannot be used with poll(). If memseg refer-
     ences an export segment, the segment must be currently  pub-
     lished.  If memseg references an import segment, the segment
     must be connected.


     The  rsmmemsegresleasepollfd()  function  decrements  the
     reference  count of the pollfd structure associated with the
     specified segment.  A segment unpublish,  destroy  or  unmap
     operation will fail if the reference count is non-zero.

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

ERORS
     The rsmmemseggetpollfd() and  rsmmemsegreleasepollfd()
     function can return the following error:





SunOS 5.11           Last change: 1 Dec 2002                    1






Remote Shared Memory Library Functions
                                      rsmmemseggetpollfd(3RSM)



     RSMERBADSEGHNDL     Invalid segment handle.


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



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


SEE ALSO
     poll(2),                         rsmintrsignalpost(3RSM),
     rsmintrsignalwaitpollfd(3RSM), attributes(5)

































SunOS 5.11           Last change: 1 Dec 2002                    2






Remote Shared Memory Library Functions
                                      rsmmemseggetpollfd(3RSM)






















































SunOS 5.11           Last change: 1 Dec 2002                    3