home *** CD-ROM | disk | FTP | other *** search
/ Cracking 1 / Cracking I..iso / Tools / Debuggery / TRW2000 / PLUGSDK / README.TXT < prev   
Encoding:
Text File  |  2000-02-25  |  5.6 KB  |  196 lines
  1. -------------------------------------------------
  2. Introduce Plug-ins for TRW2000
  3. -------------------------------------------------
  4. Plug-ins is a extension part of TRW2000. It work with
  5. kernel of TRW2000 and other Plug-ins to provide more 
  6. function for user. Plug-ins is dynamic-link with kernel
  7. of TRW2000, this means that it's NOT a internal component,
  8. it can be instead.
  9.  
  10. Plug-ins is flexible, it can go to any target by easy
  11. design, for example, display driver is written as Plug
  12. -ins. In other words, you can develop special debugger
  13. but not need to develop driver, disassemble, assemble, 
  14. screen-interface... Cracker can get more help from this
  15. important property.
  16.  
  17. -------------------------------------------------
  18. Starting to develop your Plug-ins...
  19. -------------------------------------------------
  20. You must have some tools to develop Plug-ins. You need:
  21.  
  22. Visual C++( recommend 6.0 ) 
  23. Win98DDK. 
  24.  
  25. If you haven't it, never mind, download it freely from 
  26. http://www.microsoft.com/ddk
  27. Warning:
  28. YOU MUST MODIFY FILE I386MK.INC
  29. (locate at <98DDK Directory>\INC),
  30.     1.Search STDFLAGS= /c /Zel /Zp8 /Gy ..., 
  31.       modify /Zp8 to /Zp1.
  32.     2.{i386\}.asm{$(_OBJ_DIR)\i386\}.obj:
  33.         $(386_ASSEMBLER) -Fo$(MAKEDIR)\$@ $<
  34.       change it to:
  35.       .asm{$(_OBJ_DIR)\i386\}.obj:
  36.         $(386_ASSEMBLER) -Fo$(MAKEDIR)\$@ $<
  37.  
  38. Then, click icons "Check" or "Free" environment in Windows
  39. start menu, Ok, we can start! 
  40.  
  41. -------------------------------------------------
  42. Compile reference :
  43. -------------------------------------------------
  44. The extension name of Plug-ins is .SYS, it's a WDM driver
  45. in fact. 
  46.  
  47. Before you start, you must have other two files in the
  48. same directory as the source code located at that you will
  49. use:
  50. MAKEFILE and SOURCES ( no extension name ) .
  51.  
  52. MAKEFILE is following as below :
  53.  
  54. ###########################################################
  55. #
  56. # Microsoft Confidential
  57. # Copyright (C) Microsoft Corporation 1995
  58. # All Rights Reserved.
  59. # 
  60. # MAKEFILE for WDM device driver kit
  61. #
  62. ###########################################################
  63.  
  64. #
  65. # DO NOT EDIT THIS FILE!!! Edit .\sources. if you want to add a new source
  66. # file to this component. This file merely indirects to the real make file
  67. # that is shared by all the driver components of the Windows NT DDK
  68. #
  69.  
  70. !INCLUDE $(NTMAKEENV)\makefile.def
  71.  
  72.  
  73. SOURCES is following as below :
  74.  
  75.  
  76. TARGETNAME=xxxx
  77. TARGETTYPE=DRIVER
  78. DRIVERTYPE=WDM
  79. TARGETPATH=.
  80.  
  81. BLDCRT=1
  82.  
  83. INCLUDES=$(BASEDIR)\inc
  84.  
  85. SOURCES=xxxx.CPP( xxxx_2.CPP, xxxx_3.CPP... )
  86.  
  87. I386_SOURCES=xxxx.ASM( xxxx_2.ASM, xxxx_3.ASM... )
  88.  
  89. ( xxxx is the name of your Plug-ins )
  90.  
  91. If you have these files, you type "BUILD" in command line to
  92. create a WDM.
  93. If you choose "Checked Environment", it will make a debug-WDM
  94. in driectory <SOURCES driectory\I386\Checked. If you choose 
  95. "Free Environment", it will make a Release-WDM in
  96. <SOURCES driectory\I386\Free.
  97. The complie result will be log in file BUILD.LOG, the error
  98. message will be log in file BUILD.ERR and warning message will
  99. be log in file BUILD.WRN in the same directory as SOURCES.
  100.  
  101. You can run tool "BUILD" (include in Win98DDK) to compile and
  102. link Plug-ins. 
  103.  
  104. But, there is a strange problem:
  105. BUILD compiled your CPP and create directory ..\I386, but, it
  106. NOT create directory ..\I386\Checked and  ..\I386\Free, it will
  107. show some error message and fail to like. The best simple 
  108. resolving method is: creating directory by yourself.
  109.  
  110. And, if you have a release-WDM, Warning: It include symbol yet. 
  111. To resolve it, you must do:
  112.  
  113. DUMPBIN /HEADERS xxxx.sys |MORE 
  114. record the map-base address of OPTIONAL HEADER VALUES, 
  115. normally it is 0x10000. 
  116. Use command " REBASE -B 0x10000 -X .\Symbol xxxx.sys " to remove
  117. the symbol. 
  118. If you want to get more information, visit related web and newsgroup.
  119. Reference:
  120. Art Baker: The Windows NT Device Driver Book: A Guide for
  121. Programmers, 1997, published by Prentics Hall, INC.
  122.  
  123. The best simple method is copy/paste the sample's MK.BAT and SOURCES
  124. and MAKEFILE as the starting of your plug-ins.
  125.  
  126. -------------------------------------------------
  127. Plug-ins refernce
  128. -------------------------------------------------
  129. Let us begin the first Plug-ins. Every Plug-ins must have 
  130. determinate format following as below:
  131.  
  132. // This file extension name must be .CPP .
  133.  
  134. extern "C" {
  135. #include <wdm.h>
  136. }
  137. //  It define WDM .
  138.  
  139. #include "..\INCLUCE\PLUGS.H"
  140. //  It define the data type and functin prototype .
  141.  
  142. extern "C" NTSTATUS
  143. DriverEntry(IN PDRIVER_OBJECT DriverObject, 
  144.                     IN PUNICODE_STRING RegistryPath);
  145.  
  146. VOID
  147. Plugs_Unload(IN PDRIVER_OBJECT DriverObject);
  148.  
  149. extern "C" NTSTATUS DriverEntry(IN PDRIVER_OBJECT DriverObject, IN PUNICODE_STRING RegistryPath)
  150. {
  151.     NTSTATUS    ntStatus = STATUS_SUCCESS;
  152.  
  153.     DriverObject->DriverUnload = Plug-ins_Unload;
  154.  
  155.     return ntStatus;
  156. }
  157.  
  158. VOID
  159. Plug-ins_Unload(IN PDRIVER_OBJECT DriverObject)
  160. {
  161. }
  162. //  These are WDM format  , every Plug-ins has the same 
  163. //  code . 
  164. /************ Plug-ins Init and Exit routine **************/
  165.  
  166. PLUGS_API* api = 0;
  167. // This is TRW2000 API pointer . Plug-ins call TRW2000's API
  168. // must like this :
  169. //        
  170. //             TRW2000_api->Get_TRW2000_Version ( ) ;
  171. //
  172.  
  173. EXC EXPORT BOOL Plugs_Init ( PLUGS_API* plugsapi )
  174. {
  175.     TRW2000_api = api;
  176.  
  177.     // add your code.
  178.  
  179.     return TRUE;
  180.     // If Return FALSE this Plug-ins will not be load.
  181. }
  182.  
  183. EXC EXPORT BOOL Plugs_Exit ( )
  184. {
  185.     // add your code.
  186.  
  187.     return TRUE;
  188.     // Must return TRUE.
  189. }
  190.  
  191. Ok, if you have problem remaining, see example Plug-ins.
  192.  
  193. End
  194. Copyright(C) 2000. KnlSoft. Inc. 
  195. http://www.knlsoft.com
  196.