OSDN Git Service

Avoid uint32_t difference overflow in 64-bit pointer adjustment.
[mingw/pexports.git] / README
1 PEXPORTS 0.46 README
2 ============================================
3
4 Anders Norlander <anorland@hem2.passagen.se>
5 URL: hem2.passagen.se/anorland/
6
7 Hacked by Paul.Sokolovsky@technologist.com
8 URL: http://www.is.lg.ua/~paul/devel/binutils.html
9
10 Hacked by Tor Lillqvist <tml@iki.fi>
11
12 ============================================
13
14 PEXPORTS is a program to extract exported symbols from a PE image
15 (executable). It can perform a simple check on the size of the
16 arguments of the exported functions, provided there is a header with
17 prototypes for the functions. This is useful when you want the
18 decorated function names for functions using the stdcall calling
19 convention. GCC is used to do the preprocessing so it must be in your
20 path.
21
22 Note that the Windows version uses ';' as path separator,
23 while if built for Cygwin (or *nix) it uses ':'.
24
25 Command line options:
26 =====================
27         -h <header> parse header
28         -o print function ordinals
29         -p <preprocessor> set preprocessor
30         -v verbose mode
31
32 Header files are searched for in the following directories:
33 1. Current directory
34 2. Directories in C_INCLUDE_PATH
35 3. Directories in CPLUS_INCLUDE_PATH
36
37 NOTE: The header parser is *very* primitive, and might be of
38 questionable usefulness. It only tries to find function prototypes and
39 check the number of arguments a function expects. It is NOT a complete
40 C parser, there are probably many conditions when it will fail
41 (especially complex parameter types), although I it works fine for me.
42 Please do not report bugs, but feel free to send patches.
43
44 RELEASE 0.46
45 =================
46 * Corrects two potential segmentation fault bugs.
47 * Now supports building "out-of-source", to facilitate parallel builds
48   for differing hosts; (verified for mingw32, 32-bit and 64-bit linux).
49 * Now uses the GNU (autoconf managed) build procedure; run configure
50   before make, when building, ("in-source" or "out-of-source").
51
52 RELEASE 0.45
53 =================
54 * Incorporate patches from 0.44-1-mingw32 release
55 * Reinstate binary distribution for mingw32 host only;
56   (distributed source is host-agnostic).
57
58 RELEASE 0.44
59 =================
60 * Handle also 64-bit executables. Make it work also if built as 64-bit
61   code. Remove all gcc -Wall warnings. Make it compilable also with
62   MSVC. Disable Wow64 file system redirection when running as a 32-bit
63   process on 64-bit Windows. Distribute just sources.
64
65 RELEASE 0.43
66 =================
67 * There were bug which led to wrong subcategorizing of symbols as
68   code/data. I thought it was fixed in version on the site, but it turns
69   out that almost year there was wrong version. I greatly apologize to
70   everyone whom it cause problems and confusion.
71
72 RELEASE 0.42
73 =================
74 * Data/non-data symbols are now distinguished.
75
76 RELEASE 0.41
77 =================
78 * The header parser now accepts all kinds of parameters.
79
80 RELEASE 0.4
81 =================
82 * Function pointer parameters are now handled
83 * Handling of function attributes improved
84 * It is no longer always necessary to include windows.h for headers
85   that required it but did not include it themselves.
86
87 RELEASE 0.3
88 =================
89 * Completely rewritten parser (the previous one was *very* bad).
90   It is now possible to generate .DEF files for windows system
91   dlls (kernel32,user32,gdi32,shell32 etc)
92 * Enhanced symbol handling (symbols are sorted in a tree).
93
94 RELEASE 0.2
95 =================
96 * Fixed bug with unnamed parameters that are pointers.
97 * Extra whitespace is no longer printed
98 * Binary versions available for mingw32 and cygwin32
99
100 RELEASE 0.1
101 =================
102 * Initial release.
103 Pexports, Copyright (C) 1998 Anders Norlander
104 This program has ABSOLUTELY NO WARRANTY; This is free software, and you are
105 welcome to redistribute it under certain conditions; see COPYING
106 for details.