summaryrefslogtreecommitdiffstats
path: root/js/src/gdb/gdb-tests.h
blob: 7d32f8f949cb417932719af29454c356a7bd4310 (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
93
94
95
96
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 * vim: set ts=8 sts=2 et sw=2 tw=80:
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#ifndef gdb_gdb_tests_h
#define gdb_gdb_tests_h

// Support for C++ fragments to be used by Python unit tests for SpiderMonkey's
// GDB support.
//
// That is:
// - js/src/gdb/mozilla holds the actual GDB SpiderMonkey support code.
// - Each '.py' file in js/src/gdb/tests is a unit test for the above.
// - Each '.cpp' file in js/src/gdb/tests is C++ code for one of the unit tests
//   to run.
//
// (So the .cpp files are two steps removed from being anything one would
// actually run.)

#include "NamespaceImports.h"

#include "js/GCAnnotations.h"

void breakpoint();

extern void usePointer(const void* ptr);

template <typename T>
void use(const T& thing) {
  usePointer(&thing);
}

struct AutoSuppressHazardsForTest {
  int dummy;
  AutoSuppressHazardsForTest() : dummy(3) {}
  ~AutoSuppressHazardsForTest() {
    // Need nontrivial destructor.
    usePointer(&dummy);
  }
} JS_HAZ_GC_SUPPRESSED;

struct GDBFragment {
  GDBFragment() {
    next = allFragments;
    allFragments = this;
  }

  // The name of this fragment. gdb-tests.cpp runs the fragments whose names
  // are passed to it on the command line.
  virtual const char* name() = 0;

  // Run the fragment code. |argv| is a reference to the pointer into the
  // command-line argument vector, referring to the argument immediately
  // following this fragment's name. The fragment can consume arguments and
  // advance argv if it wishes.
  virtual void run(JSContext* cx, const char**& argv) = 0;

  // We declare one instance of this type for each fragment to run. The
  // constructor adds each instance to a linked list, of which this is
  // the head.
  static GDBFragment* allFragments;

  // The link in the list of all instances.
  GDBFragment* next;
};

// Macro for declaring a C++ fragment for some Python unit test to call. Usage:
//
//   FRAGMENT(<category>, <name>) { <body of fragment function> }
//
// where <category> and <name> are identifiers. The gdb-tests executable
// takes a series of fragment names as command-line arguments and runs them in
// turn; each fragment is named <category>.<name> on the command line.
//
// The body runs in a scope where 'cx' is a usable JSContext*.

#define FRAGMENT(category, subname)                                   \
  class FRAGMENT_CLASS_NAME(category, subname) : public GDBFragment { \
    void run(JSContext* cx, const char**& argv) override;             \
    const char* name() override {                                     \
      return FRAGMENT_STRING_NAME(category, subname);                 \
    }                                                                 \
    static FRAGMENT_CLASS_NAME(category, subname) singleton;          \
  };                                                                  \
  FRAGMENT_CLASS_NAME(category, subname)                              \
  FRAGMENT_CLASS_NAME(category, subname)::singleton;                  \
  void FRAGMENT_CLASS_NAME(category, subname)::run(JSContext* cx,     \
                                                   const char**& argv)

#define FRAGMENT_STRING_NAME(category, subname) (#category "." #subname)
#define FRAGMENT_CLASS_NAME(category, subname) Fragment_##category##_##subname

#endif /* gdb_gdb_tests_h */