forked from kame/kame
/
README
202 lines (157 loc) · 8.07 KB
/
README
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
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
README of KAME kit
KAME Project
$KAME: README,v 1.38 2000/08/04 15:27:26 sumikawa Exp $
<<<Project Overview>>>
"KAME Project" is a joint effort to create single solid software set,
especially targeted at IPv6/IPsec. Talented researchers from Fujitsu
Limited, Hitachi, Ltd., IIJ Research Laboratory, NEC Corporation,
Toshiba Corporation, YDC Corporation, Yokogawa Electric Corporation
joined the project. This joint effort will avoid unnecessary duplicated
development in the same area, and effectively provides high quality and
advanced featured packages.
KAME is originally called "Hydrangea" which was developed by v6
working group, WIDE Project. We have merged codes, which each company
in Japan has developed, into "Hydrangea". To identify the joint
effort, we changed the name from "Hydrangea" to "KAME".
KAME software has been merged into {FreeBSD,NetBSD,OpenBSD}-current.
It will also be merged into BSD/OS.
"KAME" officially indicates a short word of <Ka>rigo<me> where our office
locates. But it, in fact, stands for turtle in Japanese.
<<<Our Goals>>>
KAME Project aims to provide FREE reference implementations of
(1) IPv6
(2) IPsec
(3) advanced internetworking such as advanced packet queuing,
ATM, mobility, and whatever interesting
on several BSD variants.
<<<Copyright>>>
The kit comes with BSD-like copyright. In short, the code is FREELY
available but with NO WARRANTY. Even commercial use is OK. Please
refer to the COPYRIGHT file for more details. The copyright holder is
WIDE Project instead of KAME Project. This is because KAME Project is
to be terminated in March 2002.
READ CAREFULLY: Several countries have legal enforcement for
export/import/use of cryptographic software. Check it before playing
with the kit.
<<<What's Next?>>>
To know the difference from the previous stable release, please refer
to CHANGELOG and RELNOTES.
To install this kit, please read INSTALL at the top directory, and
INSTALL under operating system directory (for example,
netbsd/INSTALL).
If you want to know what features are provided, please refer to
IMPLEMENTATION.
Before you start using this kit, please take a look at USAGE.
<<<What is the difference with *BSD IPv6/IPsec code and KAME code?>>>
Starting summer 1999, *BSD distributions start incorporating KAME IPv6/IPsec
stack into their development track (i.e. *BSD-current). Recently some of
*BSDs ship with integrated IPv6 code (for example, FreeBSD 4.0-RELEASE).
Basically,
- *BSD distributions ship with past KAME code. and they do not include
some of experimental code in KAME tree (merger did not take place for
some of experimental portion, on purpose).
- KAME kit includes more recent IPv6/IPsec changes by KAME team.
It also includes more experimental code than the *BSD distributions, as
well as additional functionalities which haven't integrated into *BSDs yet.
http://www.kame.net/project-overview.html#release talks more about this issue.
A file named COVERAGE has detailed comparison between kame/*bsd, *bsd-curernt
and recent *bsd releases.
Please do not mix up development cycle in *BSD team, and in KAME team. They
are totally separate. For example, "FreeBSD 4.0-STABLE" has nothing to do
with "KAME STABLE kit".
<<<Reporting bugs>>
When you report bugs, please be sure to include the following information:
- the opertaing system platform you are using (like "FreeBSD 2.2.8-RELEASE")
- the hardware architecture you are using (i386, sparc, vax or whatever)
- the version of KAME you are using ("SNAP dated Jan 1 2000", or
"grabbed via anonymous CVS around Jan 1 2000")
- information necessary to repeat the problem
this includes, but not limited to,
(1) kernel compilation options,
(2) exact command line that raises the issue,
(3) routing table setup taken by "netstat -rn",
(4) interface configuration via "ifconfig -a",
(5) sysctl setting taken by "sysctl -a",
- (if necessary) hardware configuration, like "ethernet card is NE2000"
- (if necessary) screen trace on the trouble, taken by "script" command.
- (if necessary) packet trace taken by "tcpdump" command.
- (if necessary) IPv6/v4 connectivity status in your network
Don't try to *describe* your settings, just paste command output itself
onto the report instead. A bad example is "I assigned a global address on
my ethernet interface, but ping6 didn't work. Why?" No one will be
able to answer this kind of question. Instead, you should type as follows:
# /usr/local/v6/sbin/ifconfig -a
(paste the output. Again, the exact output is best. Do not try to
describe the output by your own word)
# /usr/local/v6/sbin/ifconfig ne0 inet6 2001:200::1234 prefixlen 64 alias
(paste the output)
# /usr/local/v6/sbin/ifconfig -a
(paste the output. The difference between the two "ifconfig -a" might
be important.)
# /usr/local/v6/sbin/ping6 -n 2001:300::1
(paste the output, including errors and warnings)
etc...
If you track the bugs, please notice the following items:
- be sure to use "ping6 -n", not "ping6", when you probe reachability.
- read IMPLEMENTATION chapter 1.3 if you try link-local addresses on
your tests.
Submit your bug report by using bug database, or you may want to
submit it to snap-users mailing list.
bug database: http://www.kame.net/, or /usr/local/v6/bin/kame-send-pr
snap-users mailing list: http://www.kame.net/snap-users/
Thanks for your feedback!
<<<Contact Points>>
If you want to know more about KAME Project, please visit:
http://www.kame.net/
You can get snapshots as well as stable releases. You are also able to
send bug reports on this web page.
We maintain users mailing list, called "snap-users".
http://www.kame.net/snap-users/
has archives of postings, how to subscribe, and some other information.
Share your tips, experiences, comments with other users.
If you have private comments to our developers, please drop a line to:
core@kame.net
If you have questions about commercial usage or other
administrative/political issues, please send the questions to:
kame-secretary@kame.net
<<<Researchers>>>
Current core members are:
Kazu YAMAMOTO IIJ Research Laboratory
Jun-ichiro HAGINO IIJ Research Laboratory
Shoichi SAKANE YDC Corporation
Munechika SUMIKAWA Hitachi, Ltd.
Tatsuya JINMEI Toshiba Corporation
Shin-ichi FUJISAWA Yokogawa Electric Corporation
Kazushi SUGYO NEC Corporation
Yoshinobu INOUE Fujitsu Limited
Kenjiro CHO Sony Computer Science Laboratory Inc.
Shinsuke SUZUKI Hitachi, Ltd.
<<<Acknowledgements>>>
The core members deeply thank the original members and the
contributors including:
Keiichi SHIMA, Yusaku HASEGAWA, Kentaro MISU, Yasushi YAMASAKI,
Atsushi ONOE, Noritoshi DEMIZU, Katsushi KOBAYASHI, Takahiro
KIKUCHI, Motonori NAKAMURA, Francis Dupont, Kazunori FUJIWARA,
HO Sonmyong, Masanari TSUBAI, Hiroshi URA, Craig Metz, Chris the
Elder, UO Youjiro, Wayne Knowles, Hajimu UMEMOTO, Ichiro Fukuhara,
David P. Wiggins, Martti Kuparinen, Tetsuya Isaki, Erik Bertelsen,
Toshio Shimojou, Kazunori Fujiwara, Kimio Ishii, Masafumi OE,
Mickael Hoerdt, Tomomi Suzuki, Arkadiusz Miskiewicz, Wolfgang Rupprecht,
YASUOKA Masahiko, Nobumichi Ozoe, Frederic SOULIER, Koji Kondo,
David PATE, Kenjiro Komaki, Satosi KOBAYASI, Takashi Tanaka, Heiko
W. Rupp, Kazuto Ushioda, Masahiro Ishiyama, Bill Sommerfeld, Jason
Thorpe, Yasunari Momoi, Chris P. Ross, Hideaki Imaizumi, Alexander
Fung, Scott Mace, Peter Tattam, Hideaki YOSHIFUJI, Naoyasu Takenaka,
Wada Keiji, Theo de Raadt, Niels Baggesen, Takahiro Yugawa, Laine
Stump, Hans-Joachim Knobloch, Angelos D. Keromytis, KOIE Hidetaka,
Markus Friedl, Ryota HIROSE, Shigeya Suzuki, Assar Westerlund,
Bruce A. Mah, Masaaki Noro, Hugh Graham, Hubert Feyer, Eric Lemiere,
Benoit Hilt, Noriaki Takamiya, Olivier TOGNI, Greg Troxel, Bill
Fenner, Goeran Bengtson, Tomio Narita, Conny Larsson, Ryuji Somegawa,
Akira Kato, Ronald van der Pol, Graham Wheeler, Kris Kennaway, Kazuo Horikawa
Larry Baird and Rimi Guyomarch(in no particular order).
We would also like to thank BSDI (http://www.bsdi.com/) for donating
BSD/OS licenses for development.
We apologize for any omissions from this list, which are certainly
unintentional.
<end of README>