gdb-frontend-live: online ide/debugger platform based on gdb-frontend 🛸👽🌌
GDBFrontendLive is a server that creates GDBFrontend instances and provides an online sharable IDEs for each individiual users.
+----------------+ +------------------------+
| +--------> |
| Client | | GDBFrontendLive |
| (Browser) | | Server |
| <--------+ |
+--^--+----------+ | +-----Instances------+ |
| | | | | |
| | | | +----------------+ | |
| | | | | | | |
| +-----------------------> | | |
| | | | GDBFrontend | | |
+--------------------------+ | | |
| | | | | |
| | +----------------+ | |
| | ... | |
| +--------------------+ |
+------------------------+
GFLive provides a platform that creates online shareble IDE/debuggers for each individual user. Once you create an IDE instance, you can share your session and debug together.
This project may useful for especially educational institutions or teams; they can setup their own GFLive platforms and provide online shareble IDEs. Also, of course it may be useful for individual usages; you can create a lot of debugger instances and use and share them to your friends.
GDBFrontend is a debugger in fact for now but it provides basic editing features and full access to terminal on a tmux session. So you can use even Vim in the terminal or do something else. With debugging features, editing/IDE features will be improved in-time. You can contribute to project, all PRs are welcome.
Note: Still both projects GFlive and GF are very new and on alpha stages.
You can use GFLive with Docker easily.
Install Docker, and follow these simple steps:
Get the latest GIT revision:
git clone --recursive https://github.com/rohanrhu/gdb-frontend-live.git
cd gdb-frontend-liveRun GFLive container easily:
docker build --tag gflive .
docker run --name gflive -p 80:80 gfliveNow you can use GFLive on the URL: http://127.0.0.1/
To stop your container you can use Docker Desktop or use command line of Docker:
docker container stop gfliveTo remove the container and Docker image you can do these:
docker container rm gflivedocker image rm gfliveIf you are using Docker you can ignore full-system access issue for security since everything will work in VMs but if you want to restrict outgoing internet traffic
for GFLive's debugger instances, you still need to restrict internet access; you can do that by using iptables for the user that is running Docker if you are using Linux.
GFLive provides full access on instance user and group that are set by --instance-user/--instance-group, so the IDE instances can access each other and internet! Also you must be careful for your open ports or DMZ option on your router; if you dont use a router, you must use firewall or setup a complex autharization architecture based on users and ports.
You can use iptables to restrict outgoing internet traffic of GFLive's debugger instances.
sudo iptables -A OUTPUT -m owner --uid-owner $(id -u gflive) -j DROPGDBFrontend: gdb-frontend
GDBFrontend to create instances.
Adapter: gdb-frontend-live-adapter
GDBFrontend adapter plugin for adopting instance to GDBFrontendLive.
Client: gdb-frontend-live-client
Frontend client that connects to GDBFrontendLive server.
You can build it with GNU Make.
make clean; makeGFLive does not require anything except GDBFrontend Requirements. You must provide requirements for GDBFrontend.
# ./server -h
GDBFrontendLive v0.0.1-alpha
Usage: gdbfrontendlive [options]
Options:
--help, -h: Shows this help text.
--version, -v: Shows GDBFrontendLive and GDBFrontend versions.
--host-address=IP, -H IP: Specifies bind address.
--bind-address=IP, -l IP: Specifies host address. (Default is 127.0.0.1)
--ws-port=PORT, -wsp PORT: Specifies GDBFrontend websocket server's port.
--instance-user=USER, -u USER: Sets the user that runs instances.
--instance-group=GROUP, -g GROUP: Sets the group that runs instances.
Start server with an instance user:
./server --instance-user=USERNAME- You must run the server as root because it sets uids and gids of instance processes.
- CWD must be the directory of server executable.
GFLive provides a WebSocket server to clients. The server uses serialized JSONs for messaging. HTTP server for client is a TODO; you can use gdb-frontend-live-client on file:// (without a http server) or serve it a simple http server like Apache HTTPD.
No. You can use it on Linux.
GDBFrontend supports WSL but GFLive does not.
- GFLive needs random ports and on WSL 1, Random port option is not usable on WSL becasue
/proc/net/tcpinterface is not working on WSL. (WSL 2 does not has this problem.)
Since v0.1.0-git, GFLive switched to a new versioning strategy.
In vX.Y.Z-STABILITY:
Xis major versions, changes long term with major features and enhancements.Yis main versions that include new features and enhancements.Zis bugfix releases of main versions.STABILITYis stability level of the release. (alpha,beta,rcN,stable)
Documentation is TODO yet.
All PRs are welcome.
You can donate for supporting me :)
| QR Code | Bitcoin address for donations |
|---|---|
 |
bc1qhvlc762kwuzeawedl9a8z0duhs8449nwwc35e2 |
Other currencies:
| Currency | Address |
|---|---|
| BTC | bc1qhvlc762kwuzeawedl9a8z0duhs8449nwwc35e2 |
| ETH | 0x1D99B2a2D85C34d478dD8519792e82B18f861974 |
| USDT | 0x1D99B2a2D85C34d478dD8519792e82B18f861974 |
| USDC | 0x1D99B2a2D85C34d478dD8519792e82B18f861974 |
| XMR | 88qvS4sfUnLZ7nehFrz3PG1pWovvEgprcUhkmVLaiL8PVAFgfHjspjKPLhWLj3DUcm92rwNQENbJ1ZbvESdukWvh3epBUty |
GNU General Public License v3 (GPL-3)
You may copy, distribute and modify the software as long as you track changes/dates in source files. Any modifications to or software including (via compiler) GPL-licensed code must also be made available under the GPL along with build & install instructions.
