Sadnata04Tools Eclipse Plugin Version 1.0.0 //////////////////////////////////////////////////// Thank you for downloading our plugin. 1. Installing the plugin ======================== Simply unzip the file into your $ECLIPSE_HOME/plugins directory. After you do so, simply restart your workbench. The new plugin will become available. 2. Using the plugin =================== eFence: ------- First make sure that you have downloaded and installed eFence first. After you have installed it, make sure that your system knows where it is and that you can compile with gcc using it (i.e. it's in your path of linking directories). "Compiling & Running" a single file: If you wish to compile a single file follow these steps. 1. Get (or create) your .c file into the eclipse workspace. 2. Right click on the file and click "properties". 3. Get to the "eFence Property Page" option. 4. Edit the eFence flags. 5. After you've finished editing the runtime flags, simply right click on the file, go to "eFence..." -> "Compile & Run". 6. Debug information is sent to the debug console. "Compiling & Running" a project: If you wish to compile and run a whole project follow these steps. 1. Create a project in the workspace. 2. Get your files in the workspace. 3. To edit the runtime flags, right click on the project in the workspace, then click "properties" and go to the "eFence Property Page". 4. Edit your flags. 5. To run, simply click on the ADD HOW TO RUN HERE. KcacheGrind: ------------ 1. After the plug-in was installed you should choose the project property. There you'll see the Kcachegrind property page. 2. In this page you should insert the full path of the Valgrind and the Kcachegrind software, and also the full path of your project executable. 3. You can also insert the relevant data to the options of the Calltree and you can also add some more options to the Calltree. 4. After filling the property page you should enter the project menu and click on the Memory Tools sub menu. In this sub menu press on the Run Kcachegrind option. 5. The Kcachegrind shall open with the profiling data of your project. Q&A === Troubleshooting --------------- Q: I've right-clicked on a file and chose "properties", but I can see no eFence properties page. A: Check the file type. eFence only "popups" when it's a .c file. If the problem persists, check your installation. If you have unzipped your files properly make sure you've restarted the workbench. Other software issues (Bugs, further development etc.) ------------------------------------------------------- Q: I've found a bug, where do I report? A: Just send us an e-mail with subject "eFence bug" and say what you have to say there. Our e-mail address is given at the bottom of this document. Q: I would like to contribute/takeover your project, what should I do? A: Read the documentation of the plugin for a thorough introduction to the structure of the plugin. Afterwards, just send us an e-mail. Cheers, The sadnata04 team, e-mail: sadnata04[at]yahoo[dot]com website: http://www.geocities.com/sadnata04