Changes between Version 10 and Version 11 of OptionsApi


Ignore:
Timestamp:
Jan 26, 2015, 1:22:21 PM (9 years ago)
Author:
davea
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • OptionsApi

    v10 v11  
    1 = Runtime system options =
     1= APIs for wrappers =
    22
    3 You can customize the behavior of the BOINC runtime system
    4 by using '''boinc_init_options()''' instead of '''boinc_init()'''.
    5 For example:
     3Wrappers (wrapper, vboxwrapper, wrappture) use the following
     4API to control the behavior of the BOINC runtime system.
    65
    76{{{
     
    98
    109boinc_options_defaults(options);
    11 options.multi_thread = true;    // include this if your app's main process uses multiple threads
    12 options.multi_process = true;   // include this if your app uses multiple processes
    13 
     10options.main_program = true;
     11... set options
    1412boinc_init_options(&options);
    1513}}}
    16 
    17 Do not create any threads or store the current PID
    18 before calling '''boinc_init_options()'''.
    19 The following options are available:
    2014
    2115{{{
    2216struct BOINC_OPTIONS {
    2317    int normal_thread_priority;
     18    int multi_thread;
     19    int multi_process;
    2420    int main_program;
    2521    int check_heartbeat;
     
    2723    int handle send_status_msgs;
    2824    int direct_process_action;
    29     int multi_thread;
    30     int multi_process;
    3125};
    3226}}}
    3327
    34 The options are:
    35  '''normal_thread_priority'''::
    36        If set, the application will run at normal thread priority (Windows).
    37        This is recommended for CUDA applications, so that the GPU will run at full speed even if the CPUs are loaded.
    38        Default is false.
    39  '''multi_thread''':: Set this if your application uses multiple threads (e.g., OpenMP or pthreads).
    40  '''multi_process''':: Set this if your application creates sub-processes (e.g., MPI).
     28The first three options are described [BasicApi#init here].
    4129
    4230The remaining options determine what runtime system functions will be performed by this program.
    43 This is primarily for the use of [CompoundApps compound applications].
    44 In developing a compound application you must decide whether these functions
     31In developing a wrapper application you must decide whether these functions
    4532are to be performed by the main or worker program.
    4633Each flag must be set in either the main or worker programs, but not both.
     
    4936      Set this in the main program.
    5037 '''check_heartbeat'''::
    51     If set, the program monitors 'heartbeat' messages from the core client.
     38    If set, the program monitors 'heartbeat' messages from the client.
    5239    If the heartbeat stops, the result depends on the direct_process_action flag (see below).
    5340 '''handle_process_control'''::