mirror of https://github.com/BOINC/boinc.git
83 lines
2.4 KiB
PHP
83 lines
2.4 KiB
PHP
<?
|
|
require_once("docutil.php");
|
|
page_head("Core client: file structure");
|
|
echo "
|
|
<p>
|
|
The core client runs in a <b>BOINC home directory</b>.
|
|
It creates and uses the following files and directories within the
|
|
home directory:
|
|
<ul>
|
|
<li>
|
|
<b>prefs.xml</b>:
|
|
The user's general preferences; see below.
|
|
<li>
|
|
<b>client_state.xml</b> describes of the files,
|
|
application, workunits and results present on this client.
|
|
<li>
|
|
<b>Account files</b> describes the participant's account
|
|
in each subscribed project,
|
|
including the resource share and project-specific preferences.
|
|
It contains no host-specific information.
|
|
The name of the account file is <b>account_PROJECT.xml</b>,
|
|
where PROJECT is an encoded version of the project's master URL.
|
|
<li>
|
|
A directory <b>projects</b>,
|
|
which contains a <b>project directory</b> for each subscribed project.
|
|
The name of a project directory is an encoded
|
|
version of the project's master URL.
|
|
The project directory contains all files (inputs,
|
|
outputs, executables) related to the project.
|
|
<li>
|
|
<b>slots</b>: this directory contains one subdirectory for each
|
|
CPU 'slot' (normally there are as many slots as the host has CPUs).
|
|
The subdirectories are named 0, 1, ... N-1.
|
|
</ul>
|
|
<p>
|
|
Each result executes in particular slot directory.
|
|
The core client creates 'soft link' files in the slot directory,
|
|
linking to the corresponding files in the project directory.
|
|
|
|
<h3>Format of account files</h3>
|
|
The format of an account file is as follows:
|
|
<pre>
|
|
";
|
|
echo htmlspecialchars("
|
|
<account>
|
|
<master_url>http://www.myproject.com/</master_url>
|
|
<authenticator>3f7b90793a0175ad0bda68684e8bd136</authenticator>
|
|
[ <project_name>...</project_name> ]
|
|
[ <tentative/> ]
|
|
<project_preferences>
|
|
<resource_share>1</resource_share>
|
|
<project_specific>
|
|
...
|
|
</project_specific>
|
|
[ <venue>...</venue> ]
|
|
</project_preferences>
|
|
</account>
|
|
");
|
|
echo "
|
|
</pre>
|
|
The <project_preferences> field is
|
|
the 'project_prefs' field of the user database record.
|
|
|
|
<h3>Format of prefs.xml</h3>
|
|
<p>
|
|
This format of prefs.xml is as follows:
|
|
|
|
<pre>
|
|
<preferences>
|
|
<prefs_mod_time>1030128387</prefs_mod_time>
|
|
<from_project>http://www.myproject.com/</from_project>
|
|
<from_scheduler>http://server3.myproject.com/cgi-bin/scheduler_cgi</from_scheduler>
|
|
<mod_time>2</mod_time>
|
|
<high_water_days>2</high_water_days>
|
|
<low_water_days>1</low_water_days>
|
|
</preferences>
|
|
|
|
XXX this is not complete
|
|
</pre>
|
|
";
|
|
page_tail();
|
|
?>
|