Skip to content
Snippets Groups Projects
Select Git revision
  • master default protected
  • fix_Makefile.mingw#2
  • update_Makefile.mingw
  • fix_Makefile.mingw
  • fix_API_for_C_apps
  • fix_procinfo_mac
  • boinccmd_gpu_mode_always_until_sigterm
  • fgrp_osx_hotfix
  • fix_boinc_master@f8250782
  • eah_wrapper_improvements
  • diagnostics_win-hotfix
  • diagnostics_win-hotfix-old
  • current_fgrp_apps
  • testing_gw_apps
  • gw_app_darwin_15
  • current_brp_apps
  • current_brp_apps_android10
  • current_gfx_apps
  • current_server
  • current_gw_apps
  • previous_fgrp_apps
  • previous_gw_apps
  • testing_brp_apps
  • apps_FGRP3_1.07
  • apps_FGRP3_1.08
25 results

boinc_api.h

Blame
    • Eric J. Korpela's avatar
      3c58c389
      - API: Added new function boinc_set_credit_claim() for use by projects that · 3c58c389
      Eric J. Korpela authored
          want to grant approximately fixed credits, but don't want to express them in 
          terms of FPOPS and IOPS.  This API just calls boinc_ops_cumulative(N*8.64000e+11,0).
          CPU intensive projects that use this API should still use the
          tools/calculate_credit_multiplier script in order to adjust their credit
          claims as processing times vary.
      
      
      svn path=/trunk/boinc/; revision=17743
      3c58c389
      History
      - API: Added new function boinc_set_credit_claim() for use by projects that
      Eric J. Korpela authored
          want to grant approximately fixed credits, but don't want to express them in 
          terms of FPOPS and IOPS.  This API just calls boinc_ops_cumulative(N*8.64000e+11,0).
          CPU intensive projects that use this API should still use the
          tools/calculate_credit_multiplier script in order to adjust their credit
          claims as processing times vary.
      
      
      svn path=/trunk/boinc/; revision=17743
    boinc_api.h 5.19 KiB
    // This file is part of BOINC.
    // http://boinc.berkeley.edu
    // Copyright (C) 2008 University of California
    //
    // BOINC is free software; you can redistribute it and/or modify it
    // under the terms of the GNU Lesser General Public License
    // as published by the Free Software Foundation,
    // either version 3 of the License, or (at your option) any later version.
    //
    // BOINC is distributed in the hope that it will be useful,
    // but WITHOUT ANY WARRANTY; without even the implied warranty of
    // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
    // See the GNU Lesser General Public License for more details.
    //
    // You should have received a copy of the GNU Lesser General Public License
    // along with BOINC.  If not, see <http://www.gnu.org/licenses/>.
    
    #ifndef _BOINC_API_
    #define _BOINC_API_
    
    #ifdef __APPLE__
    #include <Carbon/Carbon.h>
    #endif
    
    // ANSI C API BEGINS HERE
    // Do not put implementation stuff here
    
    #ifdef __cplusplus
    extern "C" {
    #endif
    typedef struct BOINC_OPTIONS {
        // the following are booleans, implemented as ints for portability
        int backwards_compatible_graphics;
            // V6 apps should set this so that "Show Graphics" will work
            // with pre-V6 clients
        int normal_thread_priority;
            // run app at normal thread priority on Win.
            // (default is idle priority)
        int main_program;
            // this is the main program, so
            // - lock a lock file in the slot directory
            // - write finish file on successful boinc_finish()
        int check_heartbeat;
            // action is determined by direct_process_action (see below)
        int handle_trickle_ups;
            // this process is allowed to call boinc_send_trickle_up()
        int handle_trickle_downs;
            // this process is allowed to call boinc_receive_trickle_down()
        int handle_process_control;
            // action is determined by direct_process_action (see below)
        int send_status_msgs;
            // send CPU time / fraction done msgs
        int direct_process_action;
            // if heartbeat fail, or get process control msg, take
            // direction action (exit, suspend, resume).
            // Otherwise just set flag in BOINC status
    } BOINC_OPTIONS;
    
    typedef struct BOINC_STATUS {
        int no_heartbeat;
        int suspended;
        int quit_request;
        int reread_init_data_file;
        int abort_request;
        double working_set_size;
        double max_working_set_size;
    } BOINC_STATUS;
    
    typedef void (*FUNC_PTR)();
    
    struct APP_INIT_DATA;
    
    extern int boinc_init(void);
    extern int boinc_finish(int status);
    extern int boinc_resolve_filename(const char*, char*, int len);
    extern int boinc_get_init_data_p(struct APP_INIT_DATA*);
    extern int boinc_parse_init_data_file(void);
    extern int boinc_send_trickle_up(char* variety, char* text);
    extern int boinc_checkpoint_completed(void);
    extern int boinc_fraction_done(double);
    extern int boinc_suspend_other_activities(void);
    extern int boinc_resume_other_activities(void);
    extern int boinc_report_app_status(double, double, double);
    extern int boinc_time_to_checkpoint();
    extern void boinc_begin_critical_section();
    extern int boinc_try_critical_section();
    extern void boinc_end_critical_section();
    extern void boinc_need_network();
    extern int boinc_network_poll();
    extern void boinc_network_done();
    extern int boinc_is_standalone(void);
    extern void boinc_ops_per_cpu_sec(double fp, double integer);
    extern void boinc_ops_cumulative(double fp, double integer);
    extern void boinc_set_credit_claim(double credit);
    extern int boinc_receive_trickle_down(char* buf, int len);
    extern int boinc_init_options(BOINC_OPTIONS*);
    extern int boinc_get_status(BOINC_STATUS*);
    extern double boinc_get_fraction_done();
    extern void boinc_register_timer_callback(FUNC_PTR);
    extern double boinc_worker_thread_cpu_time();
    extern void boinc_exit(int);    // deprecated
    
    #ifdef __APPLE__
    extern int setMacPList(void);
    extern int setMacIcon(char *filename, char *iconData, long iconSize);
    #endif
    
    #ifdef __cplusplus
    } // extern "C" {
    #endif
    
    // C++ API follows 
    #ifdef __cplusplus
    #include <string>
    
    #include "app_ipc.h"
    extern int boinc_resolve_filename_s(const char*, std::string&);
    extern int boinc_get_init_data(APP_INIT_DATA&);
    extern int boinc_wu_cpu_time(double&);
    extern int boinc_upload_file(std::string& name);
    extern int boinc_upload_status(std::string& name);
    extern int boinc_write_init_data_file(APP_INIT_DATA&);
    extern char* boinc_msg_prefix();
    extern int suspend_activities();   // deprecated
    extern int resume_activities();    // deprecated
    extern int restore_activities();    //deprecated
    
    /////////// API ENDS HERE
    
    /////////// IMPLEMENTATION STUFF BEGINS HERE
    
    extern void options_defaults(BOINC_OPTIONS&);
    extern APP_CLIENT_SHM *app_client_shm;
    #ifdef _WIN32
    extern HANDLE worker_thread_handle;
    #endif
    extern int boinc_init_options_general(BOINC_OPTIONS& opt);
    extern int start_timer_thread();
    extern bool g_sleep;
    
    inline void boinc_options_defaults(BOINC_OPTIONS& b) {
        b.main_program = 1;
        b.check_heartbeat = 1;
        b.handle_trickle_ups = 1;
        b.handle_trickle_downs = 1;
        b.handle_process_control = 1;
        b.send_status_msgs = 1;
        b.direct_process_action = 1;
        b.backwards_compatible_graphics = 1;
        b.normal_thread_priority = 0;
    }
    
    
    /////////// IMPLEMENTATION STUFF ENDS HERE
    
    #endif // C++ part
    
    #endif // double-inclusion protection