Skip to content
Newer
Older
100644 118 lines (97 sloc) 4.86 KB
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored Dec 9, 1999
1 Installation procedure - preparation of the tree
2 KAME project
c6bb8d2 more openssl updates
itojun authored Mar 14, 2001
3 $KAME: INSTALL,v 1.26 2001/03/14 05:05:29 itojun Exp $
6bfb32f installation procedures.
itojun authored Aug 7, 1999
4
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored Dec 9, 1999
5 Let's call the entire file-tree under this directory "the KAME tree".
6bfb32f installation procedures.
itojun authored Aug 7, 1999
6
13e0990 add diagram for directory tree. suggested by youki.
itojun authored Apr 3, 2000
7 This directory contains several information files and two directories.
76fa044 English brush up and formatting.
kazu authored Apr 21, 2000
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 Aug 7, 1999
12
13e0990 add diagram for directory tree. suggested by youki.
itojun authored Apr 3, 2000
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 Aug 26, 1999
24
76fa044 English brush up and formatting.
kazu authored Apr 21, 2000
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 Apr 3, 2000
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 Apr 21, 2000
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 Apr 3, 2000
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 Aug 26, 1999
50
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored Dec 9, 1999
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 Sep 21, 1999
61 /usr/local/v6/lib/*
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored Dec 9, 1999
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 Aug 7, 1999
64
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored Dec 9, 1999
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 Apr 21, 2000
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 Feb 14, 2000
74 Please read section 0 in bsdi[34]/INSTALL before proceed further,
b65a508 clarify that bsdi[34] needs "patch" before "make prepare". (will move…
itojun authored Jan 31, 2000
75 if you are using bsdi[34].
6bfb32f installation procedures.
itojun authored Aug 7, 1999
76
77 3. Invoke the following:
78 % make TARGET=netbsd prepare
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored Dec 9, 1999
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 Apr 21, 2000
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 Aug 7, 1999
84
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored Dec 9, 1999
85 4. Some parts of the KAME tree will be compiled, only if there are
86 certain libraries installed beforehand:
87 usr.sbin/racoon:
c6bb8d2 more openssl updates
itojun authored Mar 14, 2001
88 Compiles only when OpenSSL 0.9.5a (or later) is installed
76fa044 English brush up and formatting.
kazu authored Apr 21, 2000
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 Dec 9, 1999
91 Please install those libraries before building.
d68fb29 SSLeay/OpenSSL installation.
itojun authored Oct 5, 1999
92
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored Dec 9, 1999
93 We support the following installations.
76fa044 English brush up and formatting.
kazu authored Apr 21, 2000
94
c6bb8d2 more openssl updates
itojun authored Mar 14, 2001
95 - Your system has OpenSSL installed by default. FreeBSD 4.2-RELEASE,
4df080e we support "openssl installed by default" systems.
itojun authored Mar 14, 2001
96 BSD/OS 4.2 and NetBSD 1.5 fall into this category.
97
c6bb8d2 more openssl updates
itojun authored Mar 14, 2001
98 - A system with OpenSSL, installed manually with default installation path.
99 This means that you gave no option to "./configure". In this case
100 you should have /usr/local/ssl/include/openssl/des.h.
101
102 - A system with OpenSSL, installed via FreeBSD ports system.
103 Note that we do not support ports-current. Please stick to the
104 ports directory came with the FreeBSD revioin you are using, or
105 the one came with KAME kit. In this case you should have
106 /usr/local/include/openssl/des.h. We do not support
107 ports with non-standard LOCALBASE/PREFIX.
171ebca install SSLeay or OpenSSL beforehand, if you need better crypto support.
itojun authored Aug 13, 1999
108
76fa044 English brush up and formatting.
kazu authored Apr 21, 2000
109 If you install OpenSSL with some other ways, the KAME tree may fail
110 to find OpenSSL and omit compilation of, for example,
111 usr.sbin/racoon.
9ecf22d Many parts of INSTALL has been re-written for readability.
kazu authored Dec 9, 1999
112
90056ff wording fix.
itojun authored Dec 13, 1999
113 5. Go down to the target directory that you have specified (e.g
76fa044 English brush up and formatting.
kazu authored Apr 21, 2000
114 "netbsd"), and read document named "INSTALL" (placed in somewhere
115 like "netbsd/INSTALL").
116
117 Good luck!
Something went wrong with that request. Please try again.