os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Fill with initial content about IPv6 in FreeBSD these days,

Browse source 
IPv6 only snapshots and FreeSBD and world IPv6 day.
Can be extended and improved as needed.

Add "WORLD IPV6 DAY BADGE: BLUE" image available for download
from http://www.worldipv6day.org/downloads/index.html .

Includes suggestions from:	rwatson
Approved by:			simon
Sponsored by:			The FreeBSD Foundation
Sponsored by:			iXsystems
This commit is contained in:
Bjoern A. Zeeb 2011-06-06 09:49:52 +00:00
parent 3448969b21
commit 614de01128
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/www/; revision=37337
6 changed files with 446 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

BIN
en/ipv6/IPv6-badge-blue-256-trans.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 24 KiB

8
en/ipv6/Makefile
View file

@ -1,4 +1,4 @@
# $FreeBSD$
# $FreeBSD: www/en/ipv6/Makefile,v 1.1 2011/06/03 12:48:52 bz Exp $
.if exists(../Makefile.conf)
.include "../Makefile.conf"
@ -7,6 +7,10 @@
.include "../Makefile.inc"
.endif
DOCS?= index.sgml
DOCS+= index.sgml
DOCS+= ipv6only.sgml
DOCS+= w6d.sgml
DATA+= IPv6-badge-blue-256-trans.png
.include "${WEB_PREFIX}/share/mk/web.site.mk"

73
en/ipv6/index.sgml
View file

@ -9,10 +9,10 @@
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
@ -26,17 +26,76 @@
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
$FreeBSD$
$FreeBSD: www/en/ipv6/index.sgml,v 1.1 2011/06/03 12:48:52 bz Exp $
-->
<!ENTITY base CDATA "..">
<!ENTITY date "$FreeBSD$">
<!ENTITY title "FreeBSD IPv6 Support">
<!ENTITY date "$FreeBSD: www/en/ipv6/index.sgml,v 1.1 2011/06/03 12:48:52 bz Exp $">
<!ENTITY title "IPv6 in &os;">
<!ENTITY % navinclude.developers "INCLUDE">
<!ENTITY % developers SYSTEM "../developers.sgml"> %developers;
<!ENTITY % catnav.ipv6 "INCLUDE">
<!ENTITY % catnav SYSTEM "ipv6.ent"> %catnav;
<!ENTITY ipv6onlysnap "http://wiki.freebsd.org/IPv6Only">
]>
<html>
&header;
<h2>Information coming Monday, June 6th 2011.</h2>
&catnav;
<h2>Introduction</h2>
<p>&os; has shipped tightly integrated IPv6 support for over a decade,
with the &os; 4.0 in 2000 the first release to include
&quot;out-of-the-box&quot; IPv6 support. These web pages document
on-going IPv6 development in the FreeBSD community, including
participation in IPv6 World Day 2011.
</p>
<h2>Latest news.</h2>
<ul>
<li><b>June 6, 2011</b>: The FreeBSD Foundation and iXsystems announced
today their commitment to support the efforts of World IPv6 Day to
accelerate global IPv6 deployment. Read the
<a href="http://www.prweb.com/releases/2011/6/prweb8529718.htm">
entire press release</a> and find more information on &os; and World
IPv6 Day <a href="w6d.html">here</a>.
</li>
<li><b>June 6, 2011</b>: New set of IPv6-only snapshots uploaded.
Read more about the snapshots <a href="ipv6only.html">here</a> and
find download links <a href="&ipv6onlysnap;">here</a>.
</li>
<li><b>June 6, 2011</b>: &a.hrs;
<a href="http://svn.freebsd.org/changeset/base/222732">commits</a>
<a href="http://www.rfc-editor.org/rfc/rfc6106.txt">RFC 6106</a>
&quot;IPv6 Router Router Advertisement Options for DNS
Configuration&quot; (RDNSS and DNSSL) support.
</li>
</ul>
<h2>IPv6 in &os;</h2>
<p>&os; is a widely used, open source operating system whose network stack
has been the foundation for decades of research, as well as a reference
implementation of IPv6 (developed by the
<a href="http://www.kame.net/">KAME</a> project).
&os; first shipped IPv6 support in March 2000 as part of &os;
<a href="&base;/releases/">4.0-Release</a>.
</p>
<h2>IPv6 and the &os; Project</h2>
<p>The &os; Project has been an early adopter and active participant in
the IPv6 community. With the help of the community, we have been
serving releases from IPv6-enabled servers since May 2003 and &os;'s
website, mailing lists, and developer infrastructure have been IPv6
enabled since 2007.
</p>
<p>&os; is used by critical Internet infrastructure such as root name
servers, routers, firewalls and some of the world's busiest and most
reliable web sites as well as embedded into many products all in the
need for the best IPv6 support. To read more about some companies
using the &os; operating system in their products, see the
<a href="http://www.freebsdfoundation.org/testimonials.shtml">&os;
Foundation Testimonials</a> page.
</p>
&footer;
</body>

