Imported Upstream version 0.4.8
[platform/upstream/libsmi.git] / win / README.mingw
1
2 LIBSMI NOTES FOR NATIVE WIN32 SUPPORT USING MINGW
3 =================================================
4
5 @(#) $Id: README.mingw 7800 2008-02-27 13:55:53Z schoenw $
6
7 Mingw32 is a gcc based environment allowing to build free Win32
8 executables.
9 URL:ftp://ftp.xraylith.wisc.edu/pub/khan/gnu-win32/mingw32/
10
11 There are two possible setups. First, you can install the mingw
12 toolset on a Win32 system and compile the source code. The second
13 option is to install a mingw cross-compiler on Unix and to use a Unix
14 box for compilation. The Debian Linux distribution has mingw packages
15 which make this pretty easy.
16
17
18 USING MINGW ON WIN32
19 ====================
20
21 Fetch and install gcc-2.95.2-crtdll.exe or whatever the latest mingw
22 distribution is. Set your command.com PATH to c:\mingw\bin;%PATH% (or
23 whereever you have installed this package).
24
25 To compile simply run
26         make -f Makefile.mingw
27 and to install a
28         make -f Makefile.mingw install
29 should do what you expect and 
30         make -f Makefile.mingw zip
31 creates libsmi.zip ready to upload on the FTP server.
32
33 Default path's are c:/smi/mibs/... for the MIB-files and c:/smi/bin
34 for the tools (smidump.exe, ...).
35
36 Globalconfig is defined as c:/smi/smi.conf.
37
38
39 USING MINGW ON DEBIAN LINUX
40 ===========================
41
42 Install the mingw packages. Edit the Makefile.mingw to set the
43 compiler and so on. There is already a template in Makefile.mingw. To
44 compile simply run:
45
46         make -f Makefile.mingw
47
48 Installation probably requires some more tweaking of the
49 Makefile.mingw since it was originally written for the Win32
50 environment.
51
52
53 TODO's AND KNOWN PROBLEMS
54 =========================
55
56 - The version define is hardwired in config.h.
57
58 - The scanner, parser and the smi.h source have to be created within
59   a Unix or cygnus environment.
60
61 - The SMIPATH separator character is the Windows style ; and not the
62   Unix style : .
63
64 - Should use configure and not a handmade Makefile.
65
66
67 CONTRIBUTORS
68 ============
69
70 The mingw support was contributed by:
71
72         Erik Schoenfelder <schoenfr@gaertner.de>
73         Juergen Schoenwaelder <schoenw@ibr.cs.tu-bs.de>
74
75 ---
76 There are more things in heaven and earth,
77 Horatio, than are dreamt of in your philosophy.
78                 -- Wm. Shakespeare, "Hamlet"