Tools Provided with the ChorusOS System

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 System

Utility/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 System

File	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 ChorusOS

File	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

---

Note -

None of the above files can be modified.

---