Table 1-4 gives the list of utilities and production files provided with the ChorusOS system and used with either the mkmk or the imake development tool. Utilities that can be called directly by developers are described in more detail in the ChorusOS man pages (configure, ChorusOSMkMf, configurator and mkmerge). The files in this Table are located in the <bin_dir>/tools/host/bin directory.
Table 1-4 Host Tools Provided with the ChorusOS SystemUtility/File | Description |
configure | the "configure" script |
cpxml | wrapper around cp, used to copy XML files |
cproot | copies files to the target file system |
ChorusOSMkMf | creates Makefiles, using imake, for target binaries |
HostMkMf | creates Makefiles, using imake, for host binaries |
Makefile.bin | interface of the tools component |
makedepend | creates dependencies |
configurator | handles configuration of features and tunables |
mkimage | the create system image |
mkmerge | merges split trees into a merged tree |
genEnv | reads Makefiles and gives output with their variables |
getExport | computes the list of object files to use when creating a link |
m4 | the GNU m4 preprocessor |
mkctors | handles ctors/dtors and tunables during actor link |
mkmake | wrapper around make |
mkmk | creates Makefiles |
mkstubs | produces system call stubs |
rpcgen | an RPC protocol compiler |
chgetlayout | extracts image layout, for DebugServer |
mksymfiles | ghs compiler only |
getLayoutFile | ghs compiler only |
concat | concatenates files |
devsys.mk | make rules to compile host tools |
The imake files; Imake.rules, Imake.tmpl, Package.rules, Project.tmpl are discussed in ChorusOS 4.0 Introduction. Table 1-5 gives a description of these files.
Table 1-5 The imake files provided with the ChorusOS SystemFile | Description |
imake/Imake.rules | imake rules |
imake/Imake32.rules | provides compatibility with r3.2 imake rules |
imake/Imake.tmpl | template Makefile, for imake |
imake/Package.rules | packaging rules, for imake |
imake/Project.tmpl | empty Project.tmpl |
Each file in the tgt-make directory deals with make rules for compiling target binary files. Certain files are specific to the gcc compiler, others to the ghs compiler. Only common and gcc/powerpc specific files are described here. All files listed in Table 1-6 are located in <bin_dir>/tools/tgt-make directory:
Table 1-6 Target Rules for ChorusOSFile | Description |
gcc-devsys.mk | make rules used by the imake environment |
gcc-ld.ld | linker script used to reduce the section number |
gcc-variables.rf | make variables, for the mkmk and imake environments |
gcc-tgtdevsys.rf | make rules, for mkmk |
variables.rf | includes the compiler specific file about variables |
tgtdevsys.rf | includes the compiler specific file about rules |
shared.rf | calls mkmake |
mktgt.rf | includes all targets rules |
mkrules.rf | contains rules for the mkmk environment |
mkrules.m4 | m4 macros for .bf files |
Makefile.mkimage | Makefile used during image creation |
Makefile.conf | Makefile used during configurable actor links |
genLink | generic linker, calls genLink.conf and genLink.noconf |
genLink.conf | links configurable actors |
genLink.noconf | links non-configurable actors |
mkdbginfo | generates offsets and symbol information |
host.conf | defines the host type |
powerpc/genOff | create offset files |
powerpc/genOff.awk | awk file used by genOff |
powerpc/act.ld | linker script used for actors using dynamic libraries |
powerpc/lib.ld | linker script used to create dynamic libraries |
None of the above files can be modified.