1 /*===- InstrProfiling.h- Support library for PGO instrumentation ----------===*\ 2 |* 3 |* The LLVM Compiler Infrastructure 4 |* 5 |* This file is distributed under the University of Illinois Open Source 6 |* License. See LICENSE.TXT for details. 7 |* 8 \*===----------------------------------------------------------------------===*/ 9 10 #ifndef PROFILE_INSTRPROFILING_H_ 11 #define PROFILE_INSTRPROFILING_H_ 12 13 #if defined(__FreeBSD__) && defined(__i386__) 14 15 /* System headers define 'size_t' incorrectly on x64 FreeBSD (prior to 16 * FreeBSD 10, r232261) when compiled in 32-bit mode. 17 */ 18 #define PRIu64 "llu" 19 typedef unsigned int uint32_t; 20 typedef unsigned long long uint64_t; 21 typedef uint32_t uintptr_t; 22 23 #else /* defined(__FreeBSD__) && defined(__i386__) */ 24 25 #include <inttypes.h> 26 #include <stdint.h> 27 28 #endif /* defined(__FreeBSD__) && defined(__i386__) */ 29 30 #define PROFILE_HEADER_SIZE 7 31 32 typedef struct __llvm_profile_data { 33 const uint32_t NameSize; 34 const uint32_t NumCounters; 35 const uint64_t FuncHash; 36 const char *const Name; 37 uint64_t *const Counters; 38 } __llvm_profile_data; 39 40 /*! 41 * \brief Get required size for profile buffer. 42 */ 43 uint64_t __llvm_profile_get_size_for_buffer(void); 44 45 /*! 46 * \brief Write instrumentation data to the given buffer. 47 * 48 * \pre \c Buffer is the start of a buffer at least as big as \a 49 * __llvm_profile_get_size_for_buffer(). 50 */ 51 int __llvm_profile_write_buffer(char *Buffer); 52 53 const __llvm_profile_data *__llvm_profile_begin_data(void); 54 const __llvm_profile_data *__llvm_profile_end_data(void); 55 const char *__llvm_profile_begin_names(void); 56 const char *__llvm_profile_end_names(void); 57 uint64_t *__llvm_profile_begin_counters(void); 58 uint64_t *__llvm_profile_end_counters(void); 59 60 /*! 61 * \brief Write instrumentation data to the current file. 62 * 63 * Writes to the file with the last name given to \a __llvm_profile_set_filename(), 64 * or if it hasn't been called, the \c LLVM_PROFILE_FILE environment variable, 65 * or if that's not set, the last name given to 66 * \a __llvm_profile_override_default_filename(), or if that's not set, 67 * \c "default.profraw". 68 */ 69 int __llvm_profile_write_file(void); 70 71 /*! 72 * \brief Set the filename for writing instrumentation data. 73 * 74 * Sets the filename to be used for subsequent calls to 75 * \a __llvm_profile_write_file(). 76 * 77 * \c Name is not copied, so it must remain valid. Passing NULL resets the 78 * filename logic to the default behaviour. 79 */ 80 void __llvm_profile_set_filename(const char *Name); 81 82 /*! 83 * \brief Set the filename for writing instrumentation data, unless the 84 * \c LLVM_PROFILE_FILE environment variable was set. 85 * 86 * Unless overridden, sets the filename to be used for subsequent calls to 87 * \a __llvm_profile_write_file(). 88 * 89 * \c Name is not copied, so it must remain valid. Passing NULL resets the 90 * filename logic to the default behaviour (unless the \c LLVM_PROFILE_FILE 91 * was set in which case it has no effect). 92 */ 93 void __llvm_profile_override_default_filename(const char *Name); 94 95 /*! \brief Register to write instrumentation data to file at exit. */ 96 int __llvm_profile_register_write_file_atexit(void); 97 98 /*! \brief Initialize file handling. */ 99 void __llvm_profile_initialize_file(void); 100 101 /*! \brief Get the magic token for the file format. */ 102 uint64_t __llvm_profile_get_magic(void); 103 104 /*! \brief Get the version of the file format. */ 105 uint64_t __llvm_profile_get_version(void); 106 107 #endif /* PROFILE_INSTRPROFILING_H_ */ 108