Manual Pages for UNIX Operating System command usage for man MP_RegisterPlugin

Common Multipath Management Library Functions
                                        MP_RegisterPlugin(3MPAPI)



NAME
     MP_RegisterPlugin  -  register  a  plugin  with  the  common
     library

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

     MP_STATUS MP_RegisterPlugin(MP_WCHAR *pPluginId,
          MP_CHAR *pFileName);


PARAMETERS
     pPluginId    A pointer to the key name shall be the reversed
                  domain  name  of  the vendor followed by a ".",
                  followed by the vendor-specific  name  for  the
                  plugin that uniquely identifies it.


     pFileName    The full path name of the plugin library.


DESCRIPTION
     The MP_RegisterPlugin() function registers a plugin with the
     common  library. The current implementation adds an entry to
     the /etc/mpapi.conf file.


     Unlike some other APIs, this API is implemented entirely  in
     the  common  library.  It  must be called before a plugin is
     invoked by the common library.


     This API does not impact dynamically add or  change  plugins
     bound  to  a running library instance. Instead, it causes an
     application that is currently not using a plugin  to  access
     the  specified plugin on future calls to the common library.
     This is generally the  behavior  expected  from  dynamically
     loaded modules.


     This API is typically  called  by  a  plugin's  installation
     software  to  inform  the common library of the path for the
     plugin library.


     It is not an error to re-register a plugin. However,  a plu-
     gin  has only one registration. The first call to deregister
     a plugin will deregister it no  matter  how  many  calls  to
     register the plugin have been made.




SunOS 5.11          Last change: 15 Feb 2006                    1






Common Multipath Management Library Functions
                                        MP_RegisterPlugin(3MPAPI)



     A vendor may register multiple  plugins  by  using  separate
     plugin IDs and filenames.

RETURN VALUES
     MP_STATUS_INVALID_PARAMETER

         The pFileName does not exist.


     MP_STATUS_SUCCESS

         The operation is successful.


FILES
     /etc/mpapi.conf    MPAPI library configuration file


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



     ________________________________________________________________________
    |       ATTRIBUTE TYPE        |             ATTRIBUTE VALUE             |
    |_____________________________|_________________________________________|
    | Interface Stability         | Committed                               |
    |_____________________________|_________________________________________|
    | MT-Level                    | Safe                                    |
    |_____________________________|_________________________________________|
    | Standard                    | ANSI INCITS 412 Multipath Management API|
    |_____________________________|_________________________________________|


SEE ALSO
     libMPAPI(3LIB), MP_DeregisterPlugin(3MPAPI),  mpapi.conf(4),
     attributes(5)


     Multipath Management API Version 1.0













SunOS 5.11          Last change: 15 Feb 2006                    2






Common Multipath Management Library Functions
                                        MP_RegisterPlugin(3MPAPI)






















































SunOS 5.11          Last change: 15 Feb 2006                    3