2002-08-19 18:43:10 +00:00
|
|
|
<title>Platforms, Applications, and Versions</title>
|
2002-08-20 23:54:17 +00:00
|
|
|
<body bgcolor=ffffff>
|
2002-07-29 19:01:38 +00:00
|
|
|
<h2>Platforms, Applications, and Versions</h2>
|
2002-05-17 22:33:57 +00:00
|
|
|
<p>
|
2002-08-19 18:43:10 +00:00
|
|
|
A <b>platform</b> is a compilation target (Windows/Intel,
|
2002-07-31 00:05:10 +00:00
|
|
|
Linux/Intel, MacOS/PPC, etc.).
|
2002-08-21 23:49:33 +00:00
|
|
|
Platforms are maintained in the <b>platform</b> table in the BOINC DB,
|
|
|
|
|
and can be created using the <a href="tools_other.html">add</a> utility.
|
2002-07-31 00:05:10 +00:00
|
|
|
|
2002-05-17 22:33:57 +00:00
|
|
|
<p>
|
2002-08-21 23:49:33 +00:00
|
|
|
An <b>application</b> consists of an executable program,
|
|
|
|
|
perhaps with versions for various platforms.
|
2002-07-31 00:05:10 +00:00
|
|
|
A project can operate many applications.
|
2002-08-21 23:49:33 +00:00
|
|
|
Applications are maintained in the <b>application</b> table in the BOINC DB,
|
|
|
|
|
and can be created using the <a href="tools_other.html">add</a> utility.
|
2002-07-31 00:05:10 +00:00
|
|
|
|
2002-05-17 22:33:57 +00:00
|
|
|
<p>
|
2002-08-19 18:43:10 +00:00
|
|
|
An application program may go through a sequence of
|
|
|
|
|
<ahref="version.html">versions</a>.
|
2002-07-31 00:05:10 +00:00
|
|
|
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-08-19 18:43: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-08-19 18:43:10 +00:00
|
|
|
Each application has a <b>minimum version</b>.
|
2002-07-31 00:05:10 +00:00
|
|
|
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-08-19 18:43: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>
|
2002-08-21 23:49:33 +00:00
|
|
|
</pre> The <a href="tools_other.html">add</a> utility provides a
|
2002-07-29 19:01:38 +00:00
|
|
|
simplified interface for creating application versions.
|
