Changes between Version 1 and Version 2 of OptionsApi

Timestamp:

Dec 18, 2008, 4:37:13 PM (16 years ago)

Author:

davea

Comment:

--

OptionsApi

@@ -3 +3 @@
 == Setting options ==
 
-The BOINC API provides a number of functions, and in developing a compound application you must decide whether these functions are to be performed by the main or worker program. The functions are represented by flags in the BOINC_OPTIONS structure. Each flag must be set in either the main or worker programs, but not both.
-
+The following runtime system options are available:
 
 {{{
 struct BOINC_OPTIONS {
+    int backwards_compatible_graphics;
+    int normal_thread_priority;
     int main_program;
     int check_heartbeat;
@@ -17 +18 @@
 };
 
-int boinc_init_options(BOINC_OPTIONS*);
+BOINC_OPTIONS options;
+boinc_options_defaults(options);   // set defaults
+options.main_program = 0;          // set values as needed
+...
+int boinc_init_options(&options);
 }}}
 
+The options are:
+ '''backwards_compatible_graphics'''::
+        If set, the application will handle graphics messages from pre-version 6 client, and attempt to handle them by launching a graphics app if present.  Default is true.
+ '''normal_thread_priority'''::
+        If set, the application will run at normal thread priority (Windows).  This is recommended for CUDA applications, so that the GPU will run at full speed even if the CPUs are loaded.  Default is false.
+
+The remaining options determine what runtime system functions will be performed by this program.
+This is primarily for the use of [CompoundApps compound applications].
+In developing a compound application you must decide whether these functions are to be performed by the main or worker program.
+Each flag must be set in either the main or worker programs, but not both.
 
  '''main_program'''::
@@ -35 +50 @@
  '''direct_process_action'''::
         If set, the program will respond to quit messages and heartbeat     failures by exiting, and will respond to suspend and resume     messages by suspending and resuming.     Otherwise, these events will result in changes to     the BOINC_STATUS structure,     which can be polled using boinc_get_status().
- '''all_threads_cpu_time'''::
-        If set, the CPU of all threads (not just the worker thread)     will be counted.     For apps that do computation in more than one thread.