version 1.3, 2004/08/31 07:11:08
|
version 1.4, 2004/11/23 11:36:42
|
|
|
.\" $Header$ | .\" $Header$ |
.TA c \" lowercase initial letter of .TH name |
.\" .TA c \" lowercase initial letter of .TH name |
.TH cimmof 1 |
.TH "cimmof" "1" "" "" "" |
.SH NAME |
.SH "NAME" |
cimmof \- compile MOF files into the CIM Repository | cimmof \- compile MOF files into the CIM Repository |
.SH SYNOPSIS |
.SH "SYNOPSIS" |
\fBcimmof \-h\fP |
\fBcimmof\fP [ \fB\-h\fP ] [ \fB\-\-help\fP ] [ \fB\-\-version\fP ] [ \fB\-E\fP ] [ \fB\-w\fP ] |
\fBcimmof\fP [ \fB-w\fP ] [ \fB-I\fP <path> ] [ \fB-n\fP <namespace> ] <file>...<file> |
[ \fB\-uc\fP ] [ \fB\-aE | \-aV | \-aEV\fP ] |
|
[ \fB\-I\fP path ] [ \fB\-n\fP namespace ] [ \fB\-\-namespace\fP namespace ] |
|
[ \fB\-\-xml\fP ] [ \fB\-\-trace\fP ] |
|
<mof_file1> <mof_file2...> |
.SS Remarks | .SS Remarks |
.PP | .PP |
Only a superuser or user with write access to the default or specified | Only a superuser or user with write access to the default or specified |
|
|
It is strongly recommended that MOF files include all necessary subclasses, | It is strongly recommended that MOF files include all necessary subclasses, |
so they can compile properly even if certain classes are not in the CIM | so they can compile properly even if certain classes are not in the CIM |
Repository. | Repository. |
.SH DESCRIPTION |
.SH "DESCRIPTION" |
.PP | .PP |
The | The |
.B cimmof | .B cimmof |
|
|
command recognizes the following options: | command recognizes the following options: |
.RS | .RS |
.TP 15 | .TP 15 |
.B -h |
.B \-aE |
Display the command usage and the version number of the MOF Compiler. |
Allow Experimental Schema changes. |
The version number is used to identify the release version of the |
|
MOF Compiler. |
|
.TP | .TP |
.B -w |
.B \-aEV |
Suppress warning messages. |
Allow both Experimental and Version Schema changes. |
.IP |
|
When compiling the MOF files, if there are CIM elements (such as classes, |
|
instances, properties, or methods) defined in the MOF files which |
|
already exist in the CIM Repository, the |
|
.B cimmof |
|
command returns warning messages. The |
|
.B \-w |
|
option can be used to suppress these warning messages. |
|
.TP | .TP |
\fB-I\fP <path> |
.B \-aV |
|
Allow both Major and Down Revision Schema changes. |
|
.TP |
|
.B \-E |
|
Syntax check only |
|
.TP |
|
.B \-h, \-\-help |
|
Display command usage information. |
|
.TP |
|
\fB\-I\fP path |
Specify the path to included MOF files. This path may be relative or | Specify the path to included MOF files. This path may be relative or |
absolute. | absolute. |
.IP | .IP |
If the input MOF file has include pragmas and the | If the input MOF file has include pragmas and the |
included files do not reside in the current directory, | included files do not reside in the current directory, |
the | the |
.C -I |
.C \-I |
directive must be used to specify a path to | directive must be used to specify a path to |
them on the | them on the |
.B cimmof | .B cimmof |
command line. | command line. |
.TP | .TP |
\fB-n\fP <namespace> |
\fB\-n\fP |
|
Override the default CIM Repository namespace. The |
|
.I namespace |
|
specified must be a valid CIM |
|
namespace name. For the definition of a valid CIM |
|
namespace name, refer to the Administrator's Guide. |
|
For provider registration schemas, the |
|
.I namepace |
|
specified must be root/PG_InterOp. |
|
.TP |
|
\fB\-\-namespace\fP |
Override the default CIM Repository namespace. The | Override the default CIM Repository namespace. The |
.I <namespace> |
.I namespace |
specified must be a valid CIM | specified must be a valid CIM |
namespace name. For the definition of a valid CIM | namespace name. For the definition of a valid CIM |
namespace name, refer to the Administrator's Guide. | namespace name, refer to the Administrator's Guide. |
For provider registration schemas, the | For provider registration schemas, the |
.I <namepace> |
.I namepace |
specified must be root/PG_InterOp. | specified must be root/PG_InterOp. |
.SH EXIT STATUS |
.TP |
|
\fB\-\-trace\fP |
|
Trace to file (default to stdout) |
|
.TP |
|
\fB\-uc\fP |
|
Allow update of an existing class definition. |
|
.TP |
|
\fB\-\-version\fP |
|
Display CIM Server version. |
|
.TP |
|
.B \-w |
|
Suppress warning messages. |
|
.IP |
|
When compiling the MOF files, if there are CIM elements (such as classes, |
|
instances, properties, or methods) defined in the MOF files which |
|
already exist in the CIM Repository, the |
|
.B cimmof |
|
command returns warning messages. The |
|
.B \-w |
|
option can be used to suppress these warning messages. |
|
.TP |
|
.B \-\-xml |
|
Output XML only, to stdout. Do not update repository. |
|
.SH "EXIT STATUS" |
.PP | .PP |
The | The |
.B cimmof | .B cimmof |
|
|
.PP | .PP |
When an error occurs, an error message is written to stderr and an | When an error occurs, an error message is written to stderr and an |
error value of 1 is returned. | error value of 1 is returned. |
.SH DIAGNOSTICS |
.SH "DIAGNOSTICS" |
.PP | .PP |
.B "Error trying to create Repository in path localhost:5988: Cannot connect to: localhost:5988 Failed to set DefaultNamespacePath." | .B "Error trying to create Repository in path localhost:5988: Cannot connect to: localhost:5988 Failed to set DefaultNamespacePath." |
.IP | .IP |
The CIM Server is not running. Start the CIM Server with the | The CIM Server is not running. Start the CIM Server with the |
.C cimserver | .C cimserver |
command and re-run |
command and re\-run |
.B cimmof . | .B cimmof . |
.PP | .PP |
If the MOF Compiler detects an error in the MOF file while parsing the file, | If the MOF Compiler detects an error in the MOF file while parsing the file, |
|
|
For a list of possible error messages | For a list of possible error messages |
that may be returned, refer to the Chapter on WBEM messages in | that may be returned, refer to the Chapter on WBEM messages in |
the Administrator's Guide. | the Administrator's Guide. |
.SH EXAMPLES |
.SH "EXAMPLES" |
.PP | .PP |
Compile a MOF file into the default namespace in the CIM Repository, | Compile a MOF file into the default namespace in the CIM Repository, |
issue the | issue the |
|
|
.IP | .IP |
.B "cimmof processInfo.mof" | .B "cimmof processInfo.mof" |
.PP | .PP |
Compile the MOF files into the 'root/application' namespace. |
Compile the MOF files into the "root/application" namespace. |
.IP | .IP |
.C "cimmof -nroot/application test1.mof test2.mof" |
.B "cimmof \-nroot/application test1.mof test2.mof" |
.PP | .PP |
Compile the MOF file defined in the directory ./MOF with the name | Compile the MOF file defined in the directory ./MOF with the name |
CIMSchema25.mof, and containing include pragmas for other MOF files also | CIMSchema25.mof, and containing include pragmas for other MOF files also |
in the ./MOF directory. | in the ./MOF directory. |
.IP | .IP |
.B "cimmof -w -I./MOF MOF/CIMSchema25.mof" |
.B "cimmof \-w \-I./MOF MOF/CIMSchema25.mof" |
.PP | .PP |
List the arguments to the |
Display Usage Info for the |
.B cimmof | .B cimmof |
command and display the version of the MOF Compiler. |
command. |
.IP | .IP |
.B "cimmof -h" |
.B "cimmof \-h" |
.SH SEE ALSO |
.SH "SEE ALSO" |
.PP | .PP |
cimserver(1M). |
cimserver(1). |