'\" t

.\"

.\" CDDL HEADER START

.\"

.\" The contents of this file are subject to the terms of the

.\" Common Development and Distribution License (the "License").

.\" You may not use this file except in compliance with the License.

.\"

.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE

.\" or http://www.opensolaris.org/os/licensing.

.\" See the License for the specific language governing permissions

.\" and limitations under the License.

.\"

.\" When distributing Covered Code, include this CDDL HEADER in each

.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.

.\" If applicable, add the following below this CDDL HEADER, with the

.\" fields enclosed by brackets "[]" replaced with your own identifying

.\" information: Portions Copyright [yyyy] [name of copyright owner]

.\"

.\" CDDL HEADER END

.\"

.\" Use is subject to license terms.

.\"

.\"

.\" Man page for regmod

.TH "regmod" "1" "" "" ""

.SH "NAME"

.B regmod

\- registers (or unregisters) one more more providers contained

in a CIMPLE provider module library, with the Pegasus CIMOM.

.SH "SYNOPSIS"

.B regmod

[-cvh] provider-module-library [classname...]

.SH "DESCRIPTION"

.P

The 

.B regmod

utility registers (or unregisters) one more more providers contained

in a CIMPLE provider module library, with the Pegasus CIMOM. There are 

two forms for registering providers. The following registers ALL providers 

contained in the provider module library.

.TP

$ regmod [OPTIONS] provider-module-library

.P

Alternatively, the following registers only providers for the classes

explicitly listed after the provider module library.

.TP

$ regmod [OPTIONS] provider-module-library classname...

.P

This utility performs the following steps:

.RS

.TP

1. Validates the module library by loading it.

.TP 3

2. Checks compatiblity between provider classes and Pegasus 

classes.

.TP 3

3. Creates provider classes in Pegasus repository if they do 

not exist.

.TP 3

4. Registers all providers in the module with the Pegasus 

repository

.RE

.SH "OPTIONS"

.B regmod

recognizes the following options:

.RS

.TP

.B -V

Print the version number.

.TP

.B -c

Create classes (or delete them when -u present)

.TP 

.B -i

Delete indirect classes (when -u and -c present)

.TP

.B -s

provide subclasses of the provided class (or delete them with -u)

.TP

.B -v

Enables verbose mode

.TP

.B -n namespace

Provider namespace (may occur multiple times)

.TP

.B -d

dump the MOF registration instances to standard output without modifying the Pegasus repository.

.TP

.B -u

Unregister the module

.TP

.B -U username

The user to run provider module as (user must be a system user, 

@requestor, @cimserver, or @privileged).

.TP

.B -h

Print the help message.

.RE

.SH "EXIT STATUS"

When an error occurs, an error message is written to the standard error

stream and a non-zero exit status value is returned.

.SH "EXAMPLES"

.RS

1. To delete registration instances only

.IP

.B $ regmod -u

.PP

2. To delete registration instances and direct classes

.IP

.B $ regmod -u -c

.PP

.TP 3

3. To delete registration instances, direct classes and 

indirect classes

.RE

.TP 7

.IP

.B $ regmod -u -c -i

.SH "SEE ALSO"

cimserver(1), genclass(1), genhnd(1), genmak(1), genmod(1), genproj(1), genprov(1).

'\" t

.\"

.\" Modified for Solaris to add the Solaris stability classification,

.\" and to add a note about source availability.

.\"

.\" Begin Sun update

.SH ATTRIBUTES

See

.BR attributes (5)

for descriptions of the following attributes:

.sp

.TS

box;

cbp-1 | cbp-1

l | l .

ATTRIBUTE TYPE	ATTRIBUTE VALUE

=

=

Interface Stability	Uncommitted

.TE 

.PP

.SH NOTES

Source for SimpleWBEM (Cimple) is available on http://opensolaris.org.

.\" End Sun update