Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
KAME repositories for the record

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


			README of KAME kit

			KAME Project

			$Date: 2000/04/26 09:31:35 $

<<<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, Yokogawa Digital Computer 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.


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 install this kit, please read INSTALL at the top directory, and
INSTALL under operating system directory (for example,

If you want to know what features are provided, please refer to

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).
- *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. 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.

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:, or /usr/local/v6/bin/kame-send-pr
	snap-users mailing list:

Thanks for your feedback!

<<<Contact Points>>

If you want to know more about KAME Project, please visit:
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".
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:

If you have questions about commercial usage or other
administrative/political issues, please send the questions to:


Current core members are:
           Kazu YAMAMOTO  IIJ Research Laboratory
       Jun-ichiro HAGINO  IIJ Research Laboratory
          Shoichi SAKANE  Yokogawa Digital Computer 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.


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
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, 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,
and Akira Kato (in no particular order).

We would also like to thank BSDI ( for donating
BSD/OS licenses for development.

We apologize for any omissions from this list, which are certainly

							<end of README>
Something went wrong with that request. Please try again.