CASINO manual - Theory of Condensed Matter
CASINO manual - Theory of Condensed Matter
CASINO manual - Theory of Condensed Matter
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
* "Generic" <strong>CASINO</strong>_ARCHs are intended to represent a class <strong>of</strong> systems. Their<br />
name is typically <strong>of</strong> one <strong>of</strong> these forms:<br />
- Single-processor workstations:<br />
-<br />
- Multi-processor workstations:<br />
--parallel<br />
- Clusters with queueing systems:<br />
---parallel<br />
* "Extended" <strong>CASINO</strong>_ARCHs are intended to represent specific systems, and are<br />
usually modifications to existing generic <strong>CASINO</strong>_ARCHs. Their name is <strong>of</strong> the<br />
form:<br />
.<br />
The corresponding .arch file is typically intended to "include" its generic<br />
counterpart, if it exists, but again this is just a guideline.<br />
See the files in the <strong>CASINO</strong>/arch/data directory for examples <strong>of</strong> both generic<br />
and extended <strong>CASINO</strong>_ARCH names.<br />
II. Data file format<br />
====================<br />
The architecture data file is structured in three sections:<br />
* The first section contains architecture parameters ("tags", see below).<br />
* The second section contains any optional ’include’ statements, always<br />
<strong>of</strong> the form:<br />
include $(INCBASE)/.arch<br />
* The third section contains Makefile definitions (see below).<br />
The file is designed to be ’include’d by the Makefiles in the distribution,<br />
hence the lines in the first section start with the hash character ’#’ so that<br />
they are ignored by ’make’. The first section is read by the ’runqmc’ script<br />
and by the <strong>CASINO</strong>/arch/arch_info.sh assessment tool.<br />
When editing .arch files, you are encouraged to use the syntax highlighting<br />
file provided with <strong>CASINO</strong>, see <strong>CASINO</strong>/data/syntax for more info.<br />
II.1. Data file tags<br />
====================<br />
The beginning <strong>of</strong> architecture data files contain tags which can be used to<br />
identify the machine it is designed for, and to specify how to run <strong>CASINO</strong> on<br />
that machine. Tag contents can be single- or multi-line.<br />
Single-line tags are specified this way:<br />
#-! TAG-NAME: tag-value<br />
#-! tag-value-continue<br />
#-! ...<br />
#-! ANOTHER-TAG_NAME: ...<br />
(no indentation before ’#-!’, *one* space between ’#-!’ and TAG-NAME, no space<br />
between TAG-NAME and the colon; one or more spaces between the colon and<br />
tag-value; two or more spaces between ’#-!’ and tag-value-continue). Leading<br />
221