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"
19typedef unsigned int uint32_t;
20typedef unsigned long long uint64_t;
21typedef 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
32typedef 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 */
43uint64_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 */
51int __llvm_profile_write_buffer(char *Buffer);
52
53const __llvm_profile_data *__llvm_profile_begin_data(void);
54const __llvm_profile_data *__llvm_profile_end_data(void);
55const char *__llvm_profile_begin_names(void);
56const char *__llvm_profile_end_names(void);
57uint64_t *__llvm_profile_begin_counters(void);
58uint64_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, \c "default.profdata".
66 */
67int __llvm_profile_write_file(void);
68
69/*!
70 * \brief Set the filename for writing instrumentation data.
71 *
72 * Sets the filename to be used for subsequent calls to
73 * \a __llvm_profile_write_file().
74 *
75 * \c Name is not copied, so it must remain valid.  Passing NULL resets the
76 * filename logic to the default behaviour.
77 */
78void __llvm_profile_set_filename(const char *Name);
79
80/*! \brief Register to write instrumentation data to file at exit. */
81int __llvm_profile_register_write_file_atexit(void);
82
83/*! \brief Initialize file handling. */
84void __llvm_profile_initialize_file(void);
85
86/*! \brief Get the magic token for the file format. */
87uint64_t __llvm_profile_get_magic(void);
88
89/*! \brief Get the version of the file format. */
90uint64_t __llvm_profile_get_version(void);
91
92#endif /* PROFILE_INSTRPROFILING_H_ */
93