blob: 1a4345003d58b6c2b6a1f987654c73cedbd08ff9 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
|
// Copyright Vespa.ai. Licensed under the terms of the Apache 2.0 license. See LICENSE in the project root.
#pragma once
#include <vespa/vespalib/stllike/string.h>
namespace vespalib {
/**
* Gets a textual stack trace from the current frame of execution.
* Potentially very expensive call, so only use in exceptional circumstances.
*
* @param ignoreTop number of frames to skip from the top of the stack
* @return Stacktrace complete with resolved (although still mangled) symbols
*/
string getStackTrace(int ignoreTop);
/**
* Gets a textual stack trace from an existing buffer of stack frames.
* Potentially very expensive call, so only use in exceptional circumstances.
*
* @param ignoreTop number of frames to skip from the top of the stack
* @param stack buffer of stack frame addresses
* @param size number of valid frame addresses in the buffer
* @return Stacktrace complete with resolved (although still mangled) symbols
*/
string getStackTrace(int ignoreTop, void* const* stack, int size);
/**
* Get the stack frame addresses from the current frame of execution.
* Lightweight call, as it does not involve any symbol resolving.
*
* @param framesOut buffer receiving up to maxFrames stack frame addresses
* @param maxFrames maximum number of addresses to return (must be <=
* size of buffer)
* @return number of frame addresses actually stored in framesOut
*/
int getStackTraceFrames(void** framesOut, int maxFrames);
}
|
