Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 116 lines (96 sloc) 4.808 kb
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored
1 Installation procedure - preparation of the tree
2 KAME project
76fa044 English brush up and formatting.
kazu authored
3 $Id: INSTALL,v 1.22 2000/04/21 06:05:26 kazu Exp $
6bfb32f installation procedures.
itojun authored
4
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored
5 Let's call the entire file-tree under this directory "the KAME tree".
6bfb32f installation procedures.
itojun authored
6
13e0990 add diagram for directory tree. suggested by youki.
itojun authored
7 This directory contains several information files and two directories.
76fa044 English brush up and formatting.
kazu authored
8 The "kame" directory contains files created by the KAME project, which
9 are shareable among NetBSD, FreeBSD, and other operating systems. The
10 other directory is for your target operating system. For example, if
11 you are on NetBSD, the KAME tree looks like this:
6bfb32f installation procedures.
itojun authored
12
13e0990 add diagram for directory tree. suggested by youki.
itojun authored
13 kame --+-- INSTALL (the document you are looking at)
14 +-- kame --+-- sys (kernel source code shared among OSes)
15 | +-- kame --+-- libinet6
16 | +-- ....
17 | (userland source code shared among OSes)
18 |
19 +-- netbsd --+-- INSTALL (NetBSD-specific installation document)
20 +-- sys (kernel source code specific to NetBSD)
21 +-- lib --+-- libinet6
22 | +-- ...
23 +-- ... (userland source code specific to NetBSD)
e6250c2 move "make obj" issue to top-level INSTALL doc.
itojun authored
24
76fa044 English brush up and formatting.
kazu authored
25 The KAME tree has no direct relationship with "/usr/src" tree. You do
26 not need to care about /usr/src at all. Please follow the following
27 instructions.
13e0990 add diagram for directory tree. suggested by youki.
itojun authored
28
29 Except for bsdi[34], sufficient files are provided in the KAME tree to
30 bulid complete set of IPv6/IPsec binaries. You don't have to apply
31 any patches.
76fa044 English brush up and formatting.
kazu authored
32
33 For bsdi[34], due to license restrictions, some necessary files are
34 not provided (we are not allowed to redistribute the whole source code
35 tree). You have to complete the KAME tree by yourself. For example,
36 for bsdi[34], we cannot ship entire "sys" tree under kame/bsdi3/sys.
37 "sys.diff" is included in the KAME kit instead. You need to extract
38 "sys" tree under kame/bsdi3/sys by following step 2 in this document.
13e0990 add diagram for directory tree. suggested by youki.
itojun authored
39
40 kame --+-- INSTALL
41 +-- kame --+-- sys
42 | +-- kame --+-- libinet6
43 | +-- ....
44 |
45 +-- bsdi3 --+-- INSTALL
46 +-- sys.diff <--- need to extract "sys" tree here
47 +-- lib --+-- libinet6
48 | +-- ...
49 +-- ...
e6250c2 move "make obj" issue to top-level INSTALL doc.
itojun authored
50
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored
51 NOTE: On some operating systems it is possible to perform "make obj"
52 before building. However, it is not recommended since it might cause
53 troubles with anoncvs operation. For example, the "update" target for
54 Makefile in the top-level directory will become unusable. Do not
55 perform "make obj" unless you are ready to tackle those troubles.
56
57 0. If you have an installed KAME kit in the past, you may need to
58 remove the files under "/usr/local/v6" to avoid conflicts or misuse
59 of the old files during building. We recommend you to remove the
60 following, at least:
847fc63 remove files in /usr/local/v6 before KAME upgrades.
itojun authored
61 /usr/local/v6/lib/*
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored
62 Also, do not forget to update "/usr/include" in step 5 (see below),
63 otherwise the include files and source code become out-of-sync.
6bfb32f installation procedures.
itojun authored
64
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored
65 1. See the "VERSION" file and identify a symbol name for your target
66 operating system. For the rest of this document, we assume "netbsd"
67 for explanation.
68
76fa044 English brush up and formatting.
kazu authored
69 2. Be sure to have the complete KAME tree. For certain platforms
70 (namely bsdi3 and bsdi4) we cannot ship the whole source code tree
71 into the KAME tar.gz file, and you need to
72 - copy/untar fresh tree from CD-ROM/whatever
73 - apply patch included in KAME kit
3171ace explicitly specify "section 0 in bsdi[34]/INSTALL".
itojun authored
74 Please read section 0 in bsdi[34]/INSTALL before proceed further,
b65a508 clarify that bsdi[34] needs "patch" before "make prepare". (will move ta...
itojun authored
75 if you are using bsdi[34].
6bfb32f installation procedures.
itojun authored
76
77 3. Invoke the following:
78 % make TARGET=netbsd prepare
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored
79 This will create necessary symbolic links for building (from the
80 "netbsd" tree to the "kame" tree). NOTE: You'll need the "perl"
76fa044 English brush up and formatting.
kazu authored
81 interpreter to invoke this. If you see any error message from the
82 the process, you skipped some of steps required. Do not proceed
83 further.
6bfb32f installation procedures.
itojun authored
84
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored
85 4. Some parts of the KAME tree will be compiled, only if there are
86 certain libraries installed beforehand:
87 usr.sbin/racoon:
76fa044 English brush up and formatting.
kazu authored
88 Compiles only when OpenSSL 0.9.4 is installed
89 beforehand, and shell search path is configured to
90 reach "openssl" program.
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored
91 Please install those libraries before building.
d68fb29 SSLeay/OpenSSL installation.
itojun authored
92
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored
93 We support the following installations.
76fa044 English brush up and formatting.
kazu authored
94
99d2ec5 document openssl support twist (for SNAP)
itojun authored
95 - You installed OpenSSL, with default installation path.
76fa044 English brush up and formatting.
kazu authored
96 This means that you have given no option to "./configure". In
97 this case you should have
98 /usr/local/ssl/include/openssl/des.h.
99
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored
100 - You installed OpenSSL, via FreeBSD ports/NetBSD pkgsrc system.
76fa044 English brush up and formatting.
kazu authored
101 Note that we do not support ports-current/pkgsrc-current.
102 Please stick to the ports/pkgsrc came the FreeBSD/NetBSD you
103 are using. In this case you should have
104 /usr/{pkg,local}/include/openssl/des.h. We do not support
105 ports/pkgsrc with non-standard LOCALBASE/PREFIX.
171ebca install SSLeay or OpenSSL beforehand, if you need better crypto support.
itojun authored
106
76fa044 English brush up and formatting.
kazu authored
107 If you install OpenSSL with some other ways, the KAME tree may fail
108 to find OpenSSL and omit compilation of, for example,
109 usr.sbin/racoon.
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored
110
90056ff wording fix.
itojun authored
111 5. Go down to the target directory that you have specified (e.g
76fa044 English brush up and formatting.
kazu authored
112 "netbsd"), and read document named "INSTALL" (placed in somewhere
113 like "netbsd/INSTALL").
114
115 Good luck!
Something went wrong with that request. Please try again.