1JavaScript bindings for Cinnamon
2================================
3
4Based on GJS: https://wiki.gnome.org/action/show/Projects/Gjs
5
6Please do the following when reporting CJS crashes:
7===================================================
8
9If possible, provide a stack trace.
10
11Run dmesg and provide the line related to the crash, for instance:
12
13`[ 4947.459104] cinnamon[2868]: segfault at 7f2611ffffe8 ip **00007f2667dda305** sp 00007fffb416b9d0 error 4 in libcjs.so.0.0.0[**7f2667db1000**+c1000]`
14
15Launch the Calculator, choose Advanced Mode and set it to Hexadecimal. Then substract the loading address (first address in brackets: 7f2667db1000) from the ip (00007f2667dda305).
16
17In the example above:
18
19ip: 00007f2667dda305
20loading address: 7f2667db1000
21
22`00007f2667dda305 - 7f2667db1000 = 29305`
23
24This gives us the offset. Use addr2line to see what's under it in our shared library:
25
26```
27addr2line -e /usr/lib/libcjs.so.0.0.0 29305 -fCi
28gjs_typecheck_boxed
29```
30
31When reporting the bug, along with the trace and the dmesg line, please report that function name (in this example gjs_typecheck_boxed).
32