Removed references to GIF
[rrdtool.git] / NT-BUILD-TIPS.txt
1 Compiling RRDtool 1.1.x on Win32 (WinXP/Win2K with Visual C++):
2 ---------------------------------------------------------------
3 4/1/02 Jake Brutlag (jakeb@corp.webtv.net)
4
5 These notes share some insight I gained compiling 1.1.x with
6 MS Visual C++ 6.0 (using project files). This information may or
7 may not be accurate at the time you are reading this.
8
9 (1) freetype and rrdtool cannot use precompiled headers (which are
10 enabled by default for MSVC++ projects).  MSVC++ 6.0 does not
11 support precompiled headers if #include directives contain MACROS.
12 (2) Compile Release build with Default optimization, not the
13 Maximize Speed optimization. I encountered some strange errors
14 (related to argument processing for complex commands like graph--
15 perhaps the getopt stuff is too blame) with Maximize Speed.
16 (3) libart relies upon config.h (ostensibly generated by the
17 configure script-- but of course not on Win32 platforms). ..\..\confignt
18 (which contains a static Win32 version of config.h) should be on
19 the include path.
20 (4) Fonts are located in the %windir%\fonts, so the default font
21 is c:\winnt\fonts\cour.ttf.
22
23 Currently, to compile rrd.lib and rrdtool.exe using
24 the MSVC++ project files, first start MSVC++ 6.0. Open the rrdtool
25 workspace (rrdtool.dsw in the src directory). The active project/
26 configuration should be rrdtool-Win32 Release. Select Rebuild All
27 from the Build menu. The static link library (rrd.lib) will
28 be generated in src\release directory and executable will be generated
29 in the src\toolrelease directory.
30
31 Compiling RRDtool on NT ... work in progress
32 ---------------------------------------------------------------
33                          by Tamas Kovacshazy (khazy@mit.bme.hu)
34
35 Persisting Problems with the current NT port:
36
37 Unfortunately, the RRD perl modules does not work with Perl
38 (ActivePerl) using the current distribution.
39
40 The RRD shared perl module can be compiled after some
41 modification...
42
43 Follow these steps:
44
45 0. Install perl if you do not have it!
46    Visit http://www.ActiveState.com/pw32/ for a complete distribution.
47
48 1. Copy ..\gd1.2\release\gd.lib  to ..\gd1.2\
49 2. Copy ..\src\release\rrd.lib to ..\src
50 3. perl Makefile.pl
51
52 In this step the system complains about something I do not
53 understand. The error message is the following:
54
55 Note (probably harmless): No library found for '-lm'
56
57 Is a library missing? But it does not stop with an error...
58
59 4. nmake test (You must have Visual C++ on the machine!)
60
61 After these steps it generates the test files (svgs and rrds),
62 and they seem to be good.
63
64 The real problem in the shared perl modul is the following:
65
66 I do not know how this installation stuff works. The problem is
67 that the installation stuff looks for the gd.lib and the
68 rrd.lib in the ..\gd1.2 and ..\src directory. The UNIX compile
69 puts the files into these directories, but the NT compile does
70 not.
71
72 It is all for today,
73
74 khazy
75
76 Tamas Kovacshazy  E-mail: khazy@mit.bme.hu  
77 WWW: http://www.mit.bme.hu/~khazy
78 Technical University of Budapest 
79 Department of Measurement and Information Systems