Skip to content

muflone/gptrace

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
.tx
 
 
 
 
doc
 
 
 
 
 
 
man
 
 
po
 
 
ui
 
 
 
 
 
 
 
 
 
 
 
 
 
 

gpTrace

Travis CI Build Status CircleCI Build Status

Description: Trace the activities of an external application

Copyright: 2014-2022 Fabio Castelli (Muflone) muflone@muflone.com

License: GPL-3+

Source code: https://github.com/muflone/gptrace/

Documentation: http://www.muflone.com/gptrace/

Translations: https://explore.transifex.com/muflone/gptrace/

Description

gpTrace can be used as an application debugger to discover what activities an application does, which files accesses (or tries to use in the case they miss), how many external processes are called and what arguments those processes were using.

From the gpTrace main window you choose an executable file, click the button Start and let the external program execute.

Activities tab

In the Activities tab you'll see the system calls were made and you can filter what to see or what you prefer to ignore to better undestand what the external program is doing.

Counts tab

In the Counts tab you'll see how many calls are made for each system call.

Files tab

In the Files tab you'll the files the external program used or tried to use. If you want to see only the existing files and ignore what files the process has not found you can configure in the upper righe options menu.

Files tab

In the Processes tab you'll the external processes were called from your application, along with their information and command line arguments.

Options menu

From the upper right button you can configure the program options. Some options are also available clicking the mouse right button on the results list.

Reliability

gpTrace uses a Python library called ptrace which, at the actual stage, results unstable and sometimes unreliable, therefore you are warned the called external program can fail, break, stop, hung or result unbearably slow.

In particular the opening and the closing processes are very delicate and sometimes a crash could happen when you start an application or when you close a running application.

If gpTrace hangs please kill the application using a process manager or the terminal command kill.

System Requirements

Installation

A distutils installation script is available to install from the sources.

To install in your system please use:

cd /path/to/folder
python setup.py install

To install the files in another path instead of the standard /usr prefix use:

cd /path/to/folder
python setup.py install --root NEW_PATH

Usage

If the application is not installed please use:

cd /path/to/folder
python gptrace.py

If the application was installed simply use the gptrace command.