1 /*--------------------------------------------------------------------*/ 2 /*--- Callgrind ---*/ 3 /*--- events.h ---*/ 4 /*--------------------------------------------------------------------*/ 5 6 /* 7 This file is part of Callgrind, a Valgrind tool for call tracing. 8 9 Copyright (C) 2002-2013, Josef Weidendorfer (Josef.Weidendorfer@gmx.de) 10 11 This program is free software; you can redistribute it and/or 12 modify it under the terms of the GNU General Public License as 13 published by the Free Software Foundation; either version 2 of the 14 License, or (at your option) any later version. 15 16 This program is distributed in the hope that it will be useful, but 17 WITHOUT ANY WARRANTY; without even the implied warranty of 18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 19 General Public License for more details. 20 21 You should have received a copy of the GNU General Public License 22 along with this program; if not, write to the Free Software 23 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 24 02111-1307, USA. 25 26 The GNU General Public License is contained in the file COPYING. 27 */ 28 29 /* Abstractions for 64-bit cost lists (events.h) */ 30 31 #ifndef CLG_EVENTS 32 #define CLG_EVENTS 33 34 #include "pub_tool_basics.h" 35 36 #define CLG_(str) VGAPPEND(vgCallgrind_,str) 37 38 /* Event groups consist of one or more named event types. 39 * Event sets are constructed from such event groups. 40 * 41 * Event groups have to be registered globally with a unique ID 42 * before they can be used in an event set. 43 * A group can appear at most once in a event set. 44 */ 45 46 #define MAX_EVENTGROUP_COUNT 10 47 48 typedef struct _EventGroup EventGroup; 49 struct _EventGroup { 50 Int size; 51 const HChar* name[0]; 52 }; 53 54 /* return 0 if event group can not be registered */ 55 EventGroup* CLG_(register_event_group) (int id, const HChar*); 56 EventGroup* CLG_(register_event_group2)(int id, const HChar*, const HChar*); 57 EventGroup* CLG_(register_event_group3)(int id, const HChar*, const HChar*, 58 const HChar*); 59 EventGroup* CLG_(register_event_group4)(int id, const HChar*, const HChar*, 60 const HChar*, const HChar*); 61 EventGroup* CLG_(get_event_group)(int id); 62 63 /* Event sets are defined by event groups they consist of. */ 64 65 typedef struct _EventSet EventSet; 66 struct _EventSet { 67 /* if subset with ID x is in the set, then bit x is set */ 68 UInt mask; 69 Int count; 70 Int size; 71 Int offset[MAX_EVENTGROUP_COUNT]; 72 }; 73 74 /* Same event set is returned when requesting same event groups */ 75 EventSet* CLG_(get_event_set)(Int id); 76 EventSet* CLG_(get_event_set2)(Int id1, Int id2); 77 EventSet* CLG_(add_event_group)(EventSet*, Int id); 78 EventSet* CLG_(add_event_group2)(EventSet*, Int id1, Int id2); 79 EventSet* CLG_(add_event_set)(EventSet*, EventSet*); 80 81 82 /* Operations on costs. A cost pointer of 0 means zero cost. 83 * Functions ending in _lz allocate cost arrays only when needed 84 */ 85 ULong* CLG_(get_eventset_cost)(EventSet*); 86 /* Set costs of event set to 0 */ 87 void CLG_(init_cost)(EventSet*,ULong*); 88 /* This always allocates counter and sets them to 0 */ 89 void CLG_(init_cost_lz)(EventSet*,ULong**); 90 /* Set costs of an event set to zero */ 91 void CLG_(zero_cost)(EventSet*,ULong*); 92 Bool CLG_(is_zero_cost)(EventSet*,ULong*); 93 void CLG_(copy_cost)(EventSet*,ULong* dst, ULong* src); 94 void CLG_(copy_cost_lz)(EventSet*,ULong** pdst, ULong* src); 95 void CLG_(add_cost)(EventSet*,ULong* dst, ULong* src); 96 void CLG_(add_cost_lz)(EventSet*,ULong** pdst, ULong* src); 97 /* Adds src to dst and zeros src. Returns false if nothing changed */ 98 Bool CLG_(add_and_zero_cost)(EventSet*,ULong* dst, ULong* src); 99 Bool CLG_(add_and_zero_cost2)(EventSet*,ULong* dst,EventSet*,ULong* src); 100 /* Adds difference of new and old to to dst, and set old to new. 101 * Returns false if nothing changed */ 102 Bool CLG_(add_diff_cost)(EventSet*,ULong* dst, ULong* old, ULong* new_cost); 103 Bool CLG_(add_diff_cost_lz)(EventSet*,ULong** pdst, ULong* old, ULong* new_cost); 104 105 /* EventMapping: An ordered subset of events from an event set. 106 * This is used to print out part of an EventSet, or in another order. 107 */ 108 struct EventMappingEntry { 109 Int group; 110 Int index; 111 Int offset; 112 }; 113 typedef struct _EventMapping EventMapping; 114 struct _EventMapping { 115 EventSet* es; 116 Int size; 117 Int capacity; 118 struct EventMappingEntry entry[0]; 119 }; 120 121 /* Allocate space for an event mapping */ 122 EventMapping* CLG_(get_eventmapping)(EventSet*); 123 void CLG_(append_event)(EventMapping*, const HChar*); 124 /* Returns event mapping as a character string. That string is dynamically 125 allocated and it is the caller's responsibility to free it. 126 The function never returns NULL. */ 127 HChar *CLG_(eventmapping_as_string)(const EventMapping*); 128 /* Returns mapping cost as a character string. That string is dynamically 129 allocated and it is the caller's responsibility to free it. 130 The function never returns NULL. */ 131 HChar *CLG_(mappingcost_as_string)(const EventMapping*, const ULong*); 132 133 #endif /* CLG_EVENTS */ 134