The CHARON-SSP virtual machines can be configured using a text-based configuration file or the CHARON-SSP Manager GUI.

This section describes the format and content of the text-based configuration file.  The configuration file is made up of a number of sections that describe various aspects of the virtual machine environment.  The remaining sections describes the different sections and their syntax.

Syntax

The configuration file format for CHARON-SSP follows the “INI file” format originally pioneered by MS-DOS and 16-bit Microsoft Windows. The syntax is described in EBNF (Extended Bakus Naur Format) below.

The following briefly describes each configuration file syntax element.

Section

The configuration file is divided into sections.  These sections are denoted by names enclosed in ‘[‘ and ‘]’.  Figure … shows an example header.

There is no “end of section” delimiter.  A section ends when either the end of file is reached or a new section is encountered.

Properties

Configuration options (properties) are specified as key/value pairs.  Key names are separated from values by the ‘=’ character.  All characters following the ‘=’ character to the end of the line are considered part of the value.  Figure n shows an example key/value pair.

Comments

Comments are ignored by the emulator.  They are provided for human readers and writers to leave informative notes.  A comment starts with the '#' character and continues to the end of the line.  Figure n shows some example comments.

Blank Lines

Blank lines are ignored by the emulator.  They should be used to break up the configuration file, making it easier for a human reader to analyze.

Reference

The following sections describe how to manipulate the configuration objects and their members to set up a virtual SPARC machine: