Remote Shared Memory Library Functions   rsmgetcontroller(3RSM)



NAME
     rsmgetcontroller,                 rsmgetcontrollerattr,
     rsmreleasecontroller - get or release a controller handle

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

     int rsmgetcontroller(char *name,
          rsmapicontrollerhandlet *controller);


     int rsmgetcontrollerattr(rsmapicontrollerhandlet chdl,
          rsmapicontrollerattrt *attr);


     int rsmreleasecontroller(rsmapicontrollerhandlet chdl);


DESCRIPTION
     The controller functions provide  mechanisms  for  obtaining
     access  to  a controller, determining the characteristics of
     the controller, and releasing the controller.


     The  rsmgetcontroller()  function  acquires  a  controller
     handle  through  the controller argument.  The name argument
     is the specific controller instance (for example, "sci0"  or
     "loopback").  This  controller handle is used for subsequent
     RSMAPI calls.


     The    rsmgetcontrollerattr()    function    obtains    a
     controller's  attributes through the attr argument. The chdl
     argument  is  the  controller   handle   obtained   by   the
     rsmgetcontroller()   call.   The  attribute  structure  is
     defined in the  header.


     The    rsmreleasecontroller()   function   releases    the
     resources  associated  with the controller identified by the
     controller    handle    chdl,    obtained     by     calling
     rsmgetcontroller().   Each  rsmreleasecontroller()  call
     must have a corresponding rsmgetcontroller() call.  It  is
     illegal  to  access  a  controller  or  segments exported or
     imported using a released controller.

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





SunOS 5.11           Last change: 8 Jun 2001                    1






Remote Shared Memory Library Functions   rsmgetcontroller(3RSM)



ERORS
     The  rsmgetcontroller(),  rsmgetcontrollerattr(),   and
     rsmreleasecontroller()  functions can return the following
     errors:

     RSMERBADCTLRHNDL     Invalid controller handle.



     The  rsmgetcontroller()   and    rsmgetcontrollerattr()
     functions can return the following errors:

     RSMERBADADR     Bad address.



     The  rsmgetcontroller() function can return the  following
     errors:

     RSMERCTLRNOTPRESENT

         Controller not present.


     RSMERINSUFICIENTMEM

         Insufficient memory.


     RSMERBADLIBRARYVERSION

         Invalid library version.


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



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


SEE ALSO
     rsmmemsegexportcreate(3RSM),
     rsmmemsegimportconnect(3RSM), attributes(5)



SunOS 5.11           Last change: 8 Jun 2001                    2