Changes between Version 34 and Version 35 of BasicApi

Timestamp:

May 29, 2011, 8:32:52 PM (13 years ago)

Author:

davea

Comment:

--

BasicApi

@@ -16 +16 @@
 
 {{{
-BOINC_OPTIONS options;
-
-boinc_options_defaults(options);
-options.multi_thread = true;    // include this if your app's main process uses multiple threads
-options.multi_process = true;   // include this if your app uses multiple processes
-
-boinc_init_options(&options);
+boinc_init();
 }}}
 
 Do not create any threads or store the current PID
-before calling '''boinc_init_options()'''.
+before calling '''boinc_init()'''.
 
 When the application has completed it must call
@@ -85 +79 @@
 }}}
 
-This deals with platform-specific problems. On Windows, where security and indexing programs can briefly lock files, `boinc_fopen()` does several retries at 1-second intervals. On Unix, where signals can cause `fopen()` to fail with `EINTR`, `boinc_fopen` checks for this and does a few retries; it also sets the 'close-on-exec' flag.
+This deals with platform-specific problems.
+On Windows, where security and indexing programs can briefly lock files,
+`boinc_fopen()` does several retries at 1-second intervals.
+On Unix, where signals can cause `fopen()` to fail with `EINTR`,
+`boinc_fopen` checks for this and does a few retries; it also sets the 'close-on-exec' flag.
 
 == Checkpointing == #checkpointing
@@ -169 +167 @@
 An application should never 'reset' and start over if an error occurs; it should exit with an error code.
 
-== Miscellaneous data ==
-
-The following functions return miscellaneous data:
-
-{{{
-#!c++
-int boinc_get_init_data_p(APP_INIT_DATA*);
-int boinc_get_init_data(APP_INIT_DATA&);
-
-struct APP_INIT_DATA {
-    int major_version;
-    int minor_version;
-    int release;
-    int app_version;
-    char app_name[256];
-    char symstore[256];
-    char acct_mgr_url[256];
-    char* project_preferences;
-    int hostid;
-    char user_name[256];
-    char team_name[256];
-    char project_dir[256];
-    char boinc_dir[256];
-    char wu_name[256];
-    char authenticator[256];
-    int slot;
-    double user_total_credit;
-    double user_expavg_credit;
-    double host_total_credit;
-    double host_expavg_credit;
-    double resource_share_fraction;
-    HOST_INFO host_info;
-    PROXY_INFO proxy_info;  // in case app wants to use network
-    GLOBAL_PREFS global_prefs;
-    double starting_elapsed_time;
-
-    // info about the WU
-    double rsc_fpops_est;
-    double rsc_fpops_bound;
-    double rsc_memory_bound;
-    double rsc_disk_bound;
-
-    // the following are used for compound apps,
-    // where each stage of the computation is a fixed
-    // fraction of the total.
-    double fraction_done_start;
-    double fraction_done_end;
-};
-}}}
-
-to get the following information:
-
-||'''core version'''||The version number of the core client||
-||'''app_name'''||The application name (from the server's DB)||
-||'''project_preferences'''||An XML string containing the user's project-specific preferences.||
-||'''user_name'''||The user's 'screen name' on this project.||
-||'''team_name'''||The user's team name, if any.||
-||'''project_dir'''||Absolute path of project directory||
-||'''boinc_dir'''||Absolute path of BOINC root directory||
-||'''wu_name'''||Name of workunit being processed||
-||'''authenticator'''||User's authenticator for this project||
-||'''slot'''||The number of the app's 'slot'||
-||'''user_total_credit'''||User's total work for this project.||
-||'''user_expavg_credit'''||User's recent average work per day.||
-||'''team_total_credit'''||Team's total work for this project.||
-||'''team_expavg_credit'''||Team's recent average work per day.||
-||'''host_info'''||A structure describing the host hardware and OS||
-||'''starting_elapsed_time'''||Elapsed time, counting previous episodes (provided only by 6.10 and later clients)||
+
 
 == Timing information ==