share/man/man4/kame.4

   1 .\" Copyright (C) 1995, 1996, 1997, 1998 and 1999 WIDE Project.
   2 .\" All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. Neither the name of the project nor the names of its contributors
  13 .\"    may be used to endorse or promote products derived from this software
  14 .\"    without specific prior written permission.
  15 .\"
  16 .\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
  17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
  20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  26 .\" SUCH DAMAGE.
  27 .\"
  28 .\"     $Id: kame.4,v 1.4 1999/10/07 04:01:15 itojun Exp $
  29 .\"     $FreeBSD: src/share/man/man4/kame.4,v 1.3.2.7 2002/07/17 18:20:32 blackend Exp $
  30 .\"     $DragonFly: src/share/man/man4/Attic/kame.4,v 1.5 2005/03/23 00:25:18 dillon Exp $
  31 .\"
  32 .Dd April 13, 1999
  33 .Dt KAME 4
  34 .Os
  35 .Sh NAME
  36 .Nm KAME
  37 .Nd introduction and roadmap to KAME IPv6 software package
  38 .Sh DESCRIPTION
  39 .Nm
  40 software package is a result of joint work of several IPv6 researchers
  41 in Japan, to provide reference implementation of IPv6 to
  42 Berkeley Software Distribution
  43 .Pq Bx
  44 derived system such as
  45 .Bsx ,
  46 .Dx ,
  47 .Fx ,
  48 .Nx
  49 and
  50 .Ox
  51 (in alphabetical order).
  52 .Pp
  53 .\" Package consists of set of patches and additions to kernel,
  54 .\" modification to application, daemons, header files and libraries.
  55 KAME kit consists of IPv6/IPsec-ready kernel, application, daemons,
  56 header files and libraries.
  57 .Sh HIGHLIGHTS
  58 Following are some of highlights of this implementation.
  59 .Pp
  60 Note: features not yet integrated into
  61 .Fx
  62 or
  63 .Dx
  64 are marked with the
  65 .Pq -
  66 sign.
  67 .\"
  68 .Ss Kernel
  69 IPv6 and IPsec protocol stacks are implemented and available.
  70 See below for conformance to standards and/or internet drafts.
  71 .\"
  72 .Ss Plug and Play and protocol stack/interface configuration
  73 .Xr ndp 8 ,
  74 .Xr prefix 8 ,
  75 .Xr rrenumd 8 ,
  76 .Xr rtadvd 8 ,
  77 .Xr rtsol 8 ,
  78 .Xr rtsold 8 .
  79 .\"
  80 .Ss Routing
  81 .Xr rip6query 8 ,
  82 .Xr route6d 8 .
  83 .\"
  84 .Ss Multicast (includes routing and utilities)
  85 .Xr mchat 1
  86 .Pq - ,
  87 .Xr ifmcstat 8 ,
  88 .Xr pim6dd 8 ,
  89 .Xr pim6sd 8 ,
  90 .Xr pim6stat 8 .
  91 .\"
  92 .Ss Transition Tools
  93 Two IPv4 to IPv6 transition tools are available.
  94 TCP relay translator, FAITH
  95 .Pq Xr faithd 8
  96 and SIIT IPv6-to-v4 header translator implementation
  97 .Pq Xr ptrconfig 8 .
  98 .Xr ptrconfig 8
  99 is not yet integrated into
 100 .Fx
 101 and
 102 .Dx .
 103 .\"
 104 .Ss IPsec and tunnelling
 105 .Xr gifconfig 8 ,
 106 .Xr ipsec 4 ,
 107 .\" (dtcp and racoon doesn't exist yet.)
 108 .\" .Xr dtcpc 8 ,
 109 .\" .Xr dtcps 8 ,
 110 .\" .Xr racoon 8 ,
 111 .Xr setkey 8 .
 112 .Pp
 113 Dozen of existing tools are modified for IPsec support, like
 114 .Xr ping 8 .
 115 .\"
 116 .Ss Utilities/Diagnosis
 117 .Xr v6test 1
 118 .Pq - ,
 119 .Xr ping6 8 ,
 120 .Xr traceroute6 8 .
 121 .Pp
 122 Dozen of existing utilities are modified for IPv6/IPsec support, like
 123 .Xr ftp 1
 124 and/or
 125 .Xr telnet 1 .
 126 .\"
 127 .Ss Application Daemons
 128 .Xr inetd 8
 129 modified for IPv4/v6 support, or
 130 IPv6-only
 131 .Xr inet6d 8
 132 is supplied.
 133 .Pp
 134 Dozen of existing daemons are modified for IPv6/IPsec support, like
 135 .Xr ftpd 8
 136 and/or
 137 .Xr telnetd 8 .
 138 .\"
 139 .Sh DOCUMENTATION
 140 Although some of documentations have not modified yet, program itself
 141 may be heavily modified.
 142 Following lists are not complete, but give you some idea what kind of
 143 new software modules are available, or, modifications are made.
 144 Please refer to each manual page for detail.
 145 .\"
 146 .Ss Installation and basic usage documentations
 147 Please read the following files in the directories
 148 .Pa /usr/share/doc/IPv6
 149 and
 150 .Pa /usr/share/examples/IPv6
 151 to get a basic idea of (and installation methods for
 152 .Nm .
 153 You also can check out the IPv6 and IPsec chapters in the
 154 .Fx
 155 handbook.
 156 Also check latest status of project at web page:
 157 .Pa http://www.kame.net/ .
 158 (Hope you can see a
 159 .Dq Dancing Turtle
 160 .Li :-) )
 161 .\"
 162 .Ss APIs introduced or modified
 163 .Xr if_indextoname 3 ,
 164 .Xr getipnodebyname 3 ,
 165 .Xr gethostbyname 3 ,
 166 .Xr rresvport_af 3 ,
 167 .Xr hosts_ctl 3 ,
 168 .Xr ipsec_get_policylen 3 ,
 169 .Xr getnameinfo 3 ,
 170 .Xr freeaddrinfo 3 ,
 171 .Xr getaddrinfo 3 ,
 172 .Xr pcap 3 ,
 173 .Xr getipnodebyaddr 3 ,
 174 .Xr resolver 3 ,
 175 .Xr ipsec_strerror 3 ,
 176 .Xr gai_strerror 3 ,
 177 .Xr hosts_access 3 ,
 178 .Xr request_set 3 ,
 179 .Xr request_init 3 ,
 180 .Xr freehostent 3 ,
 181 .Xr if_nameindex 3 ,
 182 .Xr if_freenameindex 3 ,
 183 .Xr if_nametoindex 3 ,
 184 .Xr ipsec_dump_policy 3 ,
 185 .Xr ipsec_set_policy 3
 186 .\"
 187 .Ss Added/modified/renamed features and tools
 188 Please consult the manpages referred above.
 189 .\"
 190 .Sh SEE ALSO
 191 To understand
 192 .Nm
 193 protocol stack conformance, please refer to
 194 .Pa /usr/share/doc/IPv6/IMPLEMENTATION .
 195 .Pp
 196 Bug reporting form, user mailing list, frequently asked questions list,
 197 latest packages, related software, and more information can be found at
 198 .Pa http://www.kame.net/ .
 199 .\"
 200 .Ss "Related project"
 201 TAHI project who is providing verification technology for IPv6, is
 202 heavily related with KAME project.
 203 You can get current verification
 204 status of KAME software at following TAHI project web page:
 205 .Pa http://www.tahi.org/
 206 .\"
 207 .Sh HISTORY
 208 The
 209 .Nm
 210 project started in April 1999.
 211 .Nm
 212 kit was mostly integrated into
 213 .Fx
 214 by
 215 .An Youshinobu Inoue Aq shin@FreeBSD.org
 216 in January 2000.