├── README.md
├── bios
├── COPYING.LESSER
└── seabios.bin
├── build
├── LICENSE
├── libv86.js
└── v86.wasm
├── images
├── gdb-avr-10.1-bzImage.bin
├── gdb-multiarch-10.1-bzImage.bin
├── gdb-multiarch-10.1-python-bzImage-licenses.tar.gz
├── gdb-multiarch-10.1-python-bzImage.bin
├── gdb-multiarch-10.2-bzImage.bin
├── gdb-multiarch-11.2-bzImage.bin
└── licenses.tar.gz
├── index.html
└── src
├── main.js
├── style.css
└── worker.js
/README.md:
--------------------------------------------------------------------------------
1 | # Web GDB
2 |
3 | GDB (multiarch) running in a web-browser!
4 |
5 | > [Learn how to use Web GDB on Wokwi.com](https://docs.wokwi.com/gdb-debugging)
6 |
7 | ## How can I use it?
8 |
9 | To use Web GDB on Wokwi, open any project (e.g. this [Simon game](https://wokwi.com/arduino/libraries/demo/simon-game)),
10 | click on the code editor, and press F1. In the prompt that opens, type "GDB":
11 |
12 | 
13 |
14 | Choose the "debug build" option (the release build is harder to debug, but it's useful if your program uses the FastLED library).
15 | Web GDB will load in a new browser tab (you have to be a bit patient), and you should get the familiar GDB prompt:
16 |
17 | ```
18 | 0x00000000 in __vectors ()
19 | (gdb)
20 | ```
21 |
22 | At this point, you can write `continue` to start the program, or better - check out the
23 | [Arduino/AVR GDB Cheatsheet](https://blog.wokwi.com/gdb-avr-arduino-cheatsheet/) to see all the things GDB can do for you!
24 |
25 | A live version of Web GDB is [hosted on GitHub pages](https://wokwi.github.io/web-gdb/).
26 |
27 | ## How does it work?
28 |
29 | Great question, you'll find the answer in my [Running GDB in the Browser](https://blog.wokwi.com/running-gdb-in-the-browser) blog post.
30 |
--------------------------------------------------------------------------------
/bios/COPYING.LESSER:
--------------------------------------------------------------------------------
1 | GNU LESSER GENERAL PUBLIC LICENSE
2 | Version 3, 29 June 2007
3 |
4 | Copyright (C) 2007 Free Software Foundation, Inc.
5 | Everyone is permitted to copy and distribute verbatim copies
6 | of this license document, but changing it is not allowed.
7 |
8 |
9 | This version of the GNU Lesser General Public License incorporates
10 | the terms and conditions of version 3 of the GNU General Public
11 | License, supplemented by the additional permissions listed below.
12 |
13 | 0. Additional Definitions.
14 |
15 | As used herein, "this License" refers to version 3 of the GNU Lesser
16 | General Public License, and the "GNU GPL" refers to version 3 of the GNU
17 | General Public License.
18 |
19 | "The Library" refers to a covered work governed by this License,
20 | other than an Application or a Combined Work as defined below.
21 |
22 | An "Application" is any work that makes use of an interface provided
23 | by the Library, but which is not otherwise based on the Library.
24 | Defining a subclass of a class defined by the Library is deemed a mode
25 | of using an interface provided by the Library.
26 |
27 | A "Combined Work" is a work produced by combining or linking an
28 | Application with the Library. The particular version of the Library
29 | with which the Combined Work was made is also called the "Linked
30 | Version".
31 |
32 | The "Minimal Corresponding Source" for a Combined Work means the
33 | Corresponding Source for the Combined Work, excluding any source code
34 | for portions of the Combined Work that, considered in isolation, are
35 | based on the Application, and not on the Linked Version.
36 |
37 | The "Corresponding Application Code" for a Combined Work means the
38 | object code and/or source code for the Application, including any data
39 | and utility programs needed for reproducing the Combined Work from the
40 | Application, but excluding the System Libraries of the Combined Work.
41 |
42 | 1. Exception to Section 3 of the GNU GPL.
43 |
44 | You may convey a covered work under sections 3 and 4 of this License
45 | without being bound by section 3 of the GNU GPL.
46 |
47 | 2. Conveying Modified Versions.
48 |
49 | If you modify a copy of the Library, and, in your modifications, a
50 | facility refers to a function or data to be supplied by an Application
51 | that uses the facility (other than as an argument passed when the
52 | facility is invoked), then you may convey a copy of the modified
53 | version:
54 |
55 | a) under this License, provided that you make a good faith effort to
56 | ensure that, in the event an Application does not supply the
57 | function or data, the facility still operates, and performs
58 | whatever part of its purpose remains meaningful, or
59 |
60 | b) under the GNU GPL, with none of the additional permissions of
61 | this License applicable to that copy.
62 |
63 | 3. Object Code Incorporating Material from Library Header Files.
64 |
65 | The object code form of an Application may incorporate material from
66 | a header file that is part of the Library. You may convey such object
67 | code under terms of your choice, provided that, if the incorporated
68 | material is not limited to numerical parameters, data structure
69 | layouts and accessors, or small macros, inline functions and templates
70 | (ten or fewer lines in length), you do both of the following:
71 |
72 | a) Give prominent notice with each copy of the object code that the
73 | Library is used in it and that the Library and its use are
74 | covered by this License.
75 |
76 | b) Accompany the object code with a copy of the GNU GPL and this license
77 | document.
78 |
79 | 4. Combined Works.
80 |
81 | You may convey a Combined Work under terms of your choice that,
82 | taken together, effectively do not restrict modification of the
83 | portions of the Library contained in the Combined Work and reverse
84 | engineering for debugging such modifications, if you also do each of
85 | the following:
86 |
87 | a) Give prominent notice with each copy of the Combined Work that
88 | the Library is used in it and that the Library and its use are
89 | covered by this License.
90 |
91 | b) Accompany the Combined Work with a copy of the GNU GPL and this license
92 | document.
93 |
94 | c) For a Combined Work that displays copyright notices during
95 | execution, include the copyright notice for the Library among
96 | these notices, as well as a reference directing the user to the
97 | copies of the GNU GPL and this license document.
98 |
99 | d) Do one of the following:
100 |
101 | 0) Convey the Minimal Corresponding Source under the terms of this
102 | License, and the Corresponding Application Code in a form
103 | suitable for, and under terms that permit, the user to
104 | recombine or relink the Application with a modified version of
105 | the Linked Version to produce a modified Combined Work, in the
106 | manner specified by section 6 of the GNU GPL for conveying
107 | Corresponding Source.
108 |
109 | 1) Use a suitable shared library mechanism for linking with the
110 | Library. A suitable mechanism is one that (a) uses at run time
111 | a copy of the Library already present on the user's computer
112 | system, and (b) will operate properly with a modified version
113 | of the Library that is interface-compatible with the Linked
114 | Version.
115 |
116 | e) Provide Installation Information, but only if you would otherwise
117 | be required to provide such information under section 6 of the
118 | GNU GPL, and only to the extent that such information is
119 | necessary to install and execute a modified version of the
120 | Combined Work produced by recombining or relinking the
121 | Application with a modified version of the Linked Version. (If
122 | you use option 4d0, the Installation Information must accompany
123 | the Minimal Corresponding Source and Corresponding Application
124 | Code. If you use option 4d1, you must provide the Installation
125 | Information in the manner specified by section 6 of the GNU GPL
126 | for conveying Corresponding Source.)
127 |
128 | 5. Combined Libraries.
129 |
130 | You may place library facilities that are a work based on the
131 | Library side by side in a single library together with other library
132 | facilities that are not Applications and are not covered by this
133 | License, and convey such a combined library under terms of your
134 | choice, if you do both of the following:
135 |
136 | a) Accompany the combined library with a copy of the same work based
137 | on the Library, uncombined with any other library facilities,
138 | conveyed under the terms of this License.
139 |
140 | b) Give prominent notice with the combined library that part of it
141 | is a work based on the Library, and explaining where to find the
142 | accompanying uncombined form of the same work.
143 |
144 | 6. Revised Versions of the GNU Lesser General Public License.
145 |
146 | The Free Software Foundation may publish revised and/or new versions
147 | of the GNU Lesser General Public License from time to time. Such new
148 | versions will be similar in spirit to the present version, but may
149 | differ in detail to address new problems or concerns.
150 |
151 | Each version is given a distinguishing version number. If the
152 | Library as you received it specifies that a certain numbered version
153 | of the GNU Lesser General Public License "or any later version"
154 | applies to it, you have the option of following the terms and
155 | conditions either of that published version or of any later version
156 | published by the Free Software Foundation. If the Library as you
157 | received it does not specify a version number of the GNU Lesser
158 | General Public License, you may choose any version of the GNU Lesser
159 | General Public License ever published by the Free Software Foundation.
160 |
161 | If the Library as you received it specifies that a proxy can decide
162 | whether future versions of the GNU Lesser General Public License shall
163 | apply, that proxy's public statement of acceptance of any version is
164 | permanent authorization for you to choose that version for the
165 | Library.
166 |
--------------------------------------------------------------------------------
/bios/seabios.bin:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wokwi/web-gdb/c7c9416890b2088412c86698d32652de5c0aa544/bios/seabios.bin
--------------------------------------------------------------------------------
/build/LICENSE:
--------------------------------------------------------------------------------
1 | Copyright (c) 2012, The v86 contributors
2 | All rights reserved.
3 |
4 | Redistribution and use in source and binary forms, with or without
5 | modification, are permitted provided that the following conditions are met:
6 |
7 | 1. Redistributions of source code must retain the above copyright notice, this
8 | list of conditions and the following disclaimer.
9 | 2. Redistributions in binary form must reproduce the above copyright notice,
10 | this list of conditions and the following disclaimer in the documentation
11 | and/or other materials provided with the distribution.
12 |
13 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
14 | ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
15 | WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
16 | DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
17 | ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
18 | (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
19 | LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
20 | ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
21 | (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
22 | SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
23 |
--------------------------------------------------------------------------------
/build/v86.wasm:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wokwi/web-gdb/c7c9416890b2088412c86698d32652de5c0aa544/build/v86.wasm
--------------------------------------------------------------------------------
/images/gdb-avr-10.1-bzImage.bin:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wokwi/web-gdb/c7c9416890b2088412c86698d32652de5c0aa544/images/gdb-avr-10.1-bzImage.bin
--------------------------------------------------------------------------------
/images/gdb-multiarch-10.1-bzImage.bin:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wokwi/web-gdb/c7c9416890b2088412c86698d32652de5c0aa544/images/gdb-multiarch-10.1-bzImage.bin
--------------------------------------------------------------------------------
/images/gdb-multiarch-10.1-python-bzImage-licenses.tar.gz:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wokwi/web-gdb/c7c9416890b2088412c86698d32652de5c0aa544/images/gdb-multiarch-10.1-python-bzImage-licenses.tar.gz
--------------------------------------------------------------------------------
/images/gdb-multiarch-10.1-python-bzImage.bin:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wokwi/web-gdb/c7c9416890b2088412c86698d32652de5c0aa544/images/gdb-multiarch-10.1-python-bzImage.bin
--------------------------------------------------------------------------------
/images/gdb-multiarch-10.2-bzImage.bin:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wokwi/web-gdb/c7c9416890b2088412c86698d32652de5c0aa544/images/gdb-multiarch-10.2-bzImage.bin
--------------------------------------------------------------------------------
/images/gdb-multiarch-11.2-bzImage.bin:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wokwi/web-gdb/c7c9416890b2088412c86698d32652de5c0aa544/images/gdb-multiarch-11.2-bzImage.bin
--------------------------------------------------------------------------------
/images/licenses.tar.gz:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wokwi/web-gdb/c7c9416890b2088412c86698d32652de5c0aa544/images/licenses.tar.gz
--------------------------------------------------------------------------------
/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |