Global prefs override.xml

From BOINC
Jump to: navigation, search

Preferences override file

Preferences and host venue are maintained on a project server, edited via a web interface, and downloaded from the server. You can also set preferences locally (on a particular computer) in BOINC's Advanced View by clicking Advanced -> Preferences.

Local preferences are stored in 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. You can modify the preferences override file directly (in a text editor) if you like (for example, if you do not have the BOINC Manager installed).

After editing the preferences file, go to the Advanced View in BOINC manager and click Advanced -> Read local prefs file to make your new preferences take effect. If you do not have BOINC manager installed, restart the client or do boinccmd --read_global_prefs_override from a command line to have your new preferences take effect.

The preferences override file is named `global_prefs_override.xml` and it is located in the BOINC data directory. Its structure is as follows:

<global_preferences>
   <confirm_before_connecting/>
   <cpu_scheduling_period_minutes>%f</cpu_scheduling_period_minutes>
   <cpu_usage_limit>%f</cpu_usage_limit>
   <day_prefs>			
       <day_of_week>%d</day_of_week>
       <start_hour>%.02f</start_hour>
       <end_hour>%.02f</end_hour>
       <net_start_hour>%.02f</net_start_hour>
       <net_end_hour>%.02f</net_end_hour>
   </day_prefs>
   <disk_interval>%f</disk_interval>
   <disk_max_used_gb>%f</disk_max_used_gb>
   <disk_max_used_pct>%f</disk_max_used_pct>
   <disk_min_free_gb>%f</disk_min_free_gb>
   <dont_verify_images/>
   <end_hour>%f</end_hour>
   <hangup_if_dialed/>
   <host_venue>X</host_venue>
   <idle_time_to_run>%f</idle_time_to_run>
   <leave_apps_in_memory/>
   <max_bytes_sec_down>%f</max_bytes_sec_down>
   <max_bytes_sec_up>%f</max_bytes_sec_up>
   <max_cpus>%d</max_cpus>
   <net_end_hour>%f</net_end_hour>
   <net_start_hour>%f</net_start_hour>
   <ram_max_used_busy_pct>%f</ram_max_used_busy_pct>
   <ram_max_used_idle_pct>%f</ram_max_used_idle_pct>
   <run_if_user_active/>
   <run_on_batteries/>
   <start_hour>%f</start_hour>
   <suspend_cpu_usage>%f</suspend_cpu_usage>
   <suspend_if_no_recent_input>%f</suspend_if_no_recent_input>
   <vm_max_used_pct>%f</vm_max_used_pct>
   <work_buf_min_days>%f</work_buf_min_days>
   <work_buf_additional_days>%f</work_buf_additional_days>
</global_preferences>