| 1 | = Preferences override file = |
| 2 | |
| 3 | By default, [GlobalPrefs global preferences] and host venue are maintained on a project server, edited via a web interface, and downloaded from the server. Some people may want to edit preferences locally, modify preferences on a single host, or hardwire the host venue. To accommodate these requirements, BOINC lets you create a 'preferences override file'. This file is read by the core client after it reads the preferences from the server, and it overrides those preferences. |
| 4 | |
| 5 | The preferences override file is named `global_prefs_override.xml`. Its structure as follows: |
| 6 | |
| 7 | |
| 8 | {{{ |
| 9 | <global_preferences> |
| 10 | <run_on_batteries>0</run_on_batteries> |
| 11 | <run_if_user_active>0</run_if_user_active> |
| 12 | <start_hour>0</start_hour> |
| 13 | <end_hour>0</end_hour> |
| 14 | <net_start_hour>0</net_start_hour> |
| 15 | <net_end_hour>0</net_end_hour> |
| 16 | <leave_apps_in_memory>0</leave_apps_in_memory> |
| 17 | <confirm_before_connecting>0</confirm_before_connecting> |
| 18 | <hangup_if_dialed>0</hangup_if_dialed> |
| 19 | <work_buf_min_days>0.1</work_buf_min_days> |
| 20 | <max_cpus>2</max_cpus> |
| 21 | <cpu_scheduling_period_minutes>60</cpu_scheduling_period_minutes> |
| 22 | <disk_interval>60</disk_interval> |
| 23 | <disk_max_used_gb>100</disk_max_used_gb> |
| 24 | <disk_max_used_pct>50</disk_max_used_pct> |
| 25 | <disk_min_free_gb>0.1</disk_min_free_gb> |
| 26 | <vm_max_used_pct>75</vm_max_used_pct> |
| 27 | <ram_max_used_busy_pct>50</ram_max_used_busy_pct> |
| 28 | <ram_max_used_idle_pct>90</ram_max_used_idle_pct> |
| 29 | <idle_time_to_run>3</idle_time_to_run> |
| 30 | <max_bytes_sec_down>0</max_bytes_sec_down> |
| 31 | <max_bytes_sec_up>0</max_bytes_sec_up> |
| 32 | <cpu_usage_limit>100</cpu_usage_limit> |
| 33 | </global_preferences> |
| 34 | [ <host_venue>venue</host_venue> ] |
| 35 | }}} |
| 36 | If you write a program for editing preferences locally, you'll want to be able to tell a running core client to reread the preferences override file. You can do this using the [http://boinc.berkeley.edu/gui_rpc.php read_global_prefs_override()] GUI RPC. Or you can stop and start the core client. |
| 37 | |