The main purpose of the GUI application is to simplify the use of the Peach fuzzing framework backend.

It does not provide any extra fuzzing related functions and all its functionality can be achieved by using the standard console Peach application. Moreover the GUI application does not cover every fuzzing configuration, which can be set using the Peach fuzzing framework. It just covers a reasonable subset of its functionality related to the HotFuzz project. GUI is distributed under the same license as the Peach fuzzing framework, so feel free to extend and modify its features.

Used tools

GUI is completely written in python. There are no platform dependent imports in the source code. It uses the PyQt4 library, which provides bindings for the Nokia's Qt application framework. This makes the GUI application very portable, because the python interpreter and PyQt4 are ported to the vast majority of nowadays operating systems.

To create the code more effectively, we decided to use the Qt Designer to design a skeleton of dialogs. (Qt designer plugin)

Source code generation

The Qt Designer does not directly generate python source files. It generates ui files (These files use an XML format to represent form elements and their characteristics.). Luckily PyQt4 provides us with pyuic4 utility, which is capable of converting the ui files to the python source files. There is also one resource file (GUI/images/resource.qrc) containing informations about used images, which that has to be compiled using the pyrcc4 utility.

To automate these actions use the python script file GUI/ or use the make command inside GUI/ directory.

Main functions overview

Providing a dialog logic (Dialogs)
Starting fuzzing and recording external processes (Main window dialog, External programs)
Manipulating with fuzzing and recording XMLs (Main window dialog, XML manipulation)
Viewing crashes (Main window dialog, Action view dialog, Dump files)
Keeping application settings (Application settings, Main window dialog)
The project management (Projects Project Files, Intro dialog)
Providing undo/redo actions (Undo Actions, Main window dialog)

Application file overview

GUI/ - Classes used for the communication with Peach
GUI/ - Classes used for the XML processing (loading and storing)
GUI/ - A logic of the Action View dialog
GUI/ - Classes used to process the crash informations
GUI/ - Global definitions
GUI/ - Plugins for Qt designer
GUI/ - Specially modified widgets (for Qt designer and main window)
GUI/ - A logic of the Intro Dialog
GUI/ - A class, which links the mutator widget with the element of the XML tree
GUI/ - A logic of the Preferences Dialog
GUI/ - A project class
GUI/ - A logic of the Project Info Dialog
GUI/ - A logic of the Project New Dialog
GUI/ - A logic of the Project Recent Dialog
GUI/ - Application settings
GUI/ - A file containing shared non-class functions
GUI/ - A class for testing whether the given port on the given host is accessible
GUI/ - Classes for performing GUI undo actions
GUI/ - A logic of the Main Window Dialog
GUI/schema/project.xsd - A schema for verification of project XML files
GUI/images/ - A directory for images
GUI/templates/ - A directory with templates for fuzzing and recording phases and a default project XML
GUI/ui/ - A directory containing ui files created in the Qt Designer

Generated on Sun Sep 5 12:41:36 2010 for HotFuzz by  doxygen 1.5.8