How to Use the Vortex Compiler

6 Utilities

The directories ${VORTEX_HOME}/bin and ${VORTEX_HOME}/Cecil/bin contain utilities that support Vortex application development. Some of these utilities can be invoked from within Vortex, which is responsible for ensuring that the environment is set up correctly. To use these programs at a Unix prompt; source ${VORTEX_HOME/bin/shell/vortex.cshrc from your ~/.cshrc to add the appropriate directories to your path. Some of the most useful utilities are:

Phase Two compilation tools: Phase two compilations can be completed in parallel across a number of machines. Parallel compiles are synchronized via lock files (_foo.cecil.c is a lock file for foo.cecil.c) that are created and removed in the gen directory during phase 2 compilation. The scripts pm, pmwait, and pzap are used to drive parallel compilation. To immediately spawn parallel compiles, use pm; pmwait waits until the current phase 1 compilation completes (time stamp on CecilMakeInfo changes) and then spawns the parallel compile jobs; pzap kills the spawned compile jobs.
Profile guided class prediction: The scripts call-chain.perl, call-site.perl, and summary.perl all invoke pic-filter.perl to format raw profile data into the form expected by Vortex (see section 2.6).
An Emacs mode for editing Cecil programs appears in ${VORTEX_HOME}/Cecil/bin/shell/cecil-mode.el.
The run-vortex script invokes Vortex after modifying the environment. It enables `casual' Cecil programmers to run Vortex without having to modify their environments or explicitly source vortex.cshrc.

How to Use the Vortex Compiler - 20 JAN 97

[Next] [Previous] [Top]