home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / impfunct.zip / README.TXT < prev    next >
Text File  |  1991-07-28  |  3KB  |  112 lines
  1. IMPLIST and IMPFILT are tools to help you understand the Dynamic
  2. Link Library (DLL) function calls, which are used by a program.
  3.  
  4. The utilities EXEHDR and IMPLIB are supplied by Microsoft as part of
  5. their C Compiler for OS/2.  
  6.  
  7.  
  8.  
  9. PACKAGE CONTENTS:
  10.  
  11.  
  12. SYMTYPES.H   - Source code header for common symbols.
  13.  
  14. IMPLIST.C    - Source code.
  15.  
  16. IMPLIST.DEF  - Module definition file for OS/2 window compatibility.
  17.  
  18. IMPLIST.MAK  - NMAKE make file to compile implist.
  19.  
  20. IMPLIST.EXE  - An OS/2 program to list the functions contained in an import
  21.                library.
  22.  
  23. IMPFILT.C    - Source code.
  24.  
  25. IMPFILT.DEF  - Module definition file for OS/2 window compatibility.
  26.  
  27. IMPLIST.MAK  - NMAKE make file to compile implist.
  28.  
  29. IMPFILT.EXE  - An OS/2 program to filter the listing created by EXEHDR and
  30.                list the imported function names.
  31.  
  32. IMPLST.CMD   - Sample execution which must be tailored for your 
  33.                ram disk configuration.
  34.  
  35. SAMPLE.TXT   - Implst run against PSTAT.EXE to show its usefulness. 
  36.  
  37. IMPLIST.TXT  - Sample from implist run against OS2.LIB.
  38.  
  39.  
  40.  
  41. INSTALLATION:
  42.  
  43.  
  44. Copy entire contents to a subdirectory.  If you make repeated use of this
  45. tool, then the cmd and exe files could be placed in the PATH.
  46.  
  47.  
  48. DESCRIPTION:
  49.  
  50.  
  51. The use of ordinal names in OS2.LIB complicates the process of figuring
  52. out how a particular EXE file works when you do not have the source code.
  53. I wrote IMPLIST and IMPFILT to automate this task.  IMPLIST takes any
  54. import library as input and creates a cross-reference list showing both
  55. the function ordinal number and full function name. IMPFILT uses this list
  56. and filters the output of the Microsoft C utility EXEHDR.  Ordinal function
  57. names are looked-up and the full function name is listed also.
  58.  
  59.  
  60.  
  61. IMPLIST  Will list exported function names and cardinal numbers
  62. from a xxx.lib file on OS/2 1.2 and 1.3.  The lib file may be one 
  63. supplied by the compiler vendor such as OS2.LIB or it can be created
  64. from any xxx.DLL.
  65.  
  66.  
  67. The utility IMPLIB can be used to create xxx.LIB import definition files
  68. from any DLL which does come with one.  Simply:
  69.  
  70.    implib  xxx.LIB  xxx.DLL
  71.  
  72.    where xxx.DLL is the existing Dynamic Link Library and xxx.LIB is the
  73.    function import library that will be created.
  74.  
  75.  
  76. IMPFILT will lookup imported function names from corresponding 
  77. cardinal numbers on the output from the MICROSOFT EXEHDR utility.
  78.  
  79. IMPFILT.C is written in an inefficient fashion since it opens and reads
  80. the cross-reference file for each look-up.  You should put the cross
  81. reference file on a ram disk for reasonable performance.    
  82.  
  83.  
  84.  
  85. AUTHOR:
  86.  
  87.     Stephen L. Reed, Stephen Reed Software.  
  88.  
  89.  
  90.      NET:        70401.3342@compuserve.com
  91.      BIX:        sreed
  92.      COMPUSERVE: 70401,3342
  93.  
  94.  
  95.      Your comments are appreciated!
  96.  
  97.  
  98. COPYRIGHT
  99.  
  100. Copyright (c) 1990-91  Stephen L. Reed.  All rights reserved.
  101.  
  102. Redistribution and use in source and binary forms are permitted
  103. provided that the above copyright notice and this paragraph are
  104. duplicated in all such forms and that any documentation,
  105. advertising materials, and other materials related to such
  106. distribution and use acknowledge that the software was developed
  107. by Stephen L. Reed.
  108.  
  109. THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
  110. IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
  111. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  112.