// Berkeley Open Infrastructure for Network Computing // http://boinc.berkeley.edu // Copyright (C) 2005 University of California // // This 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 2.1 of the License, or (at your option) any later version. // // This software 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. // // To view the GNU Lesser General Public License visit // http://www.gnu.org/copyleft/lesser.html // or write to the Free Software Foundation, Inc., // 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA // An interface to BOINC graphics in which // the graphics code lives in a separate shared library. // This lets you make applications that work whether or not // the host has X11 and OpenGL libraries. #include #include "boinc_api.h" #include "graphics_api.h" #include "graphics_impl.h" #include "graphics_lib.h" static BOINC_MAIN_STATE boinc_main_state; void* graphics_lib_handle=NULL; #define BOINC_STRLEN 512 typedef int (*BIOGI_FUNC_PTR)(BOINC_OPTIONS&, WORKER_FUNC_PTR, BOINC_MAIN_STATE*); // ptr to a function like boinc_init_options_graphics_impl() // This routine never returns. // If a problem arises, it calls boinc_finish(nonzero). // // First argument: worker function // // Second argument: argv[0] from command line arguments. // This is the executable name, and is used to derive // the shared object library name: executable_name.so int boinc_init_graphics_lib(WORKER_FUNC_PTR worker, char* argv0) { BOINC_OPTIONS opt; boinc_options_defaults(opt); return boinc_init_options_graphics_lib(opt, worker, argv0); } int boinc_init_options_graphics_lib( BOINC_OPTIONS& opt, WORKER_FUNC_PTR worker, char* argv0 ) { char graphics_lib[BOINC_STRLEN]; char resolved_name[BOINC_STRLEN]; char *ptr; void *handle; int retval; char *errormsg; BIOGI_FUNC_PTR boinc_init_options_graphics_impl_hook; boinc_main_state.boinc_init_options_general_hook = boinc_init_options_general; boinc_main_state.boinc_is_standalone_hook = boinc_is_standalone; boinc_main_state.boinc_get_init_data_hook = boinc_get_init_data; boinc_main_state.set_worker_timer_hook = set_worker_timer; boinc_main_state.app_client_shmp = &app_client_shm; // figure out name of executable, and append .so // if ((ptr = strrchr(argv0, '/'))) { ptr++; } else { ptr = argv0; } strcpy(graphics_lib, ptr); strncat(graphics_lib, ".so", BOINC_STRLEN); graphics_lib[BOINC_STRLEN-1] = 0; // boinc-resolve library name: it could be a XML symlink // if (boinc_resolve_filename(graphics_lib, resolved_name, BOINC_STRLEN)) { fprintf(stderr, "Unable to boinc_resolve name of shared object file %s\n", graphics_lib ); goto no_graphics; } // get handle for shared library. Note that this handle is a // global variable, so it can be declared 'extern' in worker() and // thus worker() has access to functions from within this shared // library, also. // graphics_lib_handle = dlopen(resolved_name, RTLD_NOW); if (!graphics_lib_handle) { errormsg = dlerror(); fprintf(stderr, "dlopen() failed: %s\nNo graphics.\n", errormsg?errormsg:"" ); goto no_graphics; } // use handle from shared library to resolve the 'initialize // graphics' routine from shared library // boinc_init_options_graphics_impl_hook = (BIOGI_FUNC_PTR) dlsym( graphics_lib_handle, "boinc_init_options_graphics_impl" ); if (!boinc_init_options_graphics_impl_hook) { errormsg = dlerror(); fprintf(stderr, "dlsym(): no boinc_init_options_graphics_impl() in %s\n%s\n", resolved_name, errormsg?errormsg:"" ); goto no_graphics; } // here's where we start the graphics thread and the worker thread. // Normally this function should not return. // retval = boinc_init_options_graphics_impl_hook( opt, worker, &boinc_main_state ); if (retval) { fprintf(stderr, "boinc_init_options_graphics_impl() returned %d: unable to create worker thread\n", retval ); } boinc_finish(retval); // never get here... return 1; no_graphics: // unable to resolve the shared object file, or unable to resolve // library dependencies on machine (eg, no X11, no GL libraries, // etc) or unable to find needed symbol in library // boinc_init_options(opt); worker(); // worker() should call boinc_finish so we should NEVER get here! // boinc_finish(1); // never get here... return 1; } const char *BOINC_RCSID_93054c7e32 = "$Id$";