1 //===-- sanitizer_stackdepot.h ----------------------------------*- C++ -*-===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // This file is shared between AddressSanitizer and ThreadSanitizer
10 // run-time libraries.
11 //===----------------------------------------------------------------------===//
12 
13 #ifndef SANITIZER_STACKDEPOT_H
14 #define SANITIZER_STACKDEPOT_H
15 
16 #include "sanitizer_common.h"
17 #include "sanitizer_internal_defs.h"
18 #include "sanitizer_stacktrace.h"
19 
20 namespace __sanitizer {
21 
22 // StackDepot efficiently stores huge amounts of stack traces.
23 struct StackDepotNode;
24 struct StackDepotHandle {
25   StackDepotNode *node_ = nullptr;
26   u32 id_ = 0;
StackDepotHandleStackDepotHandle27   StackDepotHandle(StackDepotNode *node, u32 id) : node_(node), id_(id) {}
validStackDepotHandle28   bool valid() const { return node_; }
idStackDepotHandle29   u32 id() const { return id_; }
30   int use_count() const;
31   void inc_use_count_unsafe();
32 };
33 
34 const int kStackDepotMaxUseCount = 1U << (SANITIZER_ANDROID ? 16 : 20);
35 
36 StackDepotStats StackDepotGetStats();
37 u32 StackDepotPut(StackTrace stack);
38 StackDepotHandle StackDepotPut_WithHandle(StackTrace stack);
39 // Retrieves a stored stack trace by the id.
40 StackTrace StackDepotGet(u32 id);
41 
42 void StackDepotLockBeforeFork();
43 void StackDepotUnlockAfterFork(bool fork_child);
44 void StackDepotPrintAll();
45 void StackDepotStopBackgroundThread();
46 
47 void StackDepotTestOnlyUnmap();
48 
49 } // namespace __sanitizer
50 
51 #endif // SANITIZER_STACKDEPOT_H
52