2002-08-19 18:43:10 +00:00
|
|
|
<title>Core Client: File Structure</title>
|
2002-08-20 23:54:17 +00:00
|
|
|
<body bgcolor=ffffff>
|
2002-07-29 19:01:38 +00:00
|
|
|
<h2>Core Client: File Structure</h2>
|
2002-04-30 22:22:54 +00:00
|
|
|
<p>
|
2002-08-19 18:43:10 +00:00
|
|
|
The core client runs in a BOINC home directory.
|
|
|
|
|
An account file (accounts.xml) must be present in this directory.
|
|
|
|
|
The core client
|
2002-07-29 19:01:38 +00:00
|
|
|
creates and uses the following files and directories within the BOINC
|
|
|
|
|
home directory:
|
2002-04-30 22:22:54 +00:00
|
|
|
<ul>
|
2002-08-19 18:43:10 +00:00
|
|
|
<li>
|
|
|
|
|
<b>client_state.xml</b>: this is an description of the files,
|
2002-07-29 19:01:38 +00:00
|
|
|
application, workunits and results present on this client.
|
2002-08-19 18:43:10 +00:00
|
|
|
<li>
|
|
|
|
|
Each project has a <b>project subdirectory</b> whose name is the
|
|
|
|
|
project's base URL.
|
|
|
|
|
This subdirectory contains all files (inputs,
|
2002-07-29 19:01:38 +00:00
|
|
|
outputs, executables) related to the project.
|
2002-08-19 18:43:10 +00:00
|
|
|
<li>
|
|
|
|
|
<b>slots</b>: this directory contains one subdirectory for each
|
2002-07-29 19:01:38 +00:00
|
|
|
CPU "slot" (normally there are as many slots as the host has CPUs). The
|
|
|
|
|
subdirectories are named 0, 1, ... N-1.
|
2002-04-30 22:22:54 +00:00
|
|
|
</ul>
|
|
|
|
|
<p>
|
2002-08-19 18:43:10 +00:00
|
|
|
Each result executes in particular slot. The core client creates
|
2002-07-29 19:01:38 +00:00
|
|
|
symbolic links (UNIX) or .lnk files (Windows) in the slot directory,
|
|
|
|
|
linking the input, output and executable files to the appropriate files
|
|
|
|
|
in the project directory. On UNIX, the core client uses chroot() so that
|
|
|
|
|
the application sees the slot directory as the root of its filesystem,
|
|
|
|
|
and cannot create or access files outside of it.
|
2002-08-21 23:49:33 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
A participant's accounts are described in an <b>account file</b>
|
|
|
|
|
on each of their hosts.
|
|
|
|
|
This file looks like this:
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
<accounts>
|
|
|
|
|
<project>
|
|
|
|
|
<home_project/>
|
|
|
|
|
<domain>setiathome.berkeley.edu</domain>
|
|
|
|
|
<scheduler_url>http://setiathome.berkeley.edu/boinc-cgi/cgi</scheduler_url>
|
|
|
|
|
<authenticator>3f7b90793a0175ad0bda68684e8bd136</authenticator>
|
|
|
|
|
</project>
|
|
|
|
|
<project>
|
|
|
|
|
<domain>bio.wwu.edu</domain>
|
|
|
|
|
<scheduler_url>http://bio.wwu.edu/boinc-cgi/cgi</scheduler_url>
|
|
|
|
|
<authenticator>3f7b90793a0175ad0bda68684e8bd136</authenticator>
|
|
|
|
|
</project>
|
|
|
|
|
</accounts>
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
One account can be designated as the <b>home project</b>;
|
|
|
|
|
this is the project where the user maintains their preferences.
|
