2
require_once("docutil.php");
3
page_head("Preferences");
6
You can specify <b>preferences</b> that limit
7
when and how BOINC uses your computers.
8
Preferences are divided into two groups: General and Project.
10
<h2>Editing preferences</h2>
12
You can view and edit your preferences via the project's web site.
13
Click on 'Your account', then 'View or edit general preferences'.
16
Note: these links may be different on some projects.
17
For example, on Climateprediction.net you must click
18
'My CPDN', then 'BOINC CPDN', then 'Your account',
19
and 'View or edit general preferences'.
22
This shows you the preferences.
23
If you want to change anything,
24
click on 'Edit preferences'.
27
When you change your preferences on the web,
28
the changes won't take effect immediately on your computer;
29
they'll take effect the next time your computer
30
connects to the project's server.
31
If you want this to happen immediately,
32
bring up the BOINC Manager on your computer,
33
select the project, and click 'Update'.
36
If you're running BOINC on several computers,
37
preference changes will eventually propagate to all of them.
40
If you participate in multiple BOINC projects,
41
click <a href=multiple_projects.php>here</a>
42
for information about preferences.
44
<h2>Location-specific preferences</h2>
46
If you have computers at several locations (e.g. home, work and school)
47
you may want to use different preferences for different locations.
48
The preferences editing system (see above)
49
lets you create (or delete) separate preferences for home, work, and school.
52
Each computer attached to your account has a location.
53
To view this, go to the project's web site, then click
54
'Your account' and 'View Computers'.
55
Click on the ID of the computer you're interested in.
56
At the bottom of the page there's a popup menu
57
that lets you see or change the location.
58
A change to a computer's location will take effect
59
only when that computer contacts the server;
60
you can make this happen immediately
61
using the BOINC Manager's Update command.
64
If a computer has its location set to 'home' (for example),
65
and you've defined separate preferences for home,
66
it will use those preferences.
67
Otherwise it will use your default preferences.
70
Your account has a 'default location' (home, work, or school).
71
New computers attaching to your account will be given the default location.
72
The default location is part of your project preferences,
73
so to change it, edit your project preferences.
75
<h2>General preferences</h2>
76
<b>General preferences</b> apply to all BOINC projects in which you participate.
82
list_bar("Processor usage");
83
list_item("When to work",
84
"You can specify whether computation should be done
85
1) if the computer is in use (i.e. during keyboard and mouse input);
86
2) if the computer is being powered by batteries (for laptop users).
87
You can also specify a range of hours when work should be done.
91
list_item("Leave applications in memory while preempted",
92
"If yes, applications will be preempted by suspending and resuming,
94
This uses more virtual memory, but uses CPU time more efficiently."
97
list_item("Switch between applications every X minutes",
98
"This determines how often BOINC switches between projects."
100
list_item("Maximum number of processors to use",
101
"On a multiprocessor, this limits the number of processors
102
that BOINC will use."
104
list_item("Use at most X% of CPU time",
105
"It you specify 50%, BOINC will compute only every other second.
106
This reduces the heat output and energy usage of your CPU chip."
109
list_bar("Disk and memory usage");
111
list_item("Usage limits",
112
"You can limit the disk space used by BOINC in any of three ways:
113
1) Maximum disk space used by BOINC;
114
2) Maximum percentage of total space that can be used by BOINC.
115
3) Minimum disk space to keep free.
118
list_item("Access interval",
119
"A suggested interval between disk accesses.
120
Useful on laptops where the disk may be spun down for long periods.
124
list_item("Use at most X% of page file",
125
"Maximum percentage of your virtual memory page file
126
(also called 'swap space') used by BOINC"
128
list_item("Use at most X% of memory when computer is in use",
129
"Limits the amount of RAM used by BOINC applications
130
when your computer is in use
131
(i.e. when there has been recent mouse or keyboard activity).
132
Setting this to a low value lets you run BOINC
133
all the time without impacting your computer's performance."
135
list_item("Use at most X% of memory when computer is idle",
136
"Limits the amount of RAM used by BOINC applications
137
when your computer is not in use."
140
list_bar("Network usage");
141
list_item("Time of day limits",
142
"Limit the hours during which BOINC will do network communication."
144
list_item("Bandwidth limits",
145
"Limit the number of bytes per second uploaded or downloaded by BOINC."
147
list_item("Network connection preferences",
148
"Whether to wait for confirmation before making network connections,
149
and whether to disconnect when done.");
151
list_item("Time between network connections",
152
"Target time between network connections.
153
When your computer asks a server for work,
154
it will try to get enough work to last for this long."
161
<h2>Project preferences</h2>
162
There is a separate set of <b>project preferences</b>
163
for each project in which you participate.
169
"If projects contend for resources,
170
the amount allocated to a project is proportional to this number."
174
"Whether the project should send you newsletters by email."
177
"Hide computer information",
178
"Whether the project should show information
180
(their CPU and OS type, benchmark ratings etc.;
181
not their names or addresses)
185
"Default computer location",
186
"The location assigned to computers that attach to this account."
189
"Project-specific preferences",
190
"Defined by the project;
191
e.g., to specify graphics color schemes."
added
removed
doc/prefs.php
