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>
|
2002-08-23 19:22:17 +00:00
|
|
|
A participant's accounts are described in a <b>preferences file</b>
|
2002-08-21 23:49:33 +00:00
|
|
|
on each of their hosts.
|
|
|
|
|
This file looks like this:
|
|
|
|
|
|
|
|
|
|
<pre>
|
2002-08-23 19:22:17 +00:00
|
|
|
<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>
|
|
|
|
|
<resource_share>1</resource_share>
|
2002-08-21 23:49:33 +00:00
|
|
|
<project>
|
2002-08-23 19:22:17 +00:00
|
|
|
<master_url>http://www.myproject.com/</master_url>
|
2002-08-21 23:49:33 +00:00
|
|
|
<authenticator>3f7b90793a0175ad0bda68684e8bd136</authenticator>
|
|
|
|
|
</project>
|
2002-08-23 19:22:17 +00:00
|
|
|
</preferences>
|
2002-08-21 23:49:33 +00:00
|
|
|
</pre>
|
