1 /* Copyright (C) 2021-2024 Free Software Foundation, Inc. 2 Contributed by Oracle. 3 4 This file is part of GNU Binutils. 5 6 This program is free software; you can redistribute it and/or modify 7 it under the terms of the GNU General Public License as published by 8 the Free Software Foundation; either version 3, or (at your option) 9 any later version. 10 11 This program is distributed in the hope that it will be useful, 12 but WITHOUT ANY WARRANTY; without even the implied warranty of 13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 GNU General Public License for more details. 15 16 You should have received a copy of the GNU General Public License 17 along with this program; if not, write to the Free Software 18 Foundation, 51 Franklin Street - Fifth Floor, Boston, 19 MA 02110-1301, USA. */ 20 21 #ifndef _COLLECTORAPI_H 22 #define _COLLECTORAPI_H 23 24 /* This file contains function prototypes for the user-callable API 25 routines in libcollector. */ 26 27 #include <pthread.h> 28 29 #ifdef __cplusplus 30 extern "C" 31 { 32 #endif 33 /* Routine to record a sample in the experiment. */ 34 extern void collector_sample (const char *name); 35 36 /* Routine to suspend data collection during an experiment. */ 37 extern void collector_pause (void); 38 39 /* Routine to resume data collection during an experiment. */ 40 extern void collector_resume (void); 41 42 /* Routine to suspend per-thread data collection during an experiment. */ 43 extern void collector_thread_pause (pthread_t tid); 44 45 /* Routine to resume per-thread data collection during an experiment. */ 46 extern void collector_thread_resume (pthread_t tid); 47 48 /* Routine to close the experiment, and stop all data collection. */ 49 extern void collector_terminate_expt (void); 50 51 typedef struct 52 { 53 unsigned int offset; 54 unsigned int lineno; 55 } Lineno; 56 57 /* Routines to let libcollector know about dynamically loaded functions. */ 58 extern void collector_func_load (const char *name, const char *alias, 59 const char *sourcename, void *vaddr, 60 int size, int lntsize, Lineno *lntable); 61 62 extern void collector_func_unload (void *vaddr); 63 64 #ifdef NEED_COLLECTOR_MODULE 65 extern void collector_module_load (const char *modulename, void *vaddr); 66 extern void collector_module_unload (void *vaddr); 67 #endif 68 69 #ifdef __cplusplus 70 } 71 #endif 72 73 #endif /* _COLLECTORAPI_H */ 74