home *** CD-ROM | disk | FTP | other *** search
/ Programming Win32 Under the API / ProgrammingWin32UnderTheApiPatVillani.iso / dsasmsrc.zip / readme.txt < prev   
Text File  |  1998-10-16  |  4KB  |  119 lines

  1. Hello, every body.
  2.  
  3. This is my win32program disassembler version 0.21.(October 16,1998)
  4. This time I got rid of preccx dependencies. 
  5. This means pure C code for decoding. 
  6. And I totally redesigned program so,
  7. speed is improved dramatically( at least as far ad i played with),
  8. accuracy is improved, 
  9. more information is displayed.
  10. And, Oh yes, I added "hint" facility,
  11. this means you can direct disassembler -- 
  12.     some part of program is "code" 
  13.     or "byte data" or "address" or
  14.     "whatever it is significant"...    (actually only some part of
  15.                                      hint is implemented at this time}
  16.  
  17. in "hint file"-text file you may create.
  18. you can specify information as follows:
  19.     
  20.     a,A: address
  21.     b,B: byte data blocks
  22.     c,C: code blocks     - implemented
  23.     d,D: dwords
  24.     f,F: floats
  25.     g,G: doubles
  26.     q,Q: quad words
  27.     t,T: 80 bit reals     - implemented
  28.     w,W: words
  29.     n,N: null strings
  30.     p,P: pascal strings
  31.     x:   end of hind file
  32.  
  33. format is as follows:
  34. column  1: you give conversion specifier,
  35.            which is a,A,b,B,c,C,d,D,f,F,g,G,q,Q,t,T,w,W,n,N,p,P, and x
  36. column  2:     you need to give   ":" colon
  37. column  3-10:  you need to give   start address
  38. column  11:    you need to give   "-" minus
  39. column  12-19: you need to give   ending address
  40.  
  41. last line should be 
  42.     x:
  43.  
  44. what is difference between lower case and upper case?
  45.  
  46. for lower case you don't need to give column 11-19.
  47. this means there is no ending address, so only one
  48. instance of start location is changed as directed.
  49.  
  50. for upper case the blocks between start_address and end_address
  51. is changed as directed.
  52. here, end_address is not included.
  53. so in the following example,
  54. the location from 0040512E(included) to 00405368(not included)
  55. is converted to 80 bit reals.
  56.  
  57.  
  58. <example for hint file> two lines between -------'s
  59. -------------------------------------
  60. T:0040512E-00405368
  61. x:
  62. -------------------------------------
  63.  
  64. The usage of hint file is as follows:
  65.  
  66.     dsassm02 "yourfile.exe" "hint.txt" > "yourfile.txt"
  67.  
  68.         if you have hint file or
  69.  
  70.     dsassm02 "yourfile.exe" > "yourfile.txt"
  71.  
  72.  
  73. ************************************************
  74. Linux Porting
  75. ************************************************
  76. Due to Uwe Bonnes, Win32Program Disassembler is tested under Linux.
  77. He encouraged me to pay attention to the portability of disassembler.
  78. Only thing you need to do is as follows:
  79.  
  80. 1. convert dos file to unix file.
  81. 2. use the following make file and make.
  82. 3. thats all.
  83.  
  84. ============Makefile=====================
  85. CC=gcc
  86. LD=gcc
  87. VERSION = 0.21
  88. CFLAGS= -g -DVERSION=\"$(VERSION)\"
  89.  
  90. C_SRCS= decoder.c ieee.c main.c pedump.c print.c
  91. EXECUTABLE = pedisassem
  92.  
  93. all: $(EXECUTABLE)
  94.  
  95. OBJS = $(C_SRCS:.c=.o) $(GEN_ASM_SRCS:.s=.o) $(ASM_SRCS:.S=.o) \
  96.         $(RC_SRCS:.rc=.o) $(EXTRA_OBJS)
  97.  
  98. pedisassem: $(OBJS)
  99.         $(LD) -o $(EXECUTABLE) $(OBJS)
  100.  
  101. clean::
  102.         $(RM) *.o \#*\# *~ *% .#* *.bak *.orig *.rej *.flc *-tmp.c y.tab.c y.tab.h lex.yy.c core $(GEN_ASM_SRCS) $(RC_SRCS:.rc=.s) $(RC_SRCS:.rc=.h) $(PROGRAMS)
  103.  
  104.  
  105. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  106. You can contact me if you have any questions or problems.
  107. e-mail: sangcho@alpha94.chongju.ac.kr
  108. homepage for disassembler: www.geocities.com/SiliconValley/Foothills/4078/
  109. phone:  +82-431-229-8491 (South Korea)
  110. p.s. i like to receive nice postcards from you.
  111. if there is anyone who wants to express his/her gratitute
  112. he/she can send me a nice postcard.
  113.  
  114. my snail address:
  115. Sang Cho
  116. Department of Computer and Information Engineering
  117. ChongJu University
  118. ChongJu 360-764
  119. South Korea