1MP_RegisterPlugin(C3oMmPmAoPnI)Multipath Management Library FMuPn_cRteigoinssterPlugin(3MPAPI)
2
3
4

NAME

6       MP_RegisterPlugin - register a plugin with the common library
7

SYNOPSIS

9       cc [ flag... ] file... -lMPAPI [ library... ]
10       #include <mpapi.h>
11
12       MP_STATUS MP_RegisterPlugin(MP_WCHAR *pPluginId,
13            MP_CHAR *pFileName);
14
15

PARAMETERS

17       pPluginId    A  pointer  to  the  key name shall be the reversed domain
18                    name of the vendor followed by a ".", followed by the ven‐
19                    dor-specific  name for the plugin that uniquely identifies
20                    it.
21
22
23       pFileName    The full path name of the plugin library.
24
25

DESCRIPTION

27       The MP_RegisterPlugin() function registers a  plugin  with  the  common
28       library.   The   current   implementation   adds   an   entry   to  the
29       /etc/mpapi.conf file.
30
31
32       Unlike some other APIs, this API is implemented entirely in the  common
33       library.  It  must  be  called before a plugin is invoked by the common
34       library.
35
36
37       This API does not impact dynamically add or change plugins bound  to  a
38       running  library  instance.  Instead,  it causes an application that is
39       currently not using a plugin to access the specified plugin  on  future
40       calls  to  the  common library. This is generally the behavior expected
41       from dynamically loaded modules.
42
43
44       This API is typically called by a  plugin's  installation  software  to
45       inform the common library of the path for the plugin library.
46
47
48       It is not an error to re-register a plugin. However,  a plugin has only
49       one registration. The first call to deregister a plugin will deregister
50       it no matter how many calls to register the plugin have been made.
51
52
53       A vendor may register multiple plugins by using separate plugin IDs and
54       filenames.
55

RETURN VALUES

57       MP_STATUS_INVALID_PARAMETER
58
59           The pFileName does not exist.
60
61
62       MP_STATUS_SUCCESS
63
64           The operation is successful.
65
66

FILES

68       /etc/mpapi.conf    MPAPI library configuration file
69
70

ATTRIBUTES

72       See attributes(5) for descriptions of the following attributes:
73
74
75
76
77       ┌─────────────────────────────┬─────────────────────────────┐
78       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
79       ├─────────────────────────────┼─────────────────────────────┤
80       │Interface Stability          │Standard: ANSI  INCITS  412  │
81       │                             │Multipath Management API     │
82       ├─────────────────────────────┼─────────────────────────────┤
83       │MT-Level                     │Safe                         │
84       └─────────────────────────────┴─────────────────────────────┘
85

SEE ALSO

87       libMPAPI(3LIB),       MP_DeregisterPlugin(3MPAPI),       mpapi.conf(4),
88       attributes(5)
89
90
91       Multipath Management API Version 1.0
92
93
94
95SunOS 5.11                        15 Feb 2006        MP_RegisterPlugin(3MPAPI)
Impressum