File: INSTALLING

package info (click to toggle)
ipv6calc 0.93.1-2
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 3,020 kB
  • sloc: ansic: 36,079; perl: 2,175; sh: 1,322; makefile: 557; xml: 424
file content (154 lines) | stat: -rw-r--r-- 4,234 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
ipv6calc

                               INSTALLING

Please read the file `README' before you start with the installation of the
ipv6calc.


USING RPM
---------
This tar-ball provides a spec file for building an source and binary RPM using
	rpmbuild -ta ipv6calc-$version.tar.gz

	Available build options:
	 --with ip2location
	 --with geoip

After successful build you got two packages:
	one source RPM ipv6calc-$version-$release.src.rpm
	and one binary RPM ipv6calc-$version-$release.$arch.rpm

For installing use
	rpm -ihv ipv6calc-$version-$release.$arch.rpm
For updating use
	rpm -Fhv ipv6calc-$version-$release.$arch.rpm
For deinstalling use
	rpm -e ipv6calc


HACKERS WAY
-----------
cd /usr/src ; tar xvzf ipv6calc*.tar.gz

./configure --exec_prefix=/usr --mandir=/usr/share/man && make && make test && make -n install exec_prefix=/usr
make install exec_prefix=/usr


If you want to suppress configure's exec_prefix, specify bindir directly, e.g.

./configure --prefix=/usr/local --bindir /usr/local/bin --mandir /usr/local/share/man



For Solaris 8 you need following packages installed:
autoconf
automake
gcc
make
binutils
cvs (optional)
perl
m4


CONFIGURE
---------
There is a configure script available.

Following options are used:
 --bindir=/usr/bin  (@bindir@)
 --mandir=/usr/share/man (@mandir@)
 --enable-ip2location (see below for more information)
 --enable-geoip (see below for more information)

Execute:
 ./configure --bindir=/usr/bin --mandir=/usr/share/man


UPDATE OF DATABASES
-------------------
ipv6calc contains several databases, currently
* OUI type (IEEE)
* IAB type (IEEE)
* IPv4 address space assignment
* IPv6 address space assignment
to update this database before compilation you need:
- install perl, wget, aggregate
- run "make update"

See also:
 ./databases/registries/README
 ./databases/ipv4-assignment/README
 ./databases/ipv6-assignment/README
 ./databases/ieee-iab/README
 ./databases/ieee-oui/README


IP2LOCATION LIBRARY
-------------------
You can use the IP2Location library with ipv6calc. The library is available
at <http://www.ip2location.com/c.aspx>, and the currently supported version
is at least 2.1.3 (versions below are NOT supported). The support is
enabled with the --enable-ip2location configure option.

If you have installed the IP2Location library in a non-standard place, you
may find the --with-ip2location-headers=DIR and --with-ip2location-lib=DIR
configure options useful. If you have problems finding the library at
runtime, try linking it statically the --with-ip2location-static configure
option.

If you have problems building the IP2Location library, see the
README.BUILDING-IP2LOCATION file in the ipv6calc distribution.


GEOIP LIBRARY
-------------
You can also use the GeoIP library with ipv6calc. The library is available
at <http://www.maxmind.com/app/ip-location>, and the currently supported
version is 1.4.1 (although others may work too). The support is enabled
with the --enable-geoip configure option.

If you have installed the GeoIP library in a non-standard place, you may
find the --with-geoip-headers=DIR and --with-geoip-lib=DIR configure
options useful. If you have problems finding the library at runtime,
try linking it statically the --with-geoip-static configure option.

You can set the path to a default GeoIP database file by using the
--with-geoip-default-file configure option. This file is used
when ipv6calc is invoked with the '-G' (or '--db-geoip-default')
option.


PREPARATIONS
------------
"make update" updates the databases for static built-in
"make distclean" cleans the source
"make updateclean" also cleans the database header files


COMPILE
-------  
To compile simply use "make".

There should be no warnings or errors occur.


TESTING
-------
It's very recommended to test the created binaries using "make test" or at least
"make test-minimal" (this skips external database related tests).

If using a build system, which has not GeoIP or IP2Location databases installed,
but support was was enabled, use at least "make test-minimal"


INSTALLATION
------------
If you want to install the binary use "make install".


Peter Bieringer
<pb (at) bieringer.de>

$Id: INSTALLING,v 1.18 2011/10/29 08:35:24 peter Exp $