14.09.2014 Views

CASINO manual - Theory of Condensed Matter

CASINO manual - Theory of Condensed Matter

CASINO manual - Theory of Condensed Matter

SHOW MORE
SHOW LESS

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

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!