cimprovider(1)							cimprovider(1)

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

SYNOPSIS

       provider]

       module]

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

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

DESCRIPTION
       The 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	command,  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 disables the specified provider module.  When a spec‐
       ified 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 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 requests.

       The third form of disables and  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 regis‐
       tration schema via the command).

       The last form of 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 command,  followed	 by  for  each
       listed module.

       Specifying no options with the command displays the command usage.

   Options
       The command recognizes the following options:

	      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.

	      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.

	      Disables and removes the specified provider
			     module and all of its  contained  providers.   If
			     provider  is  specified, disables and removes the
			     specified provider in the specified provider mod‐
			     ule  (not	affecting  any other providers in that
			     module).

	      Displays all the registered provider modules.

	      Specifies the provider
			     module for the operation.

	      Specifies the  provider for the operation.

	      Displays the status of provider modules.

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:

	      Successful completion
	      Error

EXAMPLES
       Disable	provider  module  "OperatingSystemModule"  and all of its con‐
       tained providers (placing them in a stopped state).

       Enable provider module "OperatingSystemModule" and all of its contained
       providers (placing them in an OK state).

       Disable	and  remove (un-register) the "OperatingSystemModule" provider
       module and all of its contained providers.

       Disable	and  remove  (un-register)  the	  "PG_OperatingSystemProvider"
       provider that is contained in the "OperatingSystemModule" provider mod‐
       ule.

       List the registered provider modules.

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

       List the registered providers which are contained in the "OperatingSys‐
       temModule" provider module.

AUTHOR
       was developed by	 the  Open  Group  OpenPegasus	Open  Source  Software
       project.

SEE ALSO
       cimmof(1), cimserver(1M).

								cimprovider(1)

Vote for polarhome