server-skynet-source-3rd-je.../include/jemalloc/internal/prof_hook.h

#ifndef JEMALLOC_INTERNAL_PROF_HOOK_H
#define JEMALLOC_INTERNAL_PROF_HOOK_H

#include "jemalloc/internal/jemalloc_preamble.h"

/*
 * The hooks types of which are declared in this file are experimental and
 * undocumented, thus the typedefs are located in an 'internal' header.
 */

/*
 * A hook to mock out backtrace functionality.  This can be handy, since it's
 * otherwise difficult to guarantee that two allocations are reported as coming
 * from the exact same stack trace in the presence of an optimizing compiler.
 */
typedef void (*prof_backtrace_hook_t)(void **, unsigned *, unsigned);

/*
 * A callback hook that notifies about recently dumped heap profile.
 */
typedef void (*prof_dump_hook_t)(const char *filename);

/* ptr, size, backtrace vector, backtrace vector length */
typedef void (*prof_sample_hook_t)(const void *, size_t, void **, unsigned);

/* ptr, size */
typedef void (*prof_sample_free_hook_t)(const void *, size_t);

#endif /* JEMALLOC_INTERNAL_PROF_HOOK_H */
Allow setting custom backtrace hook Existing backtrace implementations skip native stack frames from runtimes like Python. The hook allows to augment the backtraces to attribute allocations to native functions in heap profiles. 2021-08-31 05:05:56 +08:00			`#ifndef JEMALLOC_INTERNAL_PROF_HOOK_H`
			`#define JEMALLOC_INTERNAL_PROF_HOOK_H`

Make headers self-contained by fixing `#include`s Header files are now self-contained, which makes the relationships between the files clearer, and crucially allows LSP tools like `clangd` to function correctly in all of our header files. I have verified that the headers are self-contained (aside from the various Windows shims) by compiling them as if they were C files – in a follow-up commit I plan to add this to CI to ensure we don't regress on this front. 2023-06-10 08:37:47 +08:00			`#include "jemalloc/internal/jemalloc_preamble.h"`

Allow setting custom backtrace hook Existing backtrace implementations skip native stack frames from runtimes like Python. The hook allows to augment the backtraces to attribute allocations to native functions in heap profiles. 2021-08-31 05:05:56 +08:00			`/*`
			`* The hooks types of which are declared in this file are experimental and`
			`* undocumented, thus the typedefs are located in an 'internal' header.`
			`*/`

			`/*`
			`* A hook to mock out backtrace functionality. This can be handy, since it's`
			`* otherwise difficult to guarantee that two allocations are reported as coming`
			`* from the exact same stack trace in the presence of an optimizing compiler.`
			`*/`
			`typedef void (prof_backtrace_hook_t)(void , unsigned , unsigned);`

Allow setting a dump hook If users want to be notified when a heap dump occurs, they can set this hook. 2021-09-02 04:00:01 +08:00			`/*`
			`* A callback hook that notifies about recently dumped heap profile.`
			`*/`
			`typedef void (prof_dump_hook_t)(const char filename);`

Implement prof sample hooks "experimental.hooks.prof_sample(_free)". The added hooks hooks.prof_sample and hooks.prof_sample_free are intended to allow advanced users to track additional information, to enable new ways of profiling on top of the jemalloc heap profile and sample features. The sample hook is invoked after the allocation and backtracing, and forwards the both the allocation and backtrace to the user hook; the sample_free hook happens before the actual deallocation, and forwards only the ptr and usz to the hook. 2022-11-03 06:17:16 +08:00			`/* ptr, size, backtrace vector, backtrace vector length */`
			`typedef void (prof_sample_hook_t)(const void , size_t, void **, unsigned);`

			`/* ptr, size */`
			`typedef void (prof_sample_free_hook_t)(const void , size_t);`

Allow setting custom backtrace hook Existing backtrace implementations skip native stack frames from runtimes like Python. The hook allows to augment the backtraces to attribute allocations to native functions in heap profiles. 2021-08-31 05:05:56 +08:00			`#endif /* JEMALLOC_INTERNAL_PROF_HOOK_H */`