File: INSTALLING

package info (click to toggle)
ipv6calc 1.0.0-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 6,400 kB
  • sloc: ansic: 73,764; sh: 5,750; perl: 4,030; xml: 1,194; makefile: 888
file content (166 lines) | stat: -rw-r--r-- 4,446 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
155
156
157
158
159
160
161
162
163
164
165
166
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


RPM is currently tested on CentOS 5/6/7 / Fedora 20


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

For Gentoo you need following packages installed:
	dev-perl/URI
	dev-perl/Digest-SHA1


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 (24/36) type (IEEE)
* IAB type (IEEE)
* IPv4 address space assignment
* IPv6 address space assignment
* AS
* CC
to update this database before compilation you need:
- install perl, wget
- run "make update"

See also:
 ./databases/registries/README
 ./databases/ipv4-assignment/README
 ./databases/ipv6-assignment/README
 ./databases/ieee-iab/README
 ./databases/ieee-oui/README
 ./databases/ieee-oui36/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.

See also README.BUILDING-GeoIP


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: a69a1c7b1fc6dc9d62112d167e5ae9a88e5eb462 $