This document lists the steps needed to run DOC and interpret a sample
program. It is intended to be a quick guide requiring as little reading
as possible. It is assumed you have already downloaded the DOC
project and loaded it into Eclipse.
- Set up Java version.
- Install an appropriate Java version. DOC requires Java version 1.5 (5.0) or later.
- Ensure Eclipse is aware of your Java installation by going to
Windows->Preferences... ,
then Java->Installed JREs , and adding it to the list if it is absent.
- Set the compliance level by selecting
Windows->Preferences... , then
Compiler . Set Compiler compliance level to 5.0 or greater.
- Check out the DOC project from CVS.
- Select
File->New->Project... .
- Select
Projects from CVS .
Click Next .
- For
Host , enter obfuscation.cvs.sourceforge.net .
- For
Repository path , enter /cvsroot/obfuscation .
- For
User , enter anonymous .
- For
Connection type , select pserver .
- Click
Next .
- For
Use specified module name , enter DetectObfuscation . Click Finish .
- Add
org.eclipse.ui.ide to the build path.
- Select
File->Import... .
- Select
Plug-in Development->Plugins and Fragments . Click Next .
- Click
Next again.
- Select
org.eclipse.ui.ide from the list. Click Add--> .
- Click
Finish .
- Add the GEF library to the project.
- Download GEF runtime from http://www.eclipse.org/gef.
- Extract the GEF runtime to the folder containing the Eclipse folder.
For example, if Eclipse is installed at
C:\Eclipse , then
extract the folder to C:\ .
- Restart Eclipse.
- Right-click the project name (
DetectObfuscation ) in Package Explorer .
-
- Launch DOC.
- Right-click the DOC project in the Eclipse Package Explorer.
- Select
Run As->Eclipse Application .
- From the Window menu, choose Open
Perspective->Other... .
- Select
Obfuscation Detection . Press OK .
- Set DLL Stubs path.
- Once DOC is running (a second Eclipse windows opens), open the Window menu.
- Choose
Preferences... .
- Select DOC from the list on the left.
- For the option
Stub DLLs Path , enter
DOC_WORKSPACE_FOLDER\Imports , where DOC_WORKSPACE_FOLDER is the
path to the DOC workspace (ex. c:\workspace\edu.louisiana.cacs.DetectObfuscation ).
- Click
OK .
- Open a sample file.
- From the File menu, choose
New->Project... .
- Select
Obfuscation Detection project wizard . Click Next .
- Enter
Sample1 as the project name.
- For
Select asm file , enter
DOC_WORKSPACE_FOLDER\Samples\sample1.asm . Click Finish .
- Launch the interpreter.
- From the list on the left, double-click
sample1.asm to open it.
- Launch the interpreter by opening the Interpreter menu and selecting
VSA-ASG Obfuscation Analysis .
Once interpretation is complete, you should be able to view the state at each instruction
by selecting the instruction.
For a more detailed introduction to DOC, see the Usage page.
|