git-svn-id: https://192.168.0.254/svn/Proyectos.Noviseda_FactuGES2/trunk@5 f33bb606-9f5c-448d-9c99-757f00063c96

Tools/FBHook/FAQ.txt

@@ -0,0 +1,63 @@
+FBHook Beta 1
+by Simon Carter (simon.carter@tectsoft.com)
+
+
+FAQ
+===
+
+Q.  What is FBHook?
+
+A.  FBHook is a firebird client hook, which can display every sql statement sent to a server, on an application by application basis or system wide.
+
+Q.  How does it work?
+
+A.  FBHook is a DLL that sits between the application and fbclient.dll or gds32.dll, the application(s) loads the FBHook dll which then creates a chain to the original fbclient.dll.
+
+Q.  Do I have to recompile my existing firebird client application to use FBHook?
+
+A.  No.
+
+Q.  Can i use this at a client site to see what statements are being sent?
+
+A.  Yes, FBHook uses TCP to transport the data to the server for inline interpretation as SQL statements are executed.
+
+Q.  Is FBHook open source/freeware?
+
+A.  Yes, it is distributed under the IDPL license.
+
+Q.  How can I install FBHook for an individual application?
+
+A.  Rename the existing applications fbclient.dll to fbclient.original.dll, and then copy FBHooks fbclient.dll to the application folder.  If your app requires gds32.dll instead of fbclient, then rename fbclient.dll to gds32.dll.
+
+Q.  How can I specify a different host ip address so that I can debug a client on a remote pc?
+
+A.  in the same folder as fbclient.dll, create an ini file called fbhook.ini, add the following details:
+
+
+[Default]
+Host=10.0.0.9
+
+Q.  How can I specify a different port?
+
+A.  in the same folder as fbclient.dll, create an ini file called fbhook.ini, add the following details:
+
+[Default]
+Port=23456
+
+Q.  I am on a flaky network, and the client keeps getting disconnected, can I specify not to use TCP?
+
+A.  Yes, in the same folder as fbclient.dll, create an ini file called fbhook.ini, add the following details:
+
+[Default]
+UseTCP=0
+
+n.b.  a value of 1 (one) enables this feature.
+
+Q.  Where can i get support for FBHook?
+
+A.  Please check support options at (http://sourceforge.net/projects/fbutils).
+
+Q.  I get an error "The specified module could not be found" what does this mean?
+
+A.  You need to copy the original fbclient.dll and rename it to fbclient.original.dll
+

Tools/Midas/midas.bat

@@ -0,0 +1,2 @@
+copy midas.dll %windir%\system32
+regsvr32 %windir%\system32\midas.dll 

Tools/UIBSQL Monitor/readme.txt

@@ -0,0 +1,41 @@
+-------------------------------------UIB SQL MONITOR-----------------------------------
+
+This tool show in real time queries used by an application connected to Interbase or Firebird.
+It is also possible to view and sort query's performances. 
+This SQL monitor usually don't need you modify your application if it use an Interbase or Firebird 
+library (gds32.dll, fbclient.dll or fbembed.dll).
+It also works with dot.net applications.
+
+-- Knows issues --
+
+Sometimes nothing appear in the scroll box
+
+   1. Have you selected the righ library ?.
+   2. Hooked program can't find "madCHook.dll", in this case copy this DLL in system32 directory.
+   3. You need administrator rights.
+
+-- "Firebird .Net Data Provider" compatibility --
+
+You have to change connection string like this:
+
+FbConnectionStringBuilder *cs = new FbConnectionStringBuilder();
+cs->DataSource = "localhost";
+cs->Database = "C:\\Program Files\\Firebird\\Firebird_2_0\\examples\\empbuild\\EMPLOYEE.FDB";
+cs->UserID = "SYSDBA";
+cs->Password = "masterkey";
+cs->Dialect = 3;
+cs->ServerType = 1; // <<<<< here
+
+In this case your application will use "fbembed.dll", so just copy "fbclient.dll" 
+in the hooked application directory and rename it.
+
+-- Used tools --
+
+MadCodeHook: http://www.madshi.net
+VirtualTreeView: http://www.delphi-gems.com/VirtualTreeview
+SynEdit: http://synedit.sourceforge.net
+UIB: http://www.progdigy.com
+
+
+Henri Gourvest
+http://www.progdigy.com