blob: 85065fe32dbfb428c4b915da29c74c7d75a948da (
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
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
|
# Servo debugging guide
There are a few ways to debug Servo. `mach` supports a `--debug` flag that
searches a suitable debugger for you and runs servo with the appropriate
arguments under it:
```
./mach run --debug test.html
```
You can also specify an alternative debugger using the `--debugger` flag:
```
./mach run --debugger=my-debugger test.html
```
You can also, of course, run directly your debugger on the Servo binary:
```
$ gdb --args ./target/debug/servo test.html
```
## Debugging SpiderMonkey.
You can build Servo with a debug version of SpiderMonkey passing the
`--debug-mozjs` flag to `./mach build`.
Note that this sometimes can cause problems when an existing build exists, so
you might have to delete the `mozjs` build directory, or run `./mach clean`
before your first `--debug-mozjs` build.
## Debugging Servo with [rr][rr].
To record a trace under rr you can either use:
```
$ ./mach run --debugger=rr testcase.html
```
Or:
```
$ rr record ./target/debug/servo testcase.html
```
### Running WPT tests under rr's chaos mode.
Matt added a mode to Servo's testing commands to record traces of Servo running
a test or set of tests until the result is unexpected.
To use this, you can pass the `--chaos` argument to `mach test-wpt`:
```
$ ./mach test-wpt --chaos path/to/test
```
Note that for this to work you need to have `rr` in your `PATH`.
Also, note that this might generate a lot of traces, so you might want to delete
them when you're done. They're under `$HOME/.local/share/rr`.
### Known gotchas
If you use a Haswell processor that supports Hardware Lock Ellision, rr might
not work for you. There's a `rr` [bug][rr-bug] open about this. Until that gets
fixed, you can ensure that the `parking_lot` dependency isn't built with the
`nightly` feature, which as of this writing is the only dependency that uses it.
[rr]: http://rr-project.org/
[rr-bug]: https://github.com/mozilla/rr/issues/1883
|
