cimprovider

cimprovider(1)						       cimprovider(1)



NAME
       cimprovider - disable, enable, remove , list or display status of reg-
       istered CIM providers or CIM provider modules

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.

       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	 con-
       tained  in the specified provider module.  The providers that are con-
       tained in the specified provider module are now ready  to  accept  new
       requests.

       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	 mod-
       ule. To list all providers in all modules, issue a cimprovider -l com-
       mand, followed by cimprovider -l -m for each listed module.

       Specifying no options with the cimprovider command displays  the	 com-
       mand usage.

   Options
       The cimprovider command recognizes the following options:

	      -d	     Disables  the  specified CIM provider R 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	 R  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.

	      -h, --help     Display command usage information.

	      -l	     Displays all the registered provider modules.

	      -m module	     Specifies the provider module for the operation.

	      -p provider    Specifies the provider for the operation.

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

	      -s	     Displays the status of provider modules.

	      --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

USAGE NOTES
       The cimprovider command requires that the CIM Server is	running.   If
       an  operation  requires	more  than  two minutes to complete, the cim-
       provider command prints a timeout message and returns an error  value.

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

	      cimprovider -d -m OperatingSystemProvider

       Enable provider module "OperatingSystemProvider" and all of  its	 con-
       tained providers (placing them in an OK state).

	      cimprovider -e -m OperatingSystemProvider

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

	      cimprovider -r -m OperatingSystemProvider

       Remove (un-register) the "PG_OperatingSystemProvider" provider that is
       contained in the "OperatingSystemProvider" provider module.

	      cimprovider  -r  -m OperatingSystemProvider -p PG_OperatingSys-
	      temProvider

       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	are contained in the "Operat-
       ingSystemProvider" provider module.

	      cimprovider -l -m OperatingSystemProvider

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



							       cimprovider(1)