2002-08-19 18:43:10 +00:00
|
|
|
<title>Preferences</title>
|
2002-08-20 23:54:17 +00:00
|
|
|
<body bgcolor=ffffff>
|
2002-07-29 19:01:38 +00:00
|
|
|
<h2>Preferences</h2>
|
2002-04-30 22:22:54 +00:00
|
|
|
<p>
|
2002-08-19 18:43:10 +00:00
|
|
|
Participants can specify <b>preferences</b> determining and limiting
|
2002-08-20 23:54:17 +00:00
|
|
|
how BOINC uses their computers.
|
|
|
|
|
Preferences are divided into three groups:
|
2002-05-29 23:25:21 +00:00
|
|
|
<ul>
|
2002-08-19 18:43:10 +00:00
|
|
|
<li> <b>Work preferences</b>
|
2002-04-30 22:22:54 +00:00
|
|
|
<ul>
|
2002-08-19 18:43:10 +00:00
|
|
|
<li> Whether work (computation and network transfer) should be done
|
2002-07-29 19:01:38 +00:00
|
|
|
while the host is being used (i.e. during keyboard and mouse input).
|
2002-08-19 18:43:10 +00:00
|
|
|
<li> Whether work should be done while the computer is being powered
|
2002-08-30 00:10:40 +00:00
|
|
|
by batteries (for laptop users).
|
2002-08-19 18:43:10 +00:00
|
|
|
<li> Whether to wait for user confirmation before making network connections.
|
|
|
|
|
<li> Minimum and maximum amounts of work to maintain on disk.
|
2002-08-21 23:49:33 +00:00
|
|
|
These values are expressed as time values X and Y.
|
2002-08-19 18:43:10 +00:00
|
|
|
The client will try to ensure it
|
2002-08-21 23:49:33 +00:00
|
|
|
has at least enough work to keep it busy for X days, and at most Y days.
|
|
|
|
|
If the host is frequently disconnected from the Internet, X
|
|
|
|
|
should be at least as long as the typical period of disconnection.
|
|
|
|
|
The larger the difference between X and Y, the less often
|
2002-07-29 19:01:38 +00:00
|
|
|
BOINC will connect to the Internet.
|
2002-04-30 22:22:54 +00:00
|
|
|
</ul>
|
2002-08-19 18:43:10 +00:00
|
|
|
<li> <b>Disk preferences</b>
|
2002-07-29 19:01:38 +00:00
|
|
|
BOINC's usage of disk space can be limited in one or more of the
|
|
|
|
|
following ways:
|
2002-05-29 23:25:21 +00:00
|
|
|
<ul>
|
2002-08-19 18:43:10 +00:00
|
|
|
<li> Maximum disk space used by BOINC.
|
2002-08-21 23:49:33 +00:00
|
|
|
<li> Maximum percentage of free space used by BOINC.
|
2002-08-19 18:43:10 +00:00
|
|
|
<li> Minimum disk space to keep free.
|
2002-05-29 23:25:21 +00:00
|
|
|
</ul>
|
2002-08-19 18:43:10 +00:00
|
|
|
<li> <b>Project preferences</b> (one set for each project)
|
2002-05-29 23:25:21 +00:00
|
|
|
<ul>
|
2002-08-19 18:43:10 +00:00
|
|
|
<li> Master URL of project
|
|
|
|
|
<li> Email address
|
2002-08-21 23:49:33 +00:00
|
|
|
<li> Account ID
|
|
|
|
|
<li> Resource share: if projects contend for resources,
|
|
|
|
|
the amount allocated to a project is proportional to this number.
|
2002-08-19 18:43:10 +00:00
|
|
|
<li> Whether to show email address on web site
|
|
|
|
|
<li> Whether project should send emails to user
|
|
|
|
|
<li> Project-specific preferences
|
2002-05-29 23:25:21 +00:00
|
|
|
</ul>
|
|
|
|
|
</ul>
|
2002-04-30 22:22:54 +00:00
|
|
|
<p>
|
2002-08-19 18:43:10 +00:00
|
|
|
Each participant has a single set of preferences.
|
|
|
|
|
If you want to have different preferences for different hosts,
|
2002-08-30 00:10:40 +00:00
|
|
|
you must create a separate account.
|
2002-08-19 18:43:10 +00:00
|
|
|
|
2002-07-29 19:01:38 +00:00
|
|
|
<h3>Propagation of preferences</h3>
|
2002-04-30 22:22:54 +00:00
|
|
|
<p>
|
2002-08-21 23:49:33 +00:00
|
|
|
The BOINC client stores a copy of the preferences.
|
2002-08-19 18:43:10 +00:00
|
|
|
Whenever a host contacts a scheduling server, the request
|
|
|
|
|
message includes the preferences and their last-modification time.
|
2002-08-21 23:49:33 +00:00
|
|
|
If the server has a more recently modified version of the preferences,
|
|
|
|
|
it returns these to the client.
|
|
|
|
|
Thus a change to preferences is eventually propagated to all hosts,
|
|
|
|
|
and to the databases of all enrolled projects.
|
2002-08-20 23:54:17 +00:00
|
|
|
A participant may edit preferences on the web site of any enrolled project;
|
|
|
|
|
however, care should be taken to ensure that a change isn't
|
2002-08-19 18:43:10 +00:00
|
|
|
overwritten by an earlier change.
|
|
|
|
|
The easiest way to do this is to edit preferences only at one web site.
|
