1cimprovider(1) cimprovider(1)
2
3
4
6 cimprovider - disable, enable, remove , list or display status of reg‐
7 istered CIM providers or CIM provider modules
8
10 cimprovider -d -m module
11
12 cimprovider -e -m module
13
14 cimprovider -r -m module [ -p provider ]
15
16 cimprovider -l [ -s | -m module ]
17
18 cimprovider -h
19
20 cimprovider --help
21
22 cimprovider --version
23
24
25 Remarks
26 The -l option for this command can be executed by any user(s). All
27 other options require superuser permissions.
28
29 This command disables, enables, or removes one CIM provider module or
30 CIM provider at a time.
31
33 The cimprovider command provides a command line interface to disable,
34 enable, unregister, and list registered CIM providers. If a CIM
35 provider is disabled, the CIM Server rejects any requests to the
36 provider. If a CIM provider is enabled, the CIM Server forwards
37 requests to the provider. And if a CIM provider is unregistered, the
38 CIM Server will no longer have any information about the provider.
39
40 In order to use the cimprovider command, cimserver has to be running
41 and the specified provider module (a grouping of providers in the same
42 shared library) or provider has to be registered with WBEM Services.
43
44 The first form of cimprovider disables the specified provider module.
45 When a specified provider module is in the disabled state, any new
46 requests to the providers that are contained in the specified provider
47 module will be rejected.
48
49 The second form of cimprovider enables the providers that are contained
50 in the specified provider module. The providers that are contained in
51 the specified provider module are now ready to accept new requests.
52
53 The third form of cimprovider removes (un-registers) the specified
54 provider module and all of its contained providers or the specified
55 provider in the specified provider module. Once removed, a provider or
56 provider module must be re-registered (typically by loading its regis‐
57 tration schema via the cimmof command).
58
59 The last form of cimprovider lists all the registered provider modules
60 and module status or all the providers in the specified provider mod‐
61 ule. To list all providers in all modules, issue a cimprovider -l com‐
62 mand, followed by cimprovider -l -m for each listed module.
63
64 The following provider module status values are defined:
65
66 OK The provider module is enabled.
67
68 Stopping The provider module is in the process of being disabled.
69
70 Stopped The provider module is disabled.
71
72 Degraded A failure was detected in an out-of-process provider
73 module. Disable and re-enable the provider module to
74 ensure any active indication subscriptions are being
75 served.
76
77 Error An invalid registration instance was encountered upon
78 CIM Server initialization.
79
80 Specifying no options with the cimprovider command displays the command
81 usage.
82
83 Options
84 The cimprovider command recognizes the following options:
85
86 -d Disables the specified CIM provider R module .
87 If user(s) try to disable a module that is
88 already disabled, an error message is returned
89 and no action is taken.
90
91 -e Enables the specified CIM provider R module . If
92 user(s) try to enable a module that is already
93 enabled or try to enable a module that is dis‐
94 abling, an error message is returned and no
95 action is taken.
96
97 -h, --help Display command usage information.
98
99 -l Displays all the registered provider modules.
100
101 -m module Specifies the provider module for the operation.
102
103 -p provider Specifies the provider for the operation.
104
105 -r Removes the specified provider module and all of
106 its contained providers. If provider is speci‐
107 fied, removes the specified provider in the spec‐
108 ified provider module (not affecting any other
109 providers in that module).
110
111 -s Displays the status of provider modules.
112
113 --version Display CIM Server version number.
114
116 When an error occurs, an error message is written to stderr and an
117 error value 1 is returned. The following return values are returned:
118
119 0 Successful completion
120 1 Error
121
123 The cimprovider command requires that the CIM Server is running. If an
124 operation requires more than two minutes to be processed, the cim‐
125 provider command prints a timeout message and returns an error value.
126
128 Disable provider module "OperatingSystemProvider" and all of its con‐
129 tained providers (placing them in a stopped state).
130
131 cimprovider -d -m OperatingSystemProvider
132
133 Enable provider module "OperatingSystemProvider" and all of its con‐
134 tained providers (placing them in an OK state).
135
136 cimprovider -e -m OperatingSystemProvider
137
138 Remove (un-register) the "OperatingSystemProvider" provider module and
139 all of its contained providers.
140
141 cimprovider -r -m OperatingSystemProvider
142
143 Remove (un-register) the "PG_OperatingSystemProvider" provider that is
144 contained in the "OperatingSystemProvider" provider module.
145
146 cimprovider -r -m OperatingSystemProvider -p PG_OperatingSystem‐
147 Provider
148
149 List the registered provider modules.
150
151 cimprovider -l
152
153 List the registered provider modules and their status (such as OK,
154 Stopping, Stopped).
155
156 cimprovider -l -s
157
158 List the registered providers which are contained in the "OperatingSys‐
159 temProvider" provider module.
160
161 cimprovider -l -m OperatingSystemProvider
162
164 cimmof(1), cimserver(1).
165
166
167
168 cimprovider(1)