1
2LIBSMI NOTES FOR NATIVE WIN32 SUPPORT
3=====================================
4
5@(#) $Id: README.win 8079 2008-04-17 18:12:48Z schoenw $
6
7This directory contains some help to compile the libsmi and associated
8tools on a Win32 platform (Windows 95, 98, 2000, NT) with the native
9Microsoft Visual C++ compiler. The makefile has been tested with VC++
106.0, but later versions should work very well too.
11
12An alternative GNUmakefile can be used with GNU make program.  You
13will need the GNU make "gmake.exe" for Win32 platform.
14
15There is a separate file README.mingw which explains how the libsmi
16package can be compiled on Win32 platforms using the mingw version
17of gcc.
18
19
20Installation
21============
22
23(1) Set MSVC version used in ./config.nmake. Check the compiler path
24    macro TOOLS32 in ./config.nmake for the specific msvc installation.
25
26(2) To compile simply run
27
28	nmake
29
30(3) and to install a
31
32	nmake install
33
34should do what you expect. The default path's are c:\smi\mibs\... for
35the MIB-files and c:\smi\bin for the tools (smidump.exe, ...). The
36global configuration file is expected to be in c:\smi\smi.conf.
37
38
39Alternative build with GNU make
40===============================
41
42GNU make uses GNUmakefile provided in this directory.
43
44(1) Make sure the compiler (cl.exe) is in PATH
45
46(2) To build simply run:
47
48    gmake
49
50
51
52If you grabbed the CVS version and some files seems to be missing:
53==================================================================
54
55You may generate these files on another platform (Linux seems to work
56fine) by running:
57
58    cd libsmi                   ## the sources from the CVS archive
59    ./autogen.sh                ## generates configure script an runs it
60    cd lib
61    make errormacros.h parser-smi.c parser-sming.c \
62                scanner-smi.c scanner-sming.c smi.h
63    cd ../tools
64    make dump-svg-script.h
65
66
67
68COMMENTS:
69=========
70
71- The 64 bit integer types (unsigned and signed) are simply replaced
72  by their 64bit _int64 msvc counterparts. They work ok.  see related
73  definitions ./config.h
74
75- The compiler path in ./config.nmake is hardwired (TOOLS32)
76
77- The installation directories are hardwired in config.h.in
78
79- Scanner and parser C files, errormacros.h and smi.h have been created
80  within a Unix environment and integrated with the distribution. If
81  you want to re-build them on a windows system you can use cygwin.
82
83- The default SMIPATH separator character is the Windows style `;' and
84  not the Unix style `:'. It can be changed using the
85  --with-pathseparator=C configure option.
86
87
88FURTHER INFORMATION
89===================
90
91You may find further information online, along with the subscription
92information on the libsmi mailing list at
93
94	http://www.ibr.cs.tu-bs.de/projects/libsmi/.
95
96
97	Erik Schoenfelder <schoenfr@gaertner.de>
98	Juergen Schoenwaelder <schoenw@ibr.cs.tu-bs.de>
99        Yigal Hochberg <hochberg@dmhsoftware.com>
100
101
102---
103<stu> you should be afraid to use KDE because RMS might come to your
104      house and cleave your monitor with an axe or something :)
105