42
en/ipv6/ipv6.ent Normal file
View file

@ -0,0 +1,42 @@
<!-- Copyright (c) 2011 The FreeBSD Foundation
All rights reserved.
This documentation was written by Bjoern Zeeb under sponsorship from
the FreeBSD Foundation.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
$FreeBSD$
-->
<!ENTITY % catnav.ipv6 "IGNORE">
<![ %catnav.ipv6; [
<!ENTITY catnav '
<div id="CATNAV">
<h4>Category Navigation</h4>
<ul>
<li><a href="&base;/ipv6/">IPv6 in FreeBSD</a></li>
<li><a href="&base;/ipv6/ipv6only.html">IPv6-only</a></li>
<li><a href="&base;/ipv6/w6d.html">World IPv6 Day</a></li>
</ul>
</div> <!-- CATNAV -->'>
]]>

165
en/ipv6/ipv6only.sgml Normal file
View file

@ -0,0 +1,165 @@
<!DOCTYPE HTML PUBLIC "-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension//EN" [
<!-- Copyright (c) 2011 The FreeBSD Foundation
All rights reserved.
This documentation was written by Bjoern Zeeb under sponsorship from
the FreeBSD Foundation.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
$FreeBSD$
-->
<!ENTITY base CDATA "..">
<!ENTITY date "$FreeBSD$">
<!ENTITY title "FreeBSD IPv6-only Support">
<!ENTITY % navinclude.developers "INCLUDE">
<!ENTITY % catnav.ipv6 "INCLUDE">
<!ENTITY % catnav SYSTEM "ipv6.ent"> %catnav;
<!ENTITY ipv6onlysnap "http://wiki.freebsd.org/IPv6Only">
]>
<html>
&header;
&catnav;
<h2>IPv4, Dual-Stack and what is &quot;IPv6-only&quot;?</h2>
<p>For multiple decades the Internet has been running on the Internet
Protocol version 4 (IPv4). You may know IPv4 addresses like 192.0.2.1.
IPv6, the Internet Protocol version 6, is the successor to that and has
a larger address space and longer addresses like
2001:db8:4672:6565:2026:5043:2d42:5344. A dual-stack (DS) system
supports both address families, IPv4 and IPv6. Dual-stack is the
default for &os; releases shipping at this time and has been since 2003.
An IPv6-only system is one that has been configured to use only IPv6
support; IPv4 support is completely removed from the system. Providing
IPv6-only snapshots of &os; shows that it has no strict internal
dependence on Internet Protocol version 4, and is ready to run in a pure
IPv6 environment.
</p>
<h2>IPv6-only history</h2>
<p>The IPv6 only kernel has started as a research project in 2008 when &os;
<a href="&base;/doc/en_US.ISO8859-1/books/handbook/jails.html">Jails</a>
gained IPv6 support and it became possible to have jails without IPv4.</p>
<p>The FreeBSD kernel has long been able to be compiled for dual-stack or
without INET6 support.
It was time for feature parity in that area as well.
As an intermediate step there were efforts to get the kernel compiling
without any IP support at all, which helped to narrow down the
problematic cases.</p>
<p>As of
<a href="http://svn.freebsd.org/changeset/base/221353">SVN r221353</a>
it is now possible to compile the kernel without INET but with INET6
support.
</p>
<h2>How can I get a system without INET support?</h2>
<p>There are two ways to get this:</p>
<ul>
<li>The easy way is to download an IPv6-only snapshot we provide and
test that put. See the <a href="&ipv6onlysnap;">IPv6-only</a> wiki
page for the latest snapshot builds and download links.</li>
<li>Alternatively you can install any FreeBSD HEAD (9.x or later) as of
May 2nd 2011 or later and compile your own kernel. See the
<a href ="&base;/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html">
Handbook</a> for how to do this.</li>
</ul>
<h2>Doing IPv6-only when the world tries to get to dual-stack?</h2>
<p>In a time where you hear numbers that about 4% of end users could
actually successfully access IPv6-only services it may indeed sound
strange. The BSD network stack however was used as a reference
implementation for the first time of TCP/IP and again was for IPv6 and
there are some parts of the world already that are limited to IPv6-only.
Over time, as IPv6 deployment proceeds, we expect to see a lot more of
this.</p>
<p>On the other hand having the IPv4 fall back option of dual-stack hides
a lot of IPv6 errors and omissions. Supposedly IPv6-ready software
breaks when running without IPv4. We want to help early in the process
to catch and fix these problems and want to encourage other software
developers to do the same. FreeBSD is used in embedded device and
targeting servers while at the same time people build desktop systems
with it. This entirety allows us to provide a turnkey solution, an
ideal platform for thorough testing.
</p>
<h2>FAQ</h2>
<h3>Do you have a sample kernel configuration for me?</h3>
<p>Yes we do. It is as simple as:
</p>
<pre>
include GENERIC
ident GENERIC-IPV6ONLY
makeoptions MKMODULESENV+="WITHOUT_INET_SUPPORT="
nooptions INET
nodevice gre
</pre>
<h3>I am not doing kernels but desktop applications. What about me?</h3>
<p>
&os; ships with a lot of applications running fine on command line.
If you prefer to test on a preconfigured graphical desktop,
<a href="http://www.pcbsd.org/">PC-BSD</a>, a &os; derived desktop
distribution is providing IPv6-only snapshots as well.
</p>
<h3>Is this limited to &os;?</h3>
<p>No.
While we provide the kernel and parts of user space for you to start
with, a lot of open sources and commercial software running on a
<span class="TRADEMARK">UNIX</span>&reg; or
<span class="TRADEMARK">UNIX</span>&reg;-like operating system
(e.g. <span class="TRADEMARK">&reg;Linux</span>) should be able to
compile and run on FreeBSD with minimal efforts. Also see the next
question.
</p>
<h3>Does everything just work on IPv6-only in &os;</h3>
<p>While are doing our best, some things are not yet working without
IPv4. Very few parts of the kernel still depend on IPv4 and we are
working on these. In user space you can find three different categories:
</p>
<ol>
<li>Software that is maintained as &os; base. We are actively working
on these as we find problems. Patches from the community are always
welcome.</li>
<li>Software that is shipped with &os; base but imported from a 3rd
party project. We are trying our best to get any problems solved and
are working with upstream vendors.<br>
If you are part of such a project you may want to test on IPv6-only
yourself to be really IPv6-ready with your next release! Try our
snapshots.</li>
<li>Software that is part of &os <a href="&base;/ports/">ports</a>
or any other open source or commercial software running on &os;.
We will lend a hand if needed and possible but are hoping for the
community to make best use of our snapshots and improve the overall
IPv6 readiness of software.</li>
</ol>
<!-- should we provide bsdinstall sample information? -->
&footer;
</body>
</html>

