2002-07-29 19:01:38 +00:00
|
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
|
|
|
|
|
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
|
|
|
|
|
<html lang="en">
|
|
|
|
|
<head>
|
2002-07-31 00:05:10 +00:00
|
|
|
<title>Platforms, Applications, and Versions</title>
|
|
|
|
|
<meta name="generator" content="BBEdit 6.1.2">
|
2002-07-29 19:01:38 +00:00
|
|
|
</head>
|
|
|
|
|
<body>
|
|
|
|
|
<h2>Platforms, Applications, and Versions</h2>
|
2002-05-17 22:33:57 +00:00
|
|
|
<p>
|
2002-07-31 00:05:10 +00:00
|
|
|
A <b>platform</b> is a compilation target (Windows/Intel,
|
|
|
|
|
Linux/Intel, MacOS/PPC, etc.).
|
|
|
|
|
Platforms are maintained in the <b>platform</b> table in the BOINC
|
|
|
|
|
DB, and can be created using the <a href="tools.html">add</a>
|
|
|
|
|
utility program.
|
|
|
|
|
|
2002-05-17 22:33:57 +00:00
|
|
|
<p>
|
2002-07-31 00:05:10 +00:00
|
|
|
An <b>application</b> is a computational task; in concrete terms it
|
2002-07-29 19:01:38 +00:00
|
|
|
consists of an executable program (perhaps in versions for various
|
2002-07-31 00:05:10 +00:00
|
|
|
platforms) and a set of input files to be processed by the program.
|
|
|
|
|
A project can operate many applications.
|
|
|
|
|
Applications are maintained in the <b>application</b> table in the
|
|
|
|
|
BOINC DB, and can be created using the <a href="tools.html">add</a>
|
|
|
|
|
utility.
|
|
|
|
|
|
2002-05-17 22:33:57 +00:00
|
|
|
<p>
|
2002-07-31 00:05:10 +00:00
|
|
|
An application program may go through a sequence of <a
|
|
|
|
|
href="version.html">versions</a>.
|
|
|
|
|
A particular version, compiled for a particular platform, is
|
|
|
|
|
called an <b>application version</b>.
|
|
|
|
|
An application version can consist of multiple files: for example, a
|
2002-07-29 19:01:38 +00:00
|
|
|
controller script, pre- and post-processing programs, and a primary.
|
2002-07-31 00:05:10 +00:00
|
|
|
|
2002-07-29 00:39:45 +00:00
|
|
|
<p>
|
2002-07-31 00:05:10 +00:00
|
|
|
Each application version has an integer <b>version number</b>.
|
2002-07-29 19:01:38 +00:00
|
|
|
Projects can assign version numbers however they like; for example,
|
2002-07-31 00:05:10 +00:00
|
|
|
version 304 might represent major version 3 and minor version 4.
|
|
|
|
|
Version numbers should be used consistently across platforms;
|
|
|
|
|
Windows version 304 should be computationally identical to
|
|
|
|
|
Mac version 304.
|
|
|
|
|
|
2002-07-29 00:39:45 +00:00
|
|
|
<p>
|
2002-07-31 00:05:10 +00:00
|
|
|
Each application has a <b>minimum version</b>.
|
|
|
|
|
When a client is sent work for an application, it is also sent
|
|
|
|
|
the latest application version for its platform.
|
|
|
|
|
It is sent work only if this version is the minimum or greater.
|
|
|
|
|
|
2002-05-17 22:33:57 +00:00
|
|
|
<p>
|
2002-07-31 00:05:10 +00:00
|
|
|
Application version are maintained in the <b>app_version</b> table
|
2002-07-29 19:01:38 +00:00
|
|
|
in the BOINC DB, Each entry includes an XML document describing the
|
|
|
|
|
files that make up the application version:
|
2002-05-17 22:33:57 +00:00
|
|
|
<pre>
|
2002-07-31 00:05:10 +00:00
|
|
|
<file_info> ...
|
|
|
|
|
</file_info>
|
|
|
|
|
[ ...
|
|
|
|
|
]
|
2002-07-29 19:01:38 +00:00
|
|
|
<app_version>
|
|
|
|
|
<app_name>foobar</app_name>
|
|
|
|
|
<version_num>4</version_num>
|
|
|
|
|
<file_ref>
|
|
|
|
|
<file_name>program_1</file_name>
|
|
|
|
|
<main_program/>
|
|
|
|
|
</file_ref>
|
|
|
|
|
<file_ref>
|
|
|
|
|
<file_name>library_12</file_name>
|
|
|
|
|
</file_ref>
|
|
|
|
|
</app_version>
|
|
|
|
|
</pre> The <a href="tools.html">add</a> utility program provides a
|
|
|
|
|
simplified interface for creating application versions.
|
2002-07-31 00:05:10 +00:00
|
|
|
|
2002-07-29 19:01:38 +00:00
|
|
|
</body>
|
|
|
|
|
</html>
|
