1cimmofl(1) cimmofl(1)
2
6 cimmofl - compile MOF files into the CIM Repository
7
9 cimmofl -h | --help
10 cimmofl --version
12 cimmofl [ -w ] [ -E ] [ -uc ] [ -aE | -aV | -aEV ] [ -I path ]
14 [ -n namespace | --namespace namespace ] [ --xml ]
15 [ --trace ]
16 [ -R repositorydir ] [ --CIMRepository repositorydir ]
17 [ -N repositoryname ] [ -M repositorymode ] [ mof_file ... ]
18 Remarks
20 Only a superuser or user with write access to the default or specified
21 namespace can run the cimmofl command to compile MOFs in the CIM Repos‐
22 itory.
23 Superclasses must be compiled before subclasses, else the compile will
25 fail.
26 It is strongly recommended that MOF files include all necessary sub‐
28 classes, so they can compile properly even if certain classes are not
29 in the CIM Repository.
30
32 The cimmofl command is a command line interface to the Managed Object
33 Format (MOF) Compiler. The MOF Compiler is a utility that compiles MOF
34 files (using the MOF format defined by the DMTF CIM Specification) into
35 CIM classes and instances that are stored in the CIM Repository.
36 The cimmofl command can be used to compile MOF files at any time after
38 installation. If no input file is specified, stdin is used as the
39 input.
40 The MOF Compiler requires that the input MOF files be in the current
42 directory or that a fully qualified path be given. To simplify the
43 specification of multiple MOF files in the cimmofl command line, the
44 MOF Compiler allows compiling from files containing a list of MOF files
45 using the include pragma (as shown below).
46 #pragma include ("application.mof")
48 #pragma include ("server.mof")
49 MOF files using the include pragma must be in the current directory or
51 in a directory specified by the -I command line option.
52 The -n option can be used to specify a R namespace in which the CIM
54 classes and instances will be compiled. If this option is not speci‐
55 fied, the default R namespace is root/cimv2 (with the exception of
56 provider registration schemas).
57 For provider registration schemas, if the -n option is not specified,
59 the default R namespace is root/PG_InterOp. If -n option is specified,
60 the R namespace specified must be root/PG_InterOp, otherwise, the error
61 message "The requested operation is not supported." is returned. For
62 provider MOFs, the R namespace specified must match one of the names‐
63 paces specified in the PG_ProviderCapabilities class schema definition.
64 Options
66 The cimmofl command recognizes the following options:
67 -aE Allow Experimental Schema changes.
69 -aEV Allow both Experimental and Version Schema
71 changes.
72 -aV Allow both Major and Down Revision Schema
74 changes.
75 --CIMRepository
77 Specify the repository path.
78 -E Syntax check only
80 -h, --help Display command usage information.
82 -I Specify the path to included MOF files. This
84 path may be relative or absolute.
85 If the input MOF file has include pragmas and the
87 included files do not reside in the current
88 directory, the directive must be used to specify
89 a path to them on the cimmofl command line.
90 -n Override the default CIM Repository namespace.
92 The namespace specified must be a valid CIM
93 namespace name. For the definition of a valid
94 CIM namespace name, refer to the Administrator's
95 Guide. For provider registration schemas, the
96 namepace specified must be root/PG_InterOp.
97 --namespace Override the default CIM Repository namespace.
99 The namespace specified must be a valid CIM
100 namespace name. For the definition of a valid
101 CIM namespace name, refer to the Administrator's
102 Guide. For provider registration schemas, the
103 namepace specified must be root/PG_InterOp.
104 -R Specify the repository path.
106 -N Specify the repository name - defaults to "repos‐
108 itory"
109 -M Repository mode [XML, BIN] - defaults to "XML"
111 --trace Trace to file (default to stdout).
113 -uc Allow update of an existing class definition.
115 --version Display CIM Server version.
117 -w Suppress warning messages.
119 When compiling the MOF files, if there are CIM
121 elements (such as classes, instances, properties,
122 or methods) defined in the MOF files which
123 already exist in the CIM Repository, the cimmofl
124 command returns warning messages. The -w option
125 can be used to suppress these warning messages.
126 --xml Output XML only, to stdout. Do not update reposi‐
128 tory.
129
131 The cimmofl command returns one of the following values:
132 0 Successful completion
134 1 Error
135 When an error occurs, an error message is written to stderr and an
137 error value of 1 is returned.
138
140 Warning: Use of cimmofl can corrupt the CIM Server Repository.
141 cimmofl should only be used under very controlled situations.
142 cimmof is the recommended OpenPegasus MOF compiler.
143
145 Error trying to create Repository in path localhost:5988: Cannot con‐
146 nect to: localhost:5988 Failed to set DefaultNamespacePath.
147 The CIM Server is not running. Start the CIM Server with the
149 command and re-run cimmofl .
150 If the MOF Compiler detects an error in the MOF file while parsing the
152 file, a parsing error is returned with the line number of the MOF file
153 containing the error.
154 Operation cannot be carried out since the specified superclass does not
156 exist.
157 The MOF Compiler compiled a MOF file with superclasses that were
159 not in the CIM Repository.
160 For a list of possible error messages that may be returned, refer to
162 the Chapter on WBEM messages in the Administrator's Guide.
163
165 Compile a MOF file into the default namespace in the CIM Repository,
166 issue the cimmofl command with no options.
167 cimmofl processInfo.mof
169 Compile the MOF files into the "root/application" namespace.
171 cimmofl -nroot/application test1.mof test2.mof
173 Compile the MOF file defined in the directory ./MOF with the name CIM‐
175 Schema25.mof, and containing include pragmas for other MOF files also
176 in the ./MOF directory.
177 cimmofl -w -I./MOF MOF/CIMSchema25.mof
179 Display Usage Info for the cimmofl command.
181 cimmofl -h
183
185 cimserver(1), cimmof(1).
186 cimmofl(1)