167
en/ipv6/w6d.sgml Normal file
View file

@ -0,0 +1,167 @@
<!DOCTYPE HTML PUBLIC "-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension//EN" [
<!-- Copyright (c) 2011 The FreeBSD Foundation
All rights reserved.
This documentation was written by Bjoern Zeeb under sponsorship from
the FreeBSD Foundation.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
$FreeBSD$
-->
<!ENTITY base CDATA "..">
<!ENTITY date "$FreeBSD$">
<!ENTITY title "FreeBSD and World IPv6 Day">
<!ENTITY % navinclude.developers "INCLUDE">
<!ENTITY % catnav.ipv6 "INCLUDE">
<!ENTITY % catnav SYSTEM "ipv6.ent"> %catnav;
]>
<html>
&header;
&catnav;
<img src="IPv6-badge-blue-256-trans.png"
alt="ISOC World IPv6 Day badge: blue"
style="float:right; border-style:none; margin-left:30px;">
<h2>About World IPv6 Day</h2>
<p>While Internet Protocol version 6 is in fact more than 15 years old,
World IPv6 Day, a 24 hour test flight day on <b>8 June 2011</b> has
motivated a lot of different organizations to get ready for IPv6, or
improve their already existent IPv6 support. Major content providers
will enable IPv6 for their websites that day, network operators and
hosting companies have been working to provide IPv6 to their customers
and operating system vendors like &os; have been improving IPv6 support.
You can find more information about World IPv6 Day on The Internet
Society's web page
<a href="http://www.worldipv6day.org/">www.worldipv6day.org</a>.
</p>
<h2>You and &os; on World IPv6 Day</h2>
<p>What is special about that day for &os; you might wonder? Indeed,
with the help of the community, &os; has been serving releases on IPv6
since 2003. We have our major infrastructure like
<a href="http://www.freebsd.org/">www.freebsd.org</a> IPv6 enabled since
<a href="&base;/news/2007/index.html#event200782:0">2007</a>. &os; itself
has been supporting IPv6 since the 4.0 Release for over a decade now,
using the <a href="http://www.kame.net/">KAME</a> based reference
implementation.
</p>
<p>Nonetheless there are things we can do during that day:</p>
<ul>
<li>help promoting IPv6.<br>
During the day there might be a lot more IPv6 users suddenly, and
some people are expecting significantly more traffic. A lot of
&os; servers are out there actively using IPv6, some people have put
&os; into their networking products, but only few tell us. We would
love to hear about your &os; IPv6 experiences on World IPv6 Day.
</li>
<li>help you in case of problems.<br>
Obviously if you will run into problems you might want help immediately
for the one day test flight. We will more closely monitor the
<a href="http://lists.freebsd.org/mailman/listinfo/freebsd-net">
&os; networking mailing list</a>, as well as being around on IRC in
#freebsd-w6d on EFNet to answer your questions. In case you will file
an IPv6 related <a href="&base;/support/bugreports.html">bug
report</a>, you may want to tag it with <small><tt>[ip6]</tt></small>.
</li>
<li>working on improving your IPv6 experience.<br>
As we get your questions and feedback we will take notes to further
improve IPv6 support in &os;. There might not be an immediate change
but rest assured that your feedback will not be lost.
</li>
</ul>
<p>Join us for World IPv6 Day, spread the word, to help improving IPv6
support in &os; even further!</p>
<h2>FAQ</h2>
<h3>What is this IPv6 thing?</h3>
<p>Please see the
<a href ="&base;/doc/en_US.ISO8859-1/books/handbook/network-ipv6.html">
chapter on IPv6</a> in the &os;
<a href ="&base;/doc/en_US.ISO8859-1/books/handbook/">Handbook</a>
for an explanation.
</p>
<h3>Do you provide IPv6 connectivity?</h3>
<p>&os; is an operating system, not an Internet Service Provider.
There are multiple ways to connect to an IPv6 network with &os;
however:
</p>
<ul>
<li>direct configuration on an (Ethernet) interface,</li>
<li>ppp and IPV6CP by user space ppp or some ports, and</li>
<li>various tunnel brokers we support out of base or ports</li>
</ul>
<p>to just name a few.<br>
Please see the
<a href ="&base;/doc/en_US.ISO8859-1/books/handbook/network-ipv6.html">
chapter on IPv6</a> in the &os;
<a href ="&base;/doc/en_US.ISO8859-1/books/handbook/">Handbook</a>
for more information.
</p>
<h3>I have problems getting IPv6 to work on FreeBSD. Can you help?</h3>
<p>Most likely. If our documentation did not help you, contact us. See
the previous section on how to best do that during World IPv6 Day.
</p>
<h3>Why is IPv6 not enabled by default?</h3>
<p>IPv6 has a mandatory link-local address.
In times where many people are are also using FreeBSD on their mobile
computers and joining random networks the services they started would
be accessible by other people on the same network. This may also happen
if they only started the services for IPv4 and are not aware of IPv6 at
all, do not have tcp-wrappers or a firewall in place. To not put people
at risk, IPv6 is disabled by default on FreeBSD.<br>
However we already provide support for you to configure it from our
installer and it will automatically start to work as soon as you
configure an interface for stateless address auto-configuration (SLAAC)
or with a static IPv6 address as it has been available in all default
configurations we have been shipping since 4.0 Release.
</p>
<h3>Do you have a desktop version as well?</h3>
<p>&os; comes with a huge collections of <a href="&base;/ports/">ports</a>
that allow you to install a graphical user interface and window manager
of choice. &os; however does not ship with a graphical desktop
preconfigured. Other &os; derived projects like
<a href="http://www.pcbsd.org/">PC-BSD</a> however do an excellent
job there.
</p>
<h3>I have reported a problem but it is not fixed yet.</h3>
<p>We are sorry that this is the case. If you have submitted a
<a href="&base;/support/bugreports.html">bug report</a> it is not lost.
&os; is developed and maintained by a
<a href="&base;/doc/en_US.ISO8859-1/articles/contributors/staff-committers.html">
large team of individuals</a> and there might have been other things we
worked on to improve &os;.
</p>
&footer;
</body>
</html>