Emitter Framework
Emitter Framework is a set of classes and SOM Compiler tool. Emitter Framework is used to produce various file formats from Interface Definition Language files. Emitter Framework classes consist of Emitter classes and Entry classes. Classes can be shadowed. This means a programmer can replace original classes with his own classes. So the SOM Compiler can be highly customized. The only things hard-coded (and closed source) are the IDL file reader and abstract graph builder.
Before starting description of Emitter Framework lets talk about SOM Compiler. We already talked briefly about SOM Compiler. But for emitters we need to know internals of SOM Compiler much better.
Lets start from visible parts of SOM Compiler. SOM Compiler requires for its work folowing files:
- sc.exe, somc.dll and somc.msg - Main part of compiler.
- somcpp.exe - SOM Preprocessor
- somipc.exe - Goals not known. Seems just execute different emitters
- emit*.dll - Emitters
- *.efw - Emitter templates
sc.exe is general part of compiler. Let's try investigate some internals of sc.exe. First of all we can switch on verbose output and look on it:
Running shell command:
somcpp -D__OS2__ -I. -IC:\os2tk45\h -IC:\os2tk45\idl -IC:\os2tk45\som\include -D__SOMIDL_VERSION_1__ -D__SOMIDL__ -C somobj.idl > C:\var\temp\0a500000.CTN
somipc -mppfile=C:\var\temp\0a500000.CTN -v -e emith -e emitih -e emitctm -e emitc -o somobj somobj.idl
Loading emith.
"SOMObject"
Unloading emith.
Loading emitih.
"SOMObject"
Unloading emitih.
Loading emitctm.
"SOMObject"
Unloading emitctm.
Loading emitc.
"SOMObject"
Unloading emitc.
Removed "C:\var\temp\0a500000.CTN".
Not so many info, but some information here. If we look at SMINCLUDE environment variable
SMINCLUDE=.;C:\os2tk45\h;C:\os2tk45\idl;C:\os2tk45\som\include;
then we will see all paths in -I option.
Considering -D is same as for CPP we can see three symbols defined:
- __OS2__
- __SOMIDL_VERSION_1__
- __SOMIDL__
somobj.idl it is file we emitted and CTN file is output from preprocessor. Only unknown switch is -C. After small playing we can see it means "leave comments".
So, we can try to replace somcpp with some preprocessor. In osFree project we tried to use MCPP preprocessor. Results is well.
sc.exe reads SMINCLUDE variable and puts its content to -I options of somcpp.exe and redirect output to temporary file.
Ok. Now we can try to detect what is somipc.exe. If we try to execute it with command line pointed above, then we will see:
Loading emith. "SOMObject" Unloading emith. Loading emitih. "SOMObject" Unloading emitih. Loading emitctm. "SOMObject" Unloading emitctm. Loading emitc. "SOMObject" Unloading emitc.
Heh. Actually, somipc.exe is real SOM Compiler. Not sc.exe. sc.exe only prepares input file for compiler and handles command line and environment variables.