From 0f0cb94fcf9117b52a477a55128123bafc4e662b Mon Sep 17 00:00:00 2001
From: Michele Cereda <cereda.michele@gmail.com>
Date: Mon, 29 May 2023 01:16:54 +0200
Subject: [PATCH] feat: boinc config files examples

---
 examples/boinc/app_config.xml            | 21 ++++++++
 examples/boinc/cc_config.xml             | 65 ++++++++++++++++++++++++
 examples/boinc/global_prefs_override.xml | 16 ++++++
 examples/boinc/gui_rpc_auth.cfg          |  1 +
 examples/boinc/remote_hosts.cfg          | 16 ++++++
 5 files changed, 119 insertions(+)
 create mode 100644 examples/boinc/app_config.xml
 create mode 100644 examples/boinc/cc_config.xml
 create mode 100644 examples/boinc/global_prefs_override.xml
 create mode 100644 examples/boinc/gui_rpc_auth.cfg
 create mode 100644 examples/boinc/remote_hosts.cfg

diff --git a/examples/boinc/app_config.xml b/examples/boinc/app_config.xml
new file mode 100644
index 0000000..f55200f
--- /dev/null
+++ b/examples/boinc/app_config.xml
@@ -0,0 +1,21 @@
+<!--
+  ${BOINC_DATA_DIR}/projects/${PROJECT}/app_config.xml
+  Configurtion file for specific applications or app versions.
+  See https://boinc.berkeley.edu/wiki/Client_configuration#Project-level_configuration
+  for a complete list of all the available options.
+-->
+
+<app_config>
+  <project_max_concurrent>
+    <!-- Limit the number of running jobs for this project. -->
+    3
+  </project_max_concurrent>
+  <report_results_immediately>
+    <!--
+      Report jobs to the project server as soon as they are finished.
+      Satisfies the inbuilt 60 second delay from the completion of the
+      result's upload.
+    -->
+    1
+  </report_results_immediately>
+</app_config>
diff --git a/examples/boinc/cc_config.xml b/examples/boinc/cc_config.xml
new file mode 100644
index 0000000..4ad6ff2
--- /dev/null
+++ b/examples/boinc/cc_config.xml
@@ -0,0 +1,65 @@
+<!--
+  ${BOINC_DATA_DIR}/cc_config.xml
+  Configurtion file for the BOINC core client.
+  See https://boinc.berkeley.edu/wiki/Client_configuration#Client_configuration
+  for a complete list of all the available options.
+-->
+
+<cc_config>
+  <options>
+    
+    <!-- Avoid storing more than the minimum required data on disk. -->
+
+    <abort_jobs_on_exit>
+      <!-- Abort jobs and update projects when the client exits. -->
+      1
+    </abort_jobs_on_exit>
+    <fetch_minimal_work>
+      <!-- Fetch only one job per device. -->
+      1
+    </fetch_minimal_work>
+    <report_results_immediately>
+      <!--
+        Report jobs to the project server as soon as they are finished.
+        Satisfies the inbuilt 60 second delay from the completion of the
+        result's upload.
+      -->
+      1
+    </report_results_immediately>
+
+
+    <!--
+      Act as if the host had N CPUs.
+      Zero means to use the actual number of CPUs.
+      Intented to simulate more CPUs than effectively available. Use the
+      computing preferences to limit CPU usage instead.
+    -->
+    <ncpus>4</ncpus>
+
+
+    <!-- Don't accept jobs for specific devices. -->
+
+    <dont_use_vbox>1</dont_use_vbox>
+
+    <!--
+      0 is the first GPU for the vendor.
+      1 is the second, and so on.
+    -->
+    <ignore_intel_dev>0</ignore_intel_dev>
+    <ignore_nvidia_dev>0</ignore_nvidia_dev>
+
+
+    <!--
+      Allow GUI RPCs from *any* remote host.
+      See https://boinc.berkeley.edu/wiki/Controlling_BOINC_remotely.
+    -->
+    <allow_remote_gui_rpc>1</allow_remote_gui_rpc>
+
+  </options>
+  <log_flags>
+    <!-- Already on by default. -->
+    <task>1</task>
+    <file_xfer>1</file_xfer>
+    <sched_ops>1</sched_ops>
+  </log_flags>
+</cc_config>
diff --git a/examples/boinc/global_prefs_override.xml b/examples/boinc/global_prefs_override.xml
new file mode 100644
index 0000000..228242d
--- /dev/null
+++ b/examples/boinc/global_prefs_override.xml
@@ -0,0 +1,16 @@
+<!--
+  ${BOINC_DATA_DIR}/global_prefs_override.xml
+  Configurtion file for the BOINC core client that can be used to override global
+  preferences locally.
+  See http://boinc.berkeley.edu/trac/wiki/PrefsOverride and
+  https://boinc.berkeley.edu/wiki/Global_prefs_override.xml for a complete list
+  of all preferences which can be overridden.
+-->
+
+<global_preferences>
+  <cpu_usage_limit>100</cpu_usage_limit>
+  <max_cpus>1024</max_cpus>
+  <max_ncpus_pct>90</max_ncpus_pct>
+  <run_if_user_active>0</run_if_user_active>
+  <suspend_cpu_usage>40</suspend_cpu_usage>
+</global_preferences>
diff --git a/examples/boinc/gui_rpc_auth.cfg b/examples/boinc/gui_rpc_auth.cfg
new file mode 100644
index 0000000..434d199
--- /dev/null
+++ b/examples/boinc/gui_rpc_auth.cfg
@@ -0,0 +1 @@
+yourPasswordHere
diff --git a/examples/boinc/remote_hosts.cfg b/examples/boinc/remote_hosts.cfg
new file mode 100644
index 0000000..fc874e8
--- /dev/null
+++ b/examples/boinc/remote_hosts.cfg
@@ -0,0 +1,16 @@
+################################################################################
+# ${BOINC_DATA_DIR}/remote_hosts.cfg
+#
+# This file contains a list of hostnames or IP addresses (one per line). Those
+# are the remote hosts that are allowed to connect and to control the local
+# BOINC core client via GUI RPCs.
+# Lines beginning with a # or a ; are treated like comments and will be
+# ignored.
+################################################################################
+
+#host.example.com
+#192.168.0.180
+
+alfredo.lan
+magic.local
+192.168.1.10