summaryrefslogtreecommitdiffstats
path: root/libbacktrace/BacktraceThread.h
blob: 8ed112265e923536df43e1129d75b9300d0b0680 (plain)
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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
/*
 * Copyright (C) 2013 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef _LIBBACKTRACE_BACKTRACE_THREAD_H
#define _LIBBACKTRACE_BACKTRACE_THREAD_H

#include <inttypes.h>
#include <pthread.h>
#include <sys/types.h>

#include "Backtrace.h"

typedef enum {
  STATE_WAITING = 0,
  STATE_DUMPING,
  STATE_DONE,
  STATE_CANCEL,
} state_e;

class BacktraceThreadInterface;

struct ThreadEntry {
  ThreadEntry(
      BacktraceThreadInterface* impl, pid_t pid, pid_t tid,
      size_t num_ignore_frames);
  ~ThreadEntry();

  bool Match(pid_t chk_pid, pid_t chk_tid) { return (chk_pid == pid && chk_tid == tid); }

  static ThreadEntry* AddThreadToUnwind(
      BacktraceThreadInterface* thread_intf, pid_t pid, pid_t tid,
      size_t num_ignored_frames);

  BacktraceThreadInterface* thread_intf;
  pid_t pid;
  pid_t tid;
  ThreadEntry* next;
  ThreadEntry* prev;
  int32_t state;
  int num_ignore_frames;
};

// Interface class that does not contain any local storage, only defines
// virtual functions to be defined by subclasses.
class BacktraceThreadInterface {
public:
  virtual ~BacktraceThreadInterface() { }

  virtual bool Init() = 0;

  virtual void ThreadUnwind(
      siginfo_t* siginfo, void* sigcontext, size_t num_ignore_frames) = 0;
};

class BacktraceThread : public BacktraceCurrent {
public:
  // impl and thread_intf should point to the same object, this allows
  // the compiler to catch if an implementation does not properly
  // subclass both.
  BacktraceThread(
      BacktraceImpl* impl, BacktraceThreadInterface* thread_intf, pid_t tid);
  virtual ~BacktraceThread();

  virtual bool Unwind(size_t num_ignore_frames);

  virtual void ThreadUnwind(
      siginfo_t* siginfo, void* sigcontext, size_t num_ignore_frames) {
    thread_intf_->ThreadUnwind(siginfo, sigcontext, num_ignore_frames);
  }

private:
  virtual bool TriggerUnwindOnThread(ThreadEntry* entry);

  virtual void FinishUnwind();

  BacktraceThreadInterface* thread_intf_;
};

#endif // _LIBBACKTRACE_BACKTRACE_THREAD_H