next up previous contents
Next: E. Listing of all Up: CM The SML/NJ Compilation Previous: C. Listing of all   Contents

D. Listing of all CM-specific environment variables

Most control parameters that affect CM's operation can be adjusted using environment variables $v_s$ at startup time, i.e, when the sml command is invoked. Each such parameter has a default setting. Default settings are determined at bootstrap time, i.e., the time when the heap image for SML/NJ's interactive system is built.17 At bootstrap time, it is possible to adjust defaults by using a different set of environment variables $v_b$. If neither $v_s$ nor $v_b$ were set, a hard-wired fallback value will be used.

The rule for constructing (the names of) $v_s$ and $v_b$ is the following: For each adjustable parameter $x$ there is a name stem. If the stem for $x$ is $s$, then $v_s = \mbox{\tt CM\_}s$ and $v_b = v_s\mbox{\tt\_DEFAULT}$.

Since the normal installation procedure for SML/NJ sets some of the $v_b$ variables at bootstrap time, there are two columns with default values in the following table. The value labeled fallback is the one that would have been used had there been no environment variable at bootrap time, the one labeled default is the one the user will actually see.

To save space, the table lists the stem but not the names for its associated (longer) $v_s$ and $v_b$. For example, since the the table shows VERBOSE in the row for CM.Control.verbose, CM's per-session verbosity can be adjusted using CM_VERBOSE and the boot-time default can be set using CM_VERBOSE_DEFAULT.

  CM.Control.$c$ stem type fallback default default's meaning  
  verbose VERBOSE bool true same issue progess messages  
  debug DEBUG bool false same do not issue debug messages  
  keep_going KEEP_GOING bool false same quit on first error  
  (none) PATHCONFIG string see below see below central path configuration file  
  parse_caching PARSE_CACHING int 100 same at most 100 parse trees will be cached in main memory  
  (none) LOCAL_PATHCONFIG string see below same user-specific path configuration file  
  warn_obsolete WARN_OBSOLETE bool true same issue warnings about obsolete C-style operators in description files  
  conserve_memory CONSERVE_MEMORY bool false same avoid repeated I/O operations by keeping certain information in main memory  

The fallback for PATHCONFIG is /usr/lib/smlnj-pathconfig, but the standard installation overrides this and uses $INSTALLDIR/lib/pathconfig (where $INSTALLDIR is the SML/NJ installation directory) instead.

The default for the ``local'' path configuration file is .smlnj-pathconfig. This file is located in the user's home directory (given by the environment variable $HOME).


next up previous contents
Next: E. Listing of all Up: CM The SML/NJ Compilation Previous: C. Listing of all   Contents
Matthias Blume
2001-07-19