165ec1b8db60498f392943f8afd29ef3c5462afc
[sip-router] / INSTALL
1 $Id$
2
3 Installation Notes
4
5 Supported arhitectures: Linux/i386, Linux/armv4l, FreeBSD/i386, Solaris/sparc64,
6 Win*/i386 (CYGWIN)
7 (for other arhitectures the Makefile must be edited)
8
9 There are various configuration options defined in the Makefile.
10
11 Requirements:
12
13
14 - gcc >= 2.9x; 3.0.x recommended (it will work with older version but it might
15  require some options tweaking for best performance)
16 - bison or yacc (Berkley yacc)
17 - flex
18 - gmake (on Linux this is the standard "make")
19
20 OS Notes:
21
22 - FreeBSD: make sure gmake, bison & flex are installed
23 - Solaris: as above; you can use Solaris's yacc instead of bison
24 - Windows: it works in windows but you must install a recent cygwin version
25         (http://www.cygwin.com/) and also install a newer regex library version
26         (>=0.12). 
27         
28
29
30
31 Howto:
32 (NOTE: if make doesn't work try gmake  instead)
33
34 - compile with default options:
35
36 make   #builds only ser core, equivalent to make ser
37 make modules
38
39 or make all #builds everything
40
41 - compile with profiling
42
43 make PROFILE=-pg all
44
45 -compile debug mode version
46
47 make mode=debug all
48
49 -compile debug version with profiling
50
51 make mode=debug PROFILE=-pg all
52
53 -compile only the print module
54
55 make modules=modules/print modules
56
57 -compile all the modules except textops
58
59 make exclude_modules="CVS textops" modules
60
61 -compile with the "tm" module statically linked and with profiling
62
63 make static_modules=tm PROFILE=-pg all
64
65 -compile with gcc-3.0 instead of gcc
66
67 make CC=gcc-3.0 all
68
69
70
71 Make targets:
72
73 Clean:
74
75 make clean   (clean the modules too)
76 make proper  (clean also the dependencies)
77 make distclean (the same as proper)
78 make mantainer-clean (clean everything, including auto generated files,
79  tags, *.dbg a.s.o)
80
81 Compile:
82
83 make proper
84 make
85 (or gmake on non-Linux systems)
86 make modules 
87 or make modules exclude_modules="CVS print" etc.
88
89 Make tags:
90
91 make TAGS
92
93 Create a tar.gz with the sources:
94
95 make tar
96
97
98
99 Install(not done yet):
100
101 make prefix=/usr/local  install
102