Remote Shared Memory Library Functions
                                  rsmmemsegimportconnect(3RSM)



NAME
     rsmmemsegimportconnect,  rsmmemsegimportdisconnect   -
     create or break logical commection between import and export
     segments

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

     int rsmmemsegimportconnect(
          rsmapicontrollerhandlet controller,
          rsmnodeidt nodeid, rsmmemsegidt segmentid,
          rsmpermissiont perm, rsmmemsegimporthandlet *memseg);


     int rsmmemsegimportdisconnect(
          rsmmemsegimporthandlet memseg);


DESCRIPTION
     The rsmmemsegimportconnect() function provides a means of
     creating  an import segment called memseg and establishing a
     logical connection with an export segment identified by  the
     segmentid  on the node specified by nodeid. The controller
     specified by controller must have a physical connection with
     the   controller  (see  rsmgetinterconnecttopology(3RSM))
     used while exporting the segment identified by segmentid on
     node  specified  by nodeid. The perm argument specifies the
     mode of access that the importer is requesting for this con-
     nection.  In  the connection process, the mode of access and
     the importers userid  and  groupid  are  compared  with  the
     access permissions specified by the exporter. If the request
     mode is not valid, the connection  request  is  denied.  The
     perm argument is limited to the following octal values:

     0400    read mode


     0200    write mode


     0600    read/write mode



     The rsmmemsegimportdisconnect() function breaks the logi-
     cal  connection  between the import segment and the exported
     segment and deallocates the resources  associated  with  the
     import segment handle memseg.





SunOS 5.11           Last change: 8 Jun 2001                    1






Remote Shared Memory Library Functions
                                  rsmmemsegimportconnect(3RSM)



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

ERORS
     The             rsmmemsegimportconnect()              and
     rsmmemsegimportdisconnect() functions can return the fol-
     lowing errors:

     RSMERBADSEGHNDL     Invalid segment handle.



     The  rsmmemsegimportconnect()  function  can  return  the
     following errors:

     RSMERBADCTLRHNDL

         Invalid controller handle.


     RSMERCTLRNOTPRESENT

         Controller not present.


     RSMERPERMDENIED

         Permission denied.


     RSMERINSUFICIENTMEM

         Insufficient memory.


     RSMERINSUFICIENTRESOURCES

         Insufficient resources.


     RSMERSEGNOTPUBLISHEDTONODE

         Segment not published to node.


     RSMERSEGNOTPUBLISHED

         Segment not published at all.





SunOS 5.11           Last change: 8 Jun 2001                    2






Remote Shared Memory Library Functions
                                  rsmmemsegimportconnect(3RSM)



     RSMERBADADR

         Bad address.


     RSMEREMOTENODEUNREACHABLE

         Remote not not reachable.


     RSMERINTERUPTED

         Connection interrupted.



     The rsmmemsegimportdisconnect() function can  return  the
     following errors:

     RSMERSEGSTILMAPED     Segment still  mapped,  need  to
                                 unmap before disconnect.


     RSMERPOLFDINUSE        Poll file descriptor in use.


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



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


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











SunOS 5.11           Last change: 8 Jun 2001                    3






Remote Shared Memory Library Functions
                                  rsmmemsegimportconnect(3RSM)






















































SunOS 5.11           Last change: 8 Jun 2001                    4