### cimprovider (1M)

#### NAME

> cimprovider - disable, enable, remove or list registered CIM providers or CIM provider modules and module status.

#### SYNOPSIS

> `cimprovider -d -m module`

> `cimprovider -e -m module`

> `cimprovider -r -m module [ -p provider ]`

> `cimprovider -l [ -s | -m module ]`

> `cimprovider -h`

> `cimprovider --help`

> `cimprovider --version`

#### REMARKS

The -l option for this command can be executed by any user(s). All other options require superuser permissions.
LIMITATIONS

> This command disables, enables, or removes one CIM provider module or CIM provider at a time.

#### DESCRIPTION

> The cimprovider command provides a command line interface to disable, enable, unregister, and list registered CIM providers. If a CIM provider is disabled, the CIM Server rejects any requests to the provider. If a CIM provider is enabled, the CIM Server forwards requests to the provider. And if a CIM provider is unregistered, the CIM Server will no longer have any information about the provider.

> In order to use the cimprovider command, cimserver has to be running and the specified provider module (a grouping of providers in the same shared library) or provider has to be registered with WBEM Services.

> The first form of cimprovider disables the specified provider module. When a specified provider module is in the disabled state, any new requests to the providers that are contained in the specified provider module will be rejected.

> The second form of cimprovider enables the providers that are contained in the specified provider module. The providers that are contained in the specified provider module are now ready to accept new request.

> The third form of cimprovider removes (un-registers) the specified provider module and all of its contained providers or the specified provider in the specified provider module. Once removed a provider or provider module, must be re-registered (typically by loading its registration schema via the cimmof command).

> The last form of cimprovider lists all the registered provider modules and module status or all the providers in the specified provider module. To list all providers in all modules, issue a cimprovider -l command, followed by cimprovider -l -m for each listed module.

> Specifying no options with the cimprovider command displays the command usage.

#### Options

> The cimprovider command recognizes the following options:

> `-d` Disables the specified CIM provider module. If user(s) try to disable a module that is already disabled, an error message is returned and no action is taken.

> `-e` Enables the specified CIM provider module. If user(s) try to enable a module that is already enabled or try to enable a module that is disabling, an error message is returned and no action is taken.

> `-r` Removes the specified provider module and all of its contained providers. If provider is specified, removes the specified provider in the specified provider module (not affecting any other providers in that module).

> `-l` Displays all the registered provider modules.

> `-m module` Specifies the provider module for the operation.

> `-p provider` Specifies the provider for the operation.

> `-s` Displays the status of provider modules.

> -h, --help Display this help message.

> --version Display CIM Server version number

#### EXIT STATUS

> When an error occurs, an error message is written to stderr and an error value 1 is returned. The following return values are returned:

> `0` Successful completion

> `1` Error

#### EXAMPLES

> Disable provider module "OperatingSystemProvider" and all of its contained providers (placing them in a stopped state).

> `cimprovider -d -m OperatingSystemProvider`

> Enable provider module "OperatingSystemProvider" and all of its contained providers (placing them in a OK state).

> `cimprovider -e -m OperatingSystemProvider`

> Remove (un-registers) the "OperatingSystemProvider" provider module and all of its contained providers.

> `cimprovider -r -m OperatingSystemProvider`

> Remove (un-registers) the "PG_OperatingSystemProvider" provider that contains in the "OperatingSystemProvider" provider module.

> `cimprovider -r -m OperatingSystemProvider -p PG_OperatingSystemProvider`

> List the registered provider modules.

> `cimprovider -l`

> List the registered provider modules and their status (such as OK, Stopping, Stopped).

> `cimprovider -l -s`

> List the registered providers which contained in the "OperatingSystemProvider" provider module.

> `cimprovider -l -m OperatingSystemProvider`

#### AUTHOR

> cimprovider was developed by the Hewlett-Packard Company.

#### SEE ALSO

> cimmof(1), cimserver(1M).