Changes between Version 53 and Version 54 of BasicApi


Ignore:
Timestamp:
Jan 26, 2015, 12:01:43 PM (9 years ago)
Author:
davea
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • BasicApi

    v53 v54  
    268268which will be called once per second.
    269269
    270 
    271 
    272270== Temporary exit ==
    273271
     
    293291   In this case "is_notice" would be true,
    294292   because the user can update VirtualBox.
    295 
    296 == Graphics Status ==
    297 
    298 Used by worker applications to inform graphics applications of various pieces of
    299 runtime state information.
    300 
    301 Worker applications call:
    302 {{{
    303 #!c++
    304 int boinc_write_graphics_status(
    305     double cpu_time, double elapsed_time, double fraction_done
    306 );
    307 }}}
    308 
    309 Graphics applications call:
    310 {{{
    311 #!c++
    312 int boinc_parse_graphics_status(
    313     double* update_time, double* cpu_time, double* elapsed_time, double* fraction_done, BOINC_STATUS* status
    314 );
    315 }}}
    316 
    317 === Graphics Status File ===
    318 
    319 The graphics status file has the name of '''graphics_status.xml'''.
    320 
    321 It has following structure:
    322 {{{
    323 <graphics_status>
    324     <updated_time>X</updated_time>
    325     <cpu_time>X</cpu_time>
    326     <elapsed_time>X</elapsed_time>
    327     <fraction_done>X</fraction_done>
    328     <boinc_status>
    329         <no_heartbeat>0|1</no_heartbeat>
    330         <suspended>0|1</suspended>
    331         <quit_request>0|1</quit_request>
    332         <reread_init_data_file>0|1</reread_init_data_file>
    333         <abort_request>0|1</abort_request>
    334         <network_suspended>0|1</network_suspended>
    335     </boinc_status>
    336 </graphics_status>
    337 }}}
    338 Required elements:
    339  '''updated_time'''::
    340     UNIX time of the last time this file was updated.
    341  '''cpu_time'''::
    342     Amount of CPU time this task has consumed, in seconds.
    343  '''elapsed_time'''::
    344     Amount of wall clock time this task has consumed, in seconds.
    345  '''fraction_done'''::
    346     What percentage of the overall task is complete, values between 0..1.
    347  '''no_heartbeat'''::
    348     Whether or not the task has received a heartbeat as of the last update.
    349  '''suspended'''::
    350     Whether or not the task is suspended.
    351  '''quit_request'''::
    352     Whether or not the task has been requested to exit.
    353  '''reread_init_data_file'''::
    354     Whether or not the task should reread all initialization data.
    355  '''abort_request'''::
    356     Whether or not the task has been requested to abort.
    357  '''network_suspended'''::
    358     Whether or not the task has been told the network has been suspended.