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

