'\" 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
.\"
.\" Copyright 2010 Sun Microsystems, Inc.  All rights reserved.
.\" Use is subject to license terms.
.\"
.\" ident	"@(#)regmod.1	1.2	10/03/16 SMI"
.\"
.\" 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
=
Availability	system/management/wbem/cimple
=
Interface Stability	Uncommitted
.TE 
.PP
.SH NOTES
Source for SimpleWBEM (Cimple) is available on http://opensolaris.org.
.\" End Sun update