User manual

135
Appendix E: Architecture and the
Command Line
Under normal circumstances, PhoneSweep's internal structure should be transparent to the user. However,
in the event of complications, knowledge of the architecture may be helpful.
The program is started when the user double-clicks on the PhoneSweep engine executable. The
PhoneSweep engine then launches the embedded SQL server and the PhoneSweep user interface.
The PhoneSweep program consists of three parts:
• The PhoneSweep engine (phonesweep.exe), a Win32 executable written in C.
• The PhoneSweep embedded SQL database (dbm\bin\mysql.exe).
• The PhoneSweep user interface (gui\ps.exe), a Win32 executable written in C++ using the QT
user interface library.
All of these components communicate using local TCP/IP data streams. Our implementation requires that
the Windows Sockets API version 2 DLL be accessible, and that we can connect to ourselves using the
Unix-style IP loopback address, 127.0.0.1.
Running PhoneSweep from MS-DOS
PhoneSweep can be run from an MS-DOS prompt. There is usually no reason to do so, but sometimes it
can be useful when one is troubleshooting PhoneSweep. To run PhoneSweep this way, go to an MS-DOS
prompt window and change directories to the PhoneSweep directory; then type <phonesweep><ENTER>.
If you have installed PhoneSweep in the default directory, this will be
C:\Program Files\Sandstorm\PhoneSweep>phonesweep
PhoneSweep has a number of command line arguments that may be useful. They are listed in the chart
below. To run PhoneSweep with a command line argument, change directories to the PhoneSweep
directory, then type <phonesweep> <arg1> <arg2> etc. <ENTER>, where arg1, arg2 etc. are the
command line arguments you wish to invoke. For example, to run PhoneSweep in engine debugging
mode and without displaying the splash logo upon startup, type:
phonesweep –enginegui -nosplash
PhoneSweep Command Line Arguments
-help Lists the available command line arguments in a pop-up window; does not
start PhoneSweep
-initialize Erases all profiles currently stored on your system. Use this option with
caution. You can perform the same function by dragging all of the
directories beginning with “PS_” inside the Profiles directory into the trash.
Do not drag the Profiles directory itself into the trash, as this will cause
PhoneSweep to stop functioning.
-version Display the version of the PhoneSweep executable in a pop-up window.
-nogui Do not launch the GUI.
-enginegui Display the engine’s debugging GUI.