// This file is part of BOINC.
// http://boinc.berkeley.edu
// Copyright (C) 2008 University of California
//
// BOINC is free software; you can redistribute it and/or modify it
// under the terms of the GNU Lesser General Public License
// as published by the Free Software Foundation,
// either version 3 of the License, or (at your option) any later version.
//
// BOINC is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
// See the GNU Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public License
// along with BOINC. If not, see .
#ifndef _PREFS_
#define _PREFS_
#include
#include "miofile.h"
#include "parse.h"
// global prefs are maintained as follows:
// 1) a "global_prefs.xml" file, which stores the "network" prefs;
// it's maintained by communication with scheduling servers
// or project managers
// 2) a "global_prefs_override.xml" file, which can be edited manually
// or via a GUI.
// For the prefs that it specifies, it overrides the network prefs.
// A struct with one bool per pref.
// This is passed in GUI RPCs (get/set_global_prefs_override_struct)
// to indicate which prefs are (or should be) specified in the override file
//
struct GLOBAL_PREFS_MASK {
bool run_on_batteries;
bool run_if_user_active;
bool run_gpu_if_user_active;
bool idle_time_to_run;
bool suspend_if_no_recent_input;
bool start_hour;
bool end_hour;
bool net_start_hour;
bool net_end_hour;
bool leave_apps_in_memory;
bool confirm_before_connecting;
bool hangup_if_dialed;
bool dont_verify_images;
bool work_buf_min_days;
bool work_buf_additional_days;
bool max_ncpus_pct;
bool max_ncpus;
bool cpu_scheduling_period_minutes;
bool disk_interval;
bool disk_max_used_gb;
bool disk_max_used_pct;
bool disk_min_free_gb;
bool vm_max_used_frac;
bool ram_max_used_busy_frac;
bool ram_max_used_idle_frac;
bool max_bytes_sec_up;
bool max_bytes_sec_down;
bool cpu_usage_limit;
GLOBAL_PREFS_MASK();
void clear();
bool are_prefs_set();
bool are_simple_prefs_set();
void set_all();
};
// 0..24
// run always if start==end or start==0, end=24
// don't run at all if start=24, end=0
//
struct TIME_SPAN {
bool present;
double start_hour;
double end_hour;
enum TimeMode {
Always = 7000,
Never,
Between
};
TIME_SPAN() : start_hour(0), end_hour(0) {}
TIME_SPAN(double start, double end) : start_hour(start), end_hour(end) {}
bool suspended(double hour) const;
TimeMode mode() const;
};
struct WEEK_PREFS {
TIME_SPAN days[7];
void clear() {
memset(this, 0, sizeof(WEEK_PREFS));
}
WEEK_PREFS() {
clear();
}
void set(int day, double start, double end);
void set(int day, TIME_SPAN* time);
void unset(int day);
protected:
void copy(const WEEK_PREFS& original);
};
struct TIME_PREFS : public TIME_SPAN {
WEEK_PREFS week;
TIME_PREFS() {}
TIME_PREFS(double start, double end) {
start_hour = start;
end_hour = end;
}
void clear();
bool suspended() const;
};
struct GLOBAL_PREFS {
double mod_time;
bool run_on_batteries;
// poorly named; what it really means is:
// if false, suspend while on batteries
bool run_if_user_active;
bool run_gpu_if_user_active;
double idle_time_to_run;
double suspend_if_no_recent_input;
bool leave_apps_in_memory;
bool confirm_before_connecting;
bool hangup_if_dialed;
bool dont_verify_images;
TIME_PREFS cpu_times;
TIME_PREFS net_times;
double work_buf_min_days;
double work_buf_additional_days;
double max_ncpus_pct;
int max_ncpus;
double cpu_scheduling_period_minutes;
double disk_interval;
double disk_max_used_gb;
double disk_max_used_pct;
double disk_min_free_gb;
double vm_max_used_frac;
double ram_max_used_busy_frac;
double ram_max_used_idle_frac;
double max_bytes_sec_up;
double max_bytes_sec_down;
double cpu_usage_limit;
char source_project[256];
char source_scheduler[256];
bool host_specific;
GLOBAL_PREFS();
void defaults();
void init();
void clear_bools();
int parse(XML_PARSER&, const char* venue, bool& found_venue, GLOBAL_PREFS_MASK& mask);
int parse_day(XML_PARSER&);
int parse_override(XML_PARSER&, const char* venue, bool& found_venue, GLOBAL_PREFS_MASK& mask);
int parse_file(const char* filename, const char* venue, bool& found_venue);
int write(MIOFILE&);
int write_subset(MIOFILE&, GLOBAL_PREFS_MASK&);
void write_day_prefs(MIOFILE&);
inline double cpu_scheduling_period() {
return cpu_scheduling_period_minutes*60;
}
};
#endif