Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
41 lines (32 sloc) 1.71 KB
title keywords summary sidebar permalink folder
penguinTrace
penguine, trace, debug, gdb
TpenguinTrace allows you to see the instructions that code compiles down to and see how they get executed in order to run a program.
mydoc_sidebar
cser_penguinTrace.html
cser

Introduction

penguinTrace allows you to see the instructions that code compiles down to and see how they get executed in order to run a program. penguinTrace starts a web-server, and then code can be entered into the web interface. After compiling the code (▶), the interface will show the source code on the left and the assembly on the right. The current line of code will be highlighted on both sides.

Install Docker

If you do not already have Docker installed, please follow the directions from the Docker website to install Docker on your personal computer.

Install penguinTrace

Once Docker has been installed, open a Terminal window on your computer, and run the following command:

docker build -t penguinTrace github.com/penguintrace/penguintrace

Running penguinTrace

With Docker and penguinTrace installed, open a terminal window and run the following command:

docker run -it -p 127.0.0.1:8080:8080 --tmpfs /tmp:exec --cap-add=SYS_PTRACE --cap-add=SYS_ADMIN --rm --security-opt apparmor=unconfined penguintrace penguintrace

Using penguinTrace

Once you have started penguinTrace, simply point your web browser to 127.0.0.1:8080

Managing penguinTrace

In the terminal window, you can use the following keys to control the running container

 Commands:
  q - Shutdown server
  l - List active sessions
  k - Kill all active sessions
You can’t perform that action at this time.