mirror of https://github.com/tLDP/LDP
5007 lines
395 KiB
Plaintext
5007 lines
395 KiB
Plaintext
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.2//EN"
|
|
[
|
|
<!ENTITY % output.print.png "IGNORE">
|
|
<!ENTITY % output.print.pdf "IGNORE">
|
|
<!ENTITY % output.print.eps "IGNORE">
|
|
<!ENTITY % output.print.bmp "IGNORE">
|
|
]>
|
|
|
|
<!-- SGML file was created by LyX 2.2.2
|
|
See http://www.lyx.org/ for more information -->
|
|
<book lang="en">
|
|
<bookinfo>
|
|
<title>Linux IPv6 HOWTO (pt_BR)</title>
|
|
<author><firstname>Peter</firstname><surname>Bieringer</surname><affiliation><address>pb at bieringer dot de</address></affiliation></author>
|
|
<revhistory>
|
|
<revision> <revnumber>0.66wip</revnumber> <date>2010-04-20</date> <authorinitials>PB</authorinitials></revision>
|
|
<revision> <revnumber>0.65</revnumber> <date>2009-12-13</date> <authorinitials>PB</authorinitials></revision>
|
|
<revision> <revnumber>0.64</revnumber> <date>2009-06-11</date> <authorinitials>PB</authorinitials></revision>
|
|
<revision> <revnumber>0.60</revnumber> <date>2007-05-31</date> <authorinitials>PB</authorinitials></revision>
|
|
<revision> <revnumber>0.51</revnumber> <date>2006-11-08</date> <authorinitials>PB</authorinitials></revision>
|
|
</revhistory> <abstract>
|
|
<para>A meta deste HOWTO de IPv6 em Linux é responder as questões básicas e avançadas sobre a versão 6 do protocolo IP em um sistema com Linux. Este HOWTO dará ao leitor informação suficiente para instalar, configurar e usar aplicações IPv6 em máquinas com o Linux. Versões intermediárias deste HOWTO estão disponíveis nos endereços <ulink url="http://mirrors.bieringer.de/Linux+IPv6-HOWTO/">mirrors.bieringer.de</ulink> ou <ulink url="http://mirrors.deepspace6.net/Linux+IPv6-HOWTO/">mirrors.deepspace6.net</ulink>. Veja também <link linkend="revision-history">revision history</link> para saber das mudanças.</para>
|
|
</abstract></bookinfo><chapter id='chapter-general' >
|
|
<title><!-- anchor id="chapter-general" -->Geral</title>
|
|
<para>As informações sobre as traduções disponíveis estão na seção<link linkend="general-translations">Translations</link>.</para><sect1 id='general-copright' >
|
|
<title><!-- anchor id="general-copright" -->Copyright, licença e outros</title>
|
|
<sect2>
|
|
<title>Copyright</title>
|
|
<para>Escrito e com Copyright (C) 2001-2011 por Peter Bieringer</para></sect2><sect2>
|
|
<title>Licença</title>
|
|
<para>Este Linux IPv6 HOWTO está publicado sob a licença GNU GPL versão 2:
|
|
</para>
|
|
<para>Linux IPv6 HOWTO, um guia para configurar e usar o IPv6 em sistemas Linux.
|
|
</para>
|
|
<para>Copyright © 2001-2011 Peter Bieringer
|
|
</para>
|
|
<para>Este documento é um software livre; voce pode redistribui-lo e/ou modifica-lo sob os termos da licença GNU GPL, tal como está publicado pela Free Software Foundation; seja pela versão 2 da Licença, ou (em sua opinião) qualquer versão posterior.</para>
|
|
<para>Este programa é distribuído na esperança de que seja útil, mas SEM QUALQUER GARANTIA; nem mesmo qualquer garantia de COMERCIALIZAÇÃO ou ADEQUAÇÃO PARA UM PROPÓSITO PARTICULAR. Veja a GNU GPL para mais detalhes.</para>
|
|
<para>Se voce quiser uma cópia da licença GNU GPL, solicite através de carta para o endereço Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA.</para></sect2><sect2>
|
|
<title>Sobre o autor</title>
|
|
<sect3>
|
|
<title>História do autor com a Internet e IPv6</title>
|
|
<itemizedlist>
|
|
<listitem><para>1993: Eu entrei em contato com a internet utilizando um cliente de email e news baseado em console há bastante tempo (procure por "e91abier" no grupo <ulink url="http://groups.google.com/">groups.google.com</ulink>, sou eu).</para></listitem><listitem><para>1996: Foi solicitado que eu produzisse um curso de IPv6, incluindo um workshop com o Sistema Operacional Linux.</para></listitem><listitem><para>1997: Comecei escrevendo um guia sobre como instalar, configurar e utilizar o IPv6 em Linux, chamado<ulink url="http://www.bieringer.de/linux/IPv6/">IPv6 & Linux - HowTo</ulink> (veja <ulink url="http://www.bieringer.de/linux/IPv6/IPv6-HOWTO/IPv6-HOWTO-0.html#history">IPv6 & Linux - HowTo/History</ulink> para mais informações).</para></listitem><listitem><para>2001: Comecei a escrever este novo Linux IPv6 HOWTO.</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Contato</title>
|
|
<para>O autor pode ser contactado através do endereço de email <pb at bieringer dot de> e também através de sua<ulink url="http://www.bieringer.de/pb/">homepage</ulink>.</para>
|
|
<para>Atualmente ele mora em Munique [parte nordeste de Schwabing] / Bavaria / Alemanha (sul) / Europa (centro) / Terra (superfície).</para></sect3></sect2></sect1><sect1 id='general-category' >
|
|
<title><!-- anchor id="general-category" -->Categoria</title>
|
|
<para>Este HOWTO deve ser listado na categoria "Networking/Protocols".</para></sect1><sect1>
|
|
<title>Versão, Histórico e To-Do</title>
|
|
<sect2>
|
|
<title>Versão</title>
|
|
<para>A versão atual deste documento é mostrada no começo do documento.</para>
|
|
<para>Para outras versões ou traduções disponíveis, veja o site<ulink url="http://www.bieringer.de/linux/IPv6/">http://www.bieringer.de/linux/IPv6/</ulink>.</para></sect2><sect2>
|
|
<title>Histórico</title>
|
|
<sect3>
|
|
<title>Relevantes</title>
|
|
<para>2001-11-30: Começo do estilo do novo HOWTO.</para>
|
|
<para>2002-01-02: Maioria do conteúdo feito, primeira publicação do capítulo 1(versão 0.10).</para>
|
|
<para>2002-01-14: Mais conteúdo, algumas revisões, e publicação do documento completo (version 0.14).</para>
|
|
<para>2002-08-16: Tradução para o Polones em progresso</para>
|
|
<para>2002-10-31: Tradução para o Chines disponível (veja <link linkend="general-translations">Translations</link> para mais informações)</para>
|
|
<para>2002-11-10: Tradução para o Alemão em progresso</para>
|
|
<para>2003-02-10: Tradução para o Alemão disponível</para>
|
|
<para>2003-04-09: Tradução para o Frances em progresso</para>
|
|
<para>2003-05-09: Tradução para o Frances disponível</para>
|
|
<para>2003-10-16: Tradução para o Italiano em progresso</para>
|
|
<para>2004-03-12: Tradução para o Italiano disponível</para>
|
|
<para>2004-06-18: Tradução para o Grego em progresso</para>
|
|
<para>2005-07-25: Tradução para o Turco disponível</para>
|
|
<para>2007-03-28: Tradução para o Portugues-Brazil em progresso</para>
|
|
<para>2008-07-30: Tradução para o Espanhol disponível (mas ainda em progresso)</para></sect3><sect3>
|
|
<title>História completa</title>
|
|
<para>Veja <link linkend="revision-history">revision history</link> no final deste documento</para></sect3></sect2><sect2>
|
|
<title>To-Do</title>
|
|
<itemizedlist>
|
|
<listitem><para>Completar conteúdo que ainda falta</para></listitem><listitem><para>Finalizar a checagem gramatical</para></listitem></itemizedlist></sect2></sect1><sect1 id='general-translations' >
|
|
<title><!-- anchor id="general-translations" -->Traduções</title>
|
|
<para>As traduções devem sempre conter a URL, número da versão c copyright do documento original (e o seu também). Por favor não traduza o changelog original, pois isto não terá muita importancia. Também não traduza a seção sobre traduções disponíveis, pois elas podem estar desatualizadas. Ao invés disso, adicione uma URL para a seção em Ingles deste HOWTO.</para>
|
|
<para>Aparentemente a frequencia de mudança deste documento ocorre menos de uma vez por mes. Desde a versão 0.2.7 parece que a maioria do conteúdo que eu fiz foi escrito. As traduções devem sempre ter a versão em ingles como original..</para><sect2>
|
|
<title>Linguagens</title>
|
|
<para>Nota: uma olhada nesta URL pode ajudar<ulink url="http://www.bieringer.de/linux/IPv6/">http://www.bieringer.de/linux/IPv6/</ulink>.</para><sect3>
|
|
<title>Chines</title>
|
|
<para>A tradução para o Chines, feito por Burma Chen <expns at yahoo dot com> (informada a mim em 2002-10-31) e pode ser encontrada no TLDP:<ulink url="http://www.ibiblio.org/pub/Linux/docs/HOWTO/translations/zh/Linux-IPv6-HOWTO.txt.gz">http://www.ibiblio.org/pub/Linux/docs/HOWTO/translations/zh/Linux-IPv6-HOWTO.txt.gz (g'zipped txt)</ulink>. É uma foto da tradução, eu não sei se está atualizada.</para></sect3><sect3>
|
|
<title>Polones</title>
|
|
<para>Desde 2002-08-16 a tradução para o Polones foi iniciada e ainda está em progresso por Lukasz Jokiel <Lukasz dot Jokiel at klonex dot com dot pl>. Versão usada: CVS-version 1.29 do arquivo LyX, a qual foi a origem para a versão 0.2.7. O status é de ainda em progresso (2004-08-30).</para></sect3><sect3>
|
|
<title>German</title>
|
|
<para>Em 2002-11-10 a versão Alemã foi iniciada por Georg Käfer <gkaefer at gmx dot at> iniciou a tradução para o alemão, e a primeira publicação foi feita em 2003-02-10. Ela está originalmenmte disponível na Deep Space 6<ulink url="http://mirrors.deepspace6.net/Linux+IPv6-HOWTO-de/">http://mirrors.deepspace6.net/Linux+IPv6-HOWTO-de/</ulink> (e também em <ulink url="http://mirrors.bieringer.de/Linux+IPv6-HOWTO-de/">http://mirrors.bieringer.de/Linux+IPv6-HOWTO-de/</ulink>). Esta versão se manterá atualizada tanto quanto for possível.</para></sect3><sect3>
|
|
<title>Frances</title>
|
|
<para>Em 2003-04-09 foi iniciada a tradução da versão em Frances, por Michel Boucey <mboucey at free dot fr> e a primeira publicação foi em 2003-05-09. Ela está originalmente disponível na Deep Space 6<ulink url="http://mirrors.deepspace6.net/Linux+IPv6-HOWTO-fr/">http://mirrors.deepspace6.net/Linux+IPv6-HOWTO-fr/</ulink> (e também em <ulink url="http://mirrors.bieringer.de/Linux+IPv6-HOWTO-fr/">http://mirrors.bieringer.de/Linux+IPv6-HOWTO-fr/</ulink>).</para></sect3><sect3>
|
|
<title>Espanhol</title>
|
|
<para>Um membro do projeto MontevideoLibre, localizado no Uruguai (América do Sul) iniciou a tradução para espanhol no formato wiki:<ulink url="http://www.montevideolibre.org./manuales:libros:ipv6">http://www.montevideolibre.org./manuales:libros:ipv6</ulink></para></sect3><sect3>
|
|
<title>Italiano</title>
|
|
<para>Em 2003-10-16 a tradução para uma versão em Italiano foi iniciada Michele Ferritto <m dot ferritto at virgilio dot it> para o<ulink url="http://ildp.pluto.linux.it/">ILDP</ulink> (Italian Linux Documentation Project) e a sua primeira publicação foi em 2004-03-12. Ela está originalmente disponível no ILDP em <ulink url="http://it.tldp.org/HOWTO/Linux+IPv6-HOWTO/">http://it.tldp.org/HOWTO/Linux+IPv6-HOWTO/</ulink>.</para></sect3><sect3>
|
|
<title>Japones</title>
|
|
<para>Em 2003-05-14 Shino Taketani <shino_1305 at hotmail dot com> me enviou uma nota dizendo que planejava traduzir o HOWTO para o japones.</para></sect3><sect3>
|
|
<title>Grego</title>
|
|
<para>Em 2004-06-18 Nikolaos Tsarmpopoulos <ntsarb at uth dot gr> me enviou uma nota dizendo que planejava traduzir o HOWTO para o Grego.</para></sect3><sect3>
|
|
<title>Turco</title>
|
|
<para>Em 2005-07-18 Necdet Yucel <nyucel at comu dot edu dot tr> me enviou uma nota dizendo que a tradução em Turco estava disponível. E uma fotografia da tradução (versão 0.61) pode ser encontrada na URL<ulink url="http://docs.comu.edu.tr/howto/ipv6-howto.html">http://docs.comu.edu.tr/howto/ipv6-howto.html</ulink>.</para></sect3><sect3>
|
|
<title>Portuguese-Brazil</title>
|
|
<para>Em 2011-05-06 Gustavo Mendes de Carvalho <gmcarvalho at gmail dot com> iniciou a tradução deste HowTo para Portugues-Brazil. A primeira tentativa realizada em 2007 por Claudemir da Luz <claudemir dot daluz at virtuallink dot com dot br> nunca foi finalizada.</para></sect3></sect2></sect1><sect1>
|
|
<title>Técnico</title>
|
|
<sect2 id='general-original-source' >
|
|
<title><!-- anchor id="general-original-source" -->Fonte original deste HOWTO</title>
|
|
<para>Este HOWTO foi escrito usando LyX versão 1.6.1 em um sistema Linux Fedora 10 com o template SGML/XML (DocBook). Ele está disponível em <ulink url="https://github.com/tLDP/LDP/tree/master/LDP/users/Peter-Bieringer/">github / tLDP / LDP / users / Peter-Bieringer</ulink> para contribuições.</para><sect3>
|
|
<title>Divisor de linha de código</title>
|
|
<para>Eu utilizei um utilitário divisor de linha de código (Code line wrapping - "lyxcodelinewrapper.pl") feito por mim mesmo, e ele está disponível para seu próprio uso em<ulink url="http://cvs.tldp.org/go.to/LDP/LDP/users/Peter-Bieringer/">TLDP-CVS / users / Peter-Bieringer</ulink></para></sect3><sect3>
|
|
<title>Geração de SGML</title>
|
|
<para>O SGML/XML é gerado usando a função de exportar do LyX</para></sect3></sect2><sect2>
|
|
<title>Referencias On-line para a versão em HTML deste HOWTO</title>
|
|
<sect3>
|
|
<title>Página principal</title>
|
|
<para>Como boa prática, uma referencia à página principal deste HOWTO é recomendada.</para></sect3><sect3>
|
|
<title>Páginas dedicadas</title>
|
|
<para>Como as páginas em HTML são geradas a partir dos arquivos SGML, os nomes dos arquivos em HTML podem ser bastante diferentes (randomicos). Entretanto, algumas páginas são etiquetadas em LyX, resultando em nomes estáticos. Estas etiquetas são úteis para referencias e não deveriam ser alteradas no futuro. Se voce acredita que eu esqueci qualquer etiqueta, por favor me avise, e eu colocarei.</para></sect3></sect2></sect1><sect1>
|
|
<title>Prefácio</title>
|
|
<para>Algumas coisas antes:</para><sect2>
|
|
<title>Quantas versões deste HOWTO existem por aí ?</title>
|
|
<para>Incluindo esta, existem 3 (tres) documentos HOWTO disponíveis. Minhas desculpas se forem demais ;-)</para><sect3>
|
|
<title>Linux IPv6 FAQ/HOWTO (desatualizada)</title>
|
|
<para>O primeiro documento HOWTO relacionado a IPv6 foi escrito pelo Eric Osborne e era chamado<ulink url="http://www.linuxhq.com/IPv6/">Linux IPv6 FAQ/HOWTO</ulink> (por favor use-o somente para fins históricos). Sua última versão foi a 3.2.1, lançada em 14 de Julho de 1997.</para>
|
|
<para>Por favor ajude: Se alguém souber a data de nascimento deste HOWTO, por favor me envie um e-mail (estas informações são necessárias para o "histórico").</para></sect3><sect3>
|
|
<title>IPv6 & Linux - HowTo (mantida)</title>
|
|
<para>Esta segunda versão existe e se chama<ulink url="http://www.bieringer.de/linux/IPv6/">IPv6 & Linux - HowTo</ulink> escrita por mim (Peter Bieringer) em HTML puro. Ele nasceu em Abril de 1997 e sua primeira versão em ingles foi publicada em Junho de 1997. Eu vou continuar a manter esta versão, mas isto deve acontecer devagar e não será por completo, em favor da atualização da versão do Linux IPv6 HOWTO que voce está lendo agora.</para></sect3><sect3>
|
|
<title>Linux IPv6 HOWTO (este documento)</title>
|
|
<para>Já que este<ulink url="http://www.bieringer.de/linux/IPv6/">IPv6 & Linux - HowTo</ulink> foi escrito em HTML puro, ele não é compatível com o <ulink url="http://www.tldp.org/">The Linux Documentation Project (TLDP)</ulink>. Eu recebi então um pedido no final de Novembro de 2001 para reescrever este HowTo <ulink url="http://www.bieringer.de/linux/IPv6/">IPv6 & Linux - HowTo</ulink> em SGML. Entretanto, por causa da descontinuidade do HOWTO (<ulink url="http://www.bieringer.de/linux/IPv6/IPv6-HOWTO/IPv6-HOWTO-0.html#history">Future of IPv6 & Linux - HowTo</ulink>), e como o IPv6 estava ficando mais e mais padronizado, eu decidi escrever um novo documento cobrindo os pontos básicos e um pouco avançados que permaneceram importantes ao longo destes anos. Algum conteúdo mais dinamico e avançado ainda pode ser encontrado neste segundo HOWTO (<ulink url="http://www.bieringer.de/linux/IPv6/">IPv6 & Linux - HowTo</ulink>).</para></sect3></sect2></sect1><sect1>
|
|
<title>Termos usados, glossário e atalhos</title>
|
|
<sect2>
|
|
<title>Rede</title>
|
|
<variablelist>
|
|
<varlistentry><term>Base 10</term><listitem><para>Sistema numérico muito bem conhecido e representa qualquer valor com os dígitos 0 a 9.</para></listitem></varlistentry><varlistentry><term>Base 16</term><listitem><para>Geralmente usado em linguagens de programação, também conhecido como sistema numérico hexadecimal, representa qualquer valor com os dígitos 0 a 9 e caracteres A a F (case insensitive).</para></listitem></varlistentry><varlistentry><term>Base 85</term><listitem><para>Representação de um valor com 85 dígitos/caracteres diferentes, ele pode levar a strings menores, mas nunca vi ser usado em campo.</para></listitem></varlistentry><varlistentry><term>Bit</term><listitem><para>A menor unidade de armazenamento, representa on/verdade/1 e off/falso/0.</para></listitem></varlistentry><varlistentry><term>Byte</term><listitem><para>Geralmente uma coleção de 8 bits (mas não é necessariamente uma verdade - veja outros sistemas computacionais)</para></listitem></varlistentry><varlistentry><term>Device</term><listitem><para>Aqui, o hardware para a conexão de rede, veja também NIC</para></listitem></varlistentry><varlistentry><term>Dual homed host</term><listitem><para>Um sistema dual homed é um nó com duas redes (física ou virtual) com interfaces em dois links diferentes, mas sem encaminhar qualquer pacote entre eles (não é um router).</para></listitem></varlistentry><varlistentry><term>Host</term><listitem><para>Geralmente um sistema single homed com somente uma interface de rede ativa, exemplo Ethernet ou (não e) PPP.</para></listitem></varlistentry><varlistentry><term>Interface</term><listitem><para>Quase sempre o mesmo que "device", veja também NIC</para></listitem></varlistentry><varlistentry><term>IP Header</term><listitem><para>Cabeçalho de um pacote IP (cada pacote de rede tem um cabeçalho e seu tipo depende do nível de rede)</para></listitem></varlistentry><varlistentry><term>Link</term><listitem><para>Um link é o nível 2 de rede, ou meio de transporte de pacotes. exemplos são Ethernet, Token Ring, PPP, SLIP, ATM, ISDN, Frame Relay,...</para></listitem></varlistentry><varlistentry><term>Node</term><listitem><para>Um nó é um host ou um router.</para></listitem></varlistentry><varlistentry><term>Octet</term><listitem><para>É uma coleção de 8 bits, hoje bem similar a "byte".</para></listitem></varlistentry><varlistentry><term>Port</term><listitem><para>Informação utilizada pelo TCP/UDP dispatcher (camada 4) para transportar informações para as camadas superiores</para></listitem></varlistentry><varlistentry><term>Protocolo</term><listitem><para>Cada camada de rede que contém a maioria dos campos e informações para tornar a vida mais fácil ao enviar a informação transportada para as camadas superiores, veja camada 2 (MAC) e 3 (IP)</para></listitem></varlistentry><varlistentry><term>Router</term><listitem><para>Um router é um nó com 2 ou mais redes interfaces de rede (física ou virtual), capaz de encaminhar os pacotes entre as suas interfaces.</para></listitem></varlistentry><varlistentry><term>Socket</term><listitem><para>Um socket IP é definido pelo endereço de origem e destino, e suas portas</para></listitem></varlistentry><varlistentry><term>Stack</term><listitem><para>Relacionado às várias camadas de rede</para></listitem></varlistentry><varlistentry><term>Subnetmask</term><listitem><para>Redes IP usam bits de máscara para separar redes locais de redes remotas</para></listitem></varlistentry><varlistentry><term>Tunnel</term><listitem><para>Um túnel é tipicamente uma conexão ponto-a-ponto sobre a qual pacotes são trocados, e que carregam dados de outro protocolo. Exemplo túnel IPv6-in-IPv4.</para></listitem></varlistentry></variablelist><sect3 id='Glossar' >
|
|
<title><!-- anchor id="Glossar" -->Atalhos</title>
|
|
<variablelist>
|
|
<varlistentry><term>ACL</term><listitem><para>Access Control List - Lista de controle de acesso</para></listitem></varlistentry><varlistentry><term>API</term><listitem><para>Application Programming Interface - Interface de programação de aplicação</para></listitem></varlistentry><varlistentry><term>ASIC</term><listitem><para>Application Specified Integrated Circuit</para></listitem></varlistentry><varlistentry><term>BSD</term><listitem><para>Berkeley Software Distribution</para></listitem></varlistentry><varlistentry><term>CAN-Bus</term><listitem><para>Controller Area Network Bus (physical bus system)</para></listitem></varlistentry><varlistentry><term>ISP</term><listitem><para>Internet Service Provider - Provedor de serviços Internet</para></listitem></varlistentry><varlistentry><term>KAME</term><listitem><para>Projeto - um esforço conjunto de seis companhias no Japão para fornecer grátis uma pilha IPv6 e IPsec (para ambos IPv4 e IPv6) para as variantes BSD existentes no mundo <ulink url="http://www.kame.net/">www.kame.net</ulink></para></listitem></varlistentry><varlistentry><term>LIR</term><listitem><para>Local Internet Registry - No Brasil, o registro.br</para></listitem></varlistentry><varlistentry><term>NIC</term><listitem><para>Network Interface Card</para></listitem></varlistentry><varlistentry><term>RFC</term><listitem><para>Request For Comments - conjunto de notas técnicas organizacionais sobre a Internet</para></listitem></varlistentry><varlistentry><term>USAGI</term><listitem><para>UniverSAl playGround for Ipv6 Project - trabalho para entregar uma pilha IPv6 de qualidade para os sistemas Linux.</para></listitem></varlistentry></variablelist></sect3></sect2><sect2>
|
|
<title>Informações úteis</title>
|
|
<sect3>
|
|
<title>Sinal de divisão de linha longa de código</title>
|
|
<para>O caractere especial "¬" é usado para sinalizar que esta linha de código foi dividida para se obter uma melhor visualização em arquivos PFG e PS.</para></sect3><sect3>
|
|
<title>Marcadores</title>
|
|
<para>Nos exemplos genéricos voce encontrará as seguintes marcações:</para><screen>
|
|
<![CDATA[<myipaddress>
|
|
]]></screen><para>Para o uso real em seu sistema de linha de comando ou em scripts, isto deve ser substituído pelo conteúdo correto (removendo os sinais < e >). Desta forma o resultado seria</para><screen>
|
|
<![CDATA[1.2.3.4
|
|
]]></screen></sect3><sect3>
|
|
<title>Comandos no shell</title>
|
|
<para>Comandos executados no shell por usuários normais (não root) começam com $</para><screen>
|
|
<![CDATA[$ whoami
|
|
]]></screen><para>Comandos executados pelo usuário root começam com #</para><screen>
|
|
<![CDATA[# whoami
|
|
]]></screen></sect3></sect2></sect1><sect1>
|
|
<title>Necessidades para usar este HOWTO</title>
|
|
<sect2>
|
|
<title>Prerequisitos pessoais</title>
|
|
<sect3>
|
|
<title>Experiencia com ferramentas Unix</title>
|
|
<para>Voce deve estar familiarizado com a maioria das ferramentas Unix, como grep, awk, find, etc. , e saber sobre a maioria das opções mais usadas de cada um deles.</para></sect3><sect3>
|
|
<title>Experiencia com teoria de rede</title>
|
|
<para>Voce deve estar famliarizado com camadas, protocolos, endereços, cabos, conectores, etc. Se voce é novo nesta área, este é um bom local para voce iniciar seus estudos<ulink url="http://www.rigacci.org/docs/biblio/online/intro_to_networking/book1.htm">http://www.rigacci.org/docs/biblio/online/intro_to_networking/book1.htm</ulink></para></sect3><sect3>
|
|
<title>Experiencia com configuração IPv4</title>
|
|
<para>Voce deve definitivamente ter alguma experiencia em configuração de redes IPv4, caso contrário será difícil para voce entender o que realmente está acontecendo.</para></sect3><sect3>
|
|
<title>Experiencia com Domain Name System (DNS)</title>
|
|
<para>Permitirá a voce entender o que é um Domain Name System (DNS), que serviço ele fornece e como usa-lo.</para></sect3><sect3>
|
|
<title>Experiencia com estratégias de debug de rede</title>
|
|
<para>Voce deve pelo menos entender como usar o tcpdump e o que ele pode te mostrar. Caso contrário a depuração de problemas de rede será muito difícil para voce.</para></sect3></sect2><sect2>
|
|
<title>Hardware compatível com o sistema Linux</title>
|
|
<para>É claro que voce vai precisar usar algum hardware (pode ser uma maquina virtual), e não somente ler este HOWTO para dormir. ;-7)</para></sect2></sect1></chapter><chapter id='chapter-basics' >
|
|
<title><!-- anchor id="chapter-basics" -->Básico</title>
|
|
<sect1>
|
|
<title>O que é IPv6?</title>
|
|
<para>O IPv6 é um novo protocolo de camada 3 que tem a função de substituir o IPv4 (também conhecido apenas por IP). O IPv4 foi projetado a muito tempo atrás(<ulink url="http://www.faqs.org/rfcs/rfc760.html">RFC 760 / Internet Protocol</ulink> de Janeiro de 1980) e desde o começo tem havido muitos pedidos de atender mais capacidades e funcionalidades. A última RFC é <ulink url="http://www.faqs.org/rfcs/rfc2460.html">RFC 2460 / Internet Protocol Version 6 Specification</ulink>.As grandes mudanças no IPv6 foram o novo formato do cabeçalho, incluindo o tamanho da capacidade de endereços, de 32 para 128 bits. Já que a camada 3 é a responsável por transporte de pacotes fim a fim usando o roteamento baseado em endereços, ele deveria incluir os endereços IPv6 de origem e destino tal como o IPv4.</para>
|
|
<para>Para mais informações sobre a história do IPv6, de uma olhada nas RFC's mais antigas do IPv6 listadas aqui<ulink url="http://www.switch.ch/lan/ipv6/references.html">SWITCH IPv6 Pilot / References</ulink>.</para></sect1><sect1 id='basic-history-IPv6-Linux' >
|
|
<title><!-- anchor id="basic-history-IPv6-Linux" -->História do IPv6 no Linux</title>
|
|
<para>Os anos de 1992, 1993 e 1994 do IPv6 no Linux (linhas gerais) são cobertos pelo seguinte documento:<ulink url="http://www.laynetworks.com/IPv6.htm#CH3">IPv6 or IPng (IP next generation)</ulink>.</para>
|
|
<para>To-do: melhorar a linha do tempo, adicionar conteúdo...</para><sect2>
|
|
<title>O começo</title>
|
|
<para>O primeiro trecho de código de rede relacionado com o IPv6 foi adicionado ao kernel 2.1.8 do Linux em novembro de 1996 por Pedro Roque. Ele foi baseado na API do BSD:</para><screen>
|
|
<![CDATA[diff -u --recursive --new-file v2.1.7/linux/include/linux/in6.h
|
|
¬ linux/include/linux/in6.h
|
|
--- v2.1.7/linux/include/linux/in6.h Thu Jan 1 02:00:00 1970
|
|
+++ linux/include/linux/in6.h Sun Nov 3 11:04:42 1996
|
|
@@ -0,0 +1,99 @@
|
|
+/*
|
|
+ * Types and definitions for AF_INET6
|
|
+ * Linux INET6 implementation
|
|
+ * + * Authors:
|
|
+ * Pedro Roque <******>
|
|
+ *
|
|
+ * Source:
|
|
+ * IPv6 Program Interfaces for BSD Systems
|
|
+ * <draft-ietf-ipngwg-bsd-api-05.txt>
|
|
]]></screen><para>As linhas mostradas foram copiadas do patch-2.1.8 (o email foi limpo para evitar spam).</para></sect2><sect2>
|
|
<title>Enquanto isso</title>
|
|
<para>Por conta do buraco da manpower, a implementação do IPv6 no kernel foi incapaz de seguir os rascunhos propostos pelos novos RFC's publicados. Em outubro de 2000, um projeto foi iniciado no Japão, chamado<ulink url="http://www.linux-ipv6.org/">USAGI</ulink>, cujo objetivo foi implantar todo o restante, ou desatualizado, suporte ao IPv6 para o Linux. Ele utiliza a implementação IPv6 atual para o FreeBSD feita pelo <ulink url="http://www.kame.net/">KAME project</ulink>. De tempos em tempos, eles criavam fotos da versão vanilla do código do kernel do Linux.</para>
|
|
<para>Até a implementação do desenvolvimento na série 2.5 do kernel ter sido iniciado, os patches do<ulink url="http://www.linux-ipv6.org/">USAGI</ulink> eram tão grandes, que os mantenedores de rede do Linux eram incapazes de inclui-lo completamente no código final do kernel do Linux série 2.4.x.</para>
|
|
<para>Durante o desenvolvimento da serie 2.5, o tentou inserir todas as suas extensões usadas nesta série.</para></sect2><sect2>
|
|
<title>Atualmente</title>
|
|
<para>Muito do desenvolvimento feito para o IPv6 e patches do<ulink url="http://www.linux-ipv6.org/">USAGI</ulink> e outros estão integrados na série vanilla do kernel 2.6.x.</para></sect2><sect2>
|
|
<title>O futuro</title>
|
|
<para>O <ulink url="http://www.linux-ipv6.org/">USAGI</ulink> e outros ainda mantém o trabalho na implementação de novas características e funcionalidades, como a mobilidade e outros. De tempos em tempos, novos patches com extensões são lançados e também integrados à série vanilla do kernel.</para></sect2></sect1><sect1>
|
|
<title>Como o endereço IPv6 se parece?</title>
|
|
<para>Como já mencionado antes, os endereços IPv6 possuem 128 bits de tamanho. Este número de bits gera um número decimal extremamente grande, com 39 dígitos de tamanho:</para><screen>
|
|
<![CDATA[2^128-1: 340282366920938463463374607431768211455
|
|
]]></screen><para>Tais números não são endereços fáceis de serem memorizados. Os endereços IPv6 também tem um esquema orientado a bits (assim como o IPv4, mas não tão facilmente reconhecido). Assim a melhor notação de números tão grandes é em formato hexadecimal. Em hexadecimal, 4 bits (também conhecidos como "nibble") são representados por um dígito ou caractere, de 0-9 e A-F. Desta forma, o tamanho do endereço é reduzido para 32 caracteres.</para><screen>
|
|
<![CDATA[2^128-1: 0xffffffffffffffffffffffffffffffff
|
|
]]></screen><para>Esta representação ainda não é muito conveniente (com a possível mistura ou perda de um único dígito hexadecimal), então os desenvolvedores do IPv6 escolheram um formato hexadecimal com um ":" separando cada bloco de 16 bits. Com isso, o sinal inicial 0x (um prefixo para valores hexadecimais em linguagens de programação) foi removido:</para><screen>
|
|
<![CDATA[2^128-1: ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff
|
|
]]></screen><para>Um endereço utilizável seria:</para><screen>
|
|
<![CDATA[2001:0db8:0100:f101:0210:a4ff:fee3:9566
|
|
]]></screen><para>Para simplificar, os zeros iniciais de cada bloco de 16 bits pode ser omitido:</para><screen>
|
|
<![CDATA[2001:0db8:0100:f101:0210:a4ff:fee3:9566 ->
|
|
¬ 2001:db8:100:f101:210:a4ff:fee3:9566
|
|
]]></screen><para>Um bloco de 16 bits contendo somente zeros também pode ser omitida, sendo representada por "::", mas não mais de uma única vez no endereço. Caso contrário poderia haver duplicação de endereços.</para><screen>
|
|
<![CDATA[2001:0db8:100:f101:0:0:0:1 -> 2001:db8:100:f101::1
|
|
]]></screen><para>A maior redução possível é vista do endereço IPv6 de localhost:</para><screen>
|
|
<![CDATA[0000:0000:0000:0000:0000:0000:0000:0001 -> ::1
|
|
]]></screen><para>Há também um outro representação em modo compacto (Código base 85) baseado na<ulink url="http://www.faqs.org/rfcs/rfc1924.html">RFC 1924 / A Compact Representation of IPv6 Addresses</ulink>(publicada em 1º Abril 1996), nunca vista em campo. Provavelmente é uma pegadinha ou mentirinha da data. Mas aqui está um exemplo:</para><screen>
|
|
<![CDATA[# ipv6calc --addr_to_base85 2001:0db8:0100:f101:0210:a4ff:fee3:9566
|
|
9R}vSQZ1W=9A_Q74Lz&R
|
|
]]></screen><blockquote>
|
|
<para>Info: ipv6calc é uma calculadora de formato de endereços IPv6 que também faz conversões, e pode ser encontrada aqui: <ulink url="http://www.deepspace6.net/projects/ipv6calc.html">ipv6calc homepage</ulink> (<ulink url="http://mirrors.bieringer.de/www.deepspace6.net/projects/ipv6calc.html">Mirror</ulink>)</para>
|
|
</blockquote></sect1><sect1>
|
|
<title>FAQ (Básico)</title>
|
|
<sect2>
|
|
<title>Porque o nome do sucessor do IPv4 é IPv6 e não IPv5 ?</title>
|
|
<para>No cabeçalho IP, os primeiros 4 bits são reservados para a versão do protocolo. Então em teoria qualquer número entre 0 e 15 seria possível.</para><itemizedlist>
|
|
<listitem><para>4: já em uso pelo IPv4</para></listitem><listitem><para>5: está reservado para o Stream Protocol (STP,<ulink url="http://www.faqs.org/rfcs/rfc1819.html">RFC 1819 / Internet Stream Protocol Version 2</ulink>) (o qual nunca foi realmente feito para o público)</para></listitem></itemizedlist><para>O próximo número disponível era 6. Portando, assim nasceu o IPv6!</para></sect2><sect2>
|
|
<title>Endereços IPv6: porque um número tão grande de bits ?</title>
|
|
<para>Durante o desenvolvimento do IPv4, as pessoas pensaram que 32 bits seriam suficientes para o mundo. Olhando de volta, realmente 32 bits foram suficientes por bastante tempo. entretanto 32 bits não foram suficientes para prover endereços globais para todos os dispositivos de rede no futuro (ou será já no presente ?). Pense em telefones celulares, tablets, computadores virtuais, carros, GPS's, geladeiras, TV's, etc.</para>
|
|
<para>Assim, os desenvolvedores escolheram 128 bits, 4 vezes maior (no campo do tamanho do endereço) do que o IPv4.</para>
|
|
<para>Mas o tamanho utilizável é menor do que parece. Isto se deve por causa do esquema utilizado na definição do endereçamento: 64 bits são usados para identificar a interface. Os outros 64 bits são usados para o roteamento. Assumindo os níveis de agregação (/48, /32, ...), é possível que os endereços também se esgotem, mas esperamos que não em futuro próximo.</para>
|
|
<para>Para mais informações veja também<ulink url="http://www.faqs.org/rfcs/rfc1715.html">RFC 1715 / The H Ratio for Address Assignment Efficiency</ulink> e <ulink url="http://www.faqs.org/rfcs/rfc3194.html">RFC 3194 / The Host-Density Ratio for Address Assignment Efficiency</ulink>.</para></sect2><sect2>
|
|
<title>Endereços IPv6: porque um número tão pequeno de bits em um nova versão ?</title>
|
|
<para>Enquanto existam (possivelmente) algumas pessoas (só sei do Jim Fleming...) na internet que estejam pensando sobre o IPv8 ou IPv16, estes projetos estão muito longe de serem aceitos e implementados. Enquanto isso, 128 bits foi a melhor escolha levando em consideração o overhead do cabeçalho e o transporte de dados. Considere o MTU mínimo no IPv4 (576 octetos) e no IPv6 (1280 octetos), o tamanho do cabeçalho em iIPv4 é de 20 octetos (mínimo, e pode aumentar até 60 octetos com outras opções usadas) e no IPv6 é de 40 octetos (fixo). Isto representa 3,4% de overhead no IPv4 (com o tamanho mínimo) e 3,1 % do menor MTU em IPv6. O overhead é praticamente igual. Mais bits para endereço necessitariam cabeçalhos maiores e consequentemente mais overhead. Além disso, considere o tamanho máximo de uma MTU em links normais (como em Ethernet hoje): são 1500 octetos (em alguns casos especiais 9.000 octetos usando jumbo frames). Assim, não seria um projeto apropriado se 10% a 20% dos dados transportados para a camada 3 fosse usado para endereçamento e não para dados propriamente ditos.</para></sect2></sect1></chapter><chapter id='chapter-addresstypes' >
|
|
<title><!-- anchor id="chapter-addresstypes" -->Tipos de endereço</title>
|
|
<para>Como no IPv4, os endereços em IPv6 também podem ser divididos em duas partes - host e rede - com a utilização de máscaras de rede.</para>
|
|
<para>O IPv4 tem mostrado que algumas vezes é bom, se mais de um endereço IP puder ser configurado em uma interface, cada um deles com um propósito bem diferente (aliases, multicast). Então para continuar extensível, o IPv6 também suporta esta característica e permite que mais de 1 endereço seja configurado na mesma interface. Atualmente não existe qualquer limitação definida pela RFC, a não ser na implementação da pilha IPv6 (para evitar ataques DoS).</para>
|
|
<para>Ao usar este grande número de bits para endereço, o IPv6 define tipos de endereços baseado nos bits iniciais, os quais são, espera-se, não sejam quebrados no futuro, como acontece hoje com o IPv4 e as suas classes A, B e C.</para>
|
|
<para>Estes números de bits são separados para endereçar redes (os primeiros 64 bits) e para endereços de host (os últimos 64 bits), para facilitar a auto-configuração.</para><sect1>
|
|
<title>Endereços sem um prefixo especial</title>
|
|
<sect2>
|
|
<title>Endereço localhost</title>
|
|
<para>Este é um endereço especial para a interface de loopback, similar ao 127.0.0.1 no IPv4. Em IPv6, este endereço de localhost é:</para><screen>
|
|
<![CDATA[0000:0000:0000:0000:0000:0000:0000:0001
|
|
]]></screen><para>ou em sua forma comprimida:</para><screen>
|
|
<![CDATA[::1
|
|
]]></screen><para>Os pacotes com este endereço como origem ou destino nunca devem sair ou entrar em um host.</para></sect2><sect2>
|
|
<title>Endereços não especificados</title>
|
|
<para>Este é um endereço especial, como "any" ou "0.0.0.0". Em IPv6 é representado assim:</para><screen>
|
|
<![CDATA[0000:0000:0000:0000:0000:0000:0000:0000
|
|
]]></screen><para>ou:</para><screen>
|
|
<![CDATA[::
|
|
]]></screen><para>Este endereço é geralmente usado para especificação de portas (qualquer IPv6) ou tabelas de roteamento.</para>
|
|
<para>Nota: este endereço nunca pode ser usado como um endereço de destino.</para></sect2><sect2>
|
|
<title>Endereços IPv6 vinculados a endereços IPv4</title>
|
|
<para>Existem dois endereços que contém endereços IPv4.</para><sect3>
|
|
<title>IPv4-mapeado para IPv6</title>
|
|
<para>Um endereço IPv4-único para compatibilidade IPv6 é às vezes usado ou mostrado para sockets criados por um daemon IPv6, mas que só recebe conexões de endereços IPv4.</para>
|
|
<para>Estes endereços são definidos dentro de um prefixo especial, com o tamanho /96 (a.b.c.d é o endereço IPv4):</para><screen>
|
|
<![CDATA[0:0:0:0:0:ffff:a.b.c.d/96
|
|
]]></screen><para>ou em seu formato comprimido</para><screen>
|
|
<![CDATA[::ffff:a.b.c.d/96
|
|
]]></screen><para>por exemplo, o endereço IP 1.2.3.4 seria assim:</para><screen>
|
|
<![CDATA[::ffff:1.2.3.4
|
|
]]></screen></sect3><sect3>
|
|
<title>por exemplo, o endereço IP 1.2.3.4 seria assim:</title>
|
|
<para>Usado para tunelamento automático(<ulink url="http://www.faqs.org/rfcs/rfc2893.html">RFC 2893 / Transition Mechanisms for IPv6 Hosts and Routers</ulink>), o qual é substituído pelo <link linkend="tunneling-6to4.">6to4 tunneling</link>.</para><screen>
|
|
<![CDATA[0:0:0:0:0:0:a.b.c.d/96
|
|
]]></screen><para>ou em seu formato comprimido</para><screen>
|
|
<![CDATA[::a.b.c.d/96
|
|
]]></screen></sect3></sect2></sect1><sect1>
|
|
<title>Parte da rede, também conhecido como prefixo</title>
|
|
<para>Os designers definiram alguns tipos de endereços e deixaram muito disto para futuras definições quando novas necessidades surgirem. A <ulink url="http://www.faqs.org/rfcs/rfc4291.html">RFC 4291 / IP Version 6 Addressing Architecture</ulink> define o esquema utilizado no endereçamento atual.</para>
|
|
<para>Vamos agora dar uma olhada nos diferentes tipos de prefixos (e também em tipos de endereços):</para><sect2>
|
|
<title>Endereço tipo "link local"</title>
|
|
<para>Estes são endereços epeciais que são válidos somente no link de uma interface. Usando este endereço como destino, os pacotes nunca serão encaminhados a um router. Isto é usado para links de comunicação, tais como:</para><itemizedlist>
|
|
<listitem><para>Há alguém está aqui neste link ?</para></listitem><listitem><para>Há alguém aqui com endereços especiais (ex. procurando por um router) ?</para></listitem></itemizedlist><para>Eles começam com (onde "x" é qualquer caractere hexadecimal, normalmente "0")</para><screen>
|
|
<![CDATA[fe8x: <- atualmente é o único em uso
|
|
fe9x:
|
|
feax:
|
|
febx:
|
|
]]></screen><para>Um endereço com este prefixo é encontrado em cada interface com IPv6 habilitado após a auto-configuração stateless (a qual é normalmente sempre o caso).</para></sect2><sect2>
|
|
<title>Endereço tipo "site local"</title>
|
|
<para>Estes endereços são similares aos da<ulink url="http://www.faqs.org/rfcs/rfc1918.html">RFC 1918 / Address Allocation for Private Internets</ulink> em uso atualmente em IPv4, com a vantagem adicional de que qualquer pessoa que usar este tipo de endereço tem a capacidade de usar até 16 bits para a definição máxima de 65535 subredes. Comparável com o 10.0.0.0/8 do IPv4.</para>
|
|
<para>Outra vantagem: como é possível colocar mais de 1 endereço em uma interface com IPv6, voce pode configurar um endereço de "site local" junto com um endereço global.</para>
|
|
<para>Ele começa com:</para><screen>
|
|
<![CDATA[fecx: <- mais usado, mais comum
|
|
fedx:
|
|
feex:
|
|
fefx:
|
|
|
|
]]></screen><para>(onde o "x" é qualquer caractere hexadecimal, geralmente um "0")</para>
|
|
<para>Este tipo de endereço não deveria mais ser usado, <ulink url="http://www.faqs.org/rfcs/rfc3879.html">RFC 3879 / Deprecating Site Local Addresses</ulink>, mas para um teste em laboratório, estes endereços ainda continuam sendo uma boa escolha (IMHO - em minha humilde opinião).</para></sect2><sect2>
|
|
<title>Endereços locais Unicast IPv6</title>
|
|
<para>Por causa da definição original de endereços de site local não serem únicos, pode haver algum problema se duas redes já configuradas forem se conectar em um futuro próximo (overlap de subredes). Este e outros problemas foram os motivos para um novo tipo de endereço definido na<ulink url="http://www.faqs.org/rfcs/rfc4193.html">RFC 4193 / Unique Local IPv6 Unicast Addresses</ulink>.
|
|
</para>
|
|
<para>Ele começa com:</para><screen>
|
|
<![CDATA[fcxx:
|
|
fdxx: <- atualmente o único em uso
|
|
]]></screen><para>Uma parte do prefixo (40 bits) é gerada usando um algoritmo pseudo-randomico e é improvável que dois resultados gerados por este algoritmo sejam iguais.</para>
|
|
<para>Exemplo de um prefixo gerado por este algoritmo (veja em: <ulink url="http://www.goebel-consult.de/ipv6/createLULA">Goebel Consult / createLULA</ulink>):</para><screen>
|
|
<![CDATA[fd0f:8b72:ac90::/48
|
|
]]></screen></sect2><sect2>
|
|
<title>Endereço tipo Global "(Aggregatable) global unicast"</title>
|
|
<para>Atualmente, existe um tipo de endereço definido globalmente (o primeiro design, chamado "provider based") que foi jogado fora a alguns anos atrás<ulink url="http://www.faqs.org/rfcs/rfc1884.html">RFC 1884 / IP Version 6 Addressing Architecture [obsolete]</ulink>, e voce consegue encontrar em algumas versões do kernel do Linux.</para>
|
|
<para>Ele começa com (os caracteres "x" são hexadecimais)</para><screen>
|
|
<![CDATA[2xxx:
|
|
3xxx:
|
|
]]></screen><para>Nota: o prefixo "aggregatable" foi descartado nos atuais drafts. Há ainda alguns outros subtipos definidos. Veja abaixo:</para><sect3>
|
|
<title>Endereço de teste 6bone</title>
|
|
<para>Estes foram os primeiros endereços globais que foram definidos e usados. Eles começam com </para><screen>
|
|
<![CDATA[3ffe:
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[3ffe:ffff:100:f102::1
|
|
]]></screen><para>Um endereço de teste especial para o 6bone que nunca seria globalmente único começa com</para><screen>
|
|
<![CDATA[3ffe:ffff:
|
|
]]></screen><para>e a maioria deles é mostrado em exemplos antigos. A razão para isso é, se endereços reais são mostrados, seria possível alguém copiar e colar estes endereços de arquivos de configuração antigos, o que inadvertidamente causaria um erro de duplicação de endereço de um endereço global único. Isto poderia causar sérios problemas para o host original (como nunca receber as respostas de requisições feitas). </para>
|
|
<para>Como o IPv6 agora já está em produção, este prefixo não é mais delegado e ele foi removido do processo de roteamento (veja<ulink url="http://www.faqs.org/rfcs/rfc3701.html">RFC 3701 / 6bone Phaseout</ulink> para mais detalhes).</para></sect3><sect3>
|
|
<title>Endereços 6to4</title>
|
|
<para>Estes endereços, feitos para um mecanismo de túnel especial [<ulink url="http://www.faqs.org/rfcs/rfc3056.html">RFC 3056 / Connection of IPv6 Domains via IPv4 Clouds</ulink> e <ulink url="http://www.faqs.org/rfcs/rfc2893.html">RFC 2893 / Transition Mechanisms for IPv6 Hosts and Routers</ulink>],utilizam um endereço IPv4 já fornecido e a sua possível subnet, e começam com</para><screen>
|
|
<![CDATA[2002:
|
|
]]></screen><para>Por exemplo, este endereço 192.168.1.1/5 ficaria:</para><screen>
|
|
<![CDATA[2002:c0a8:0101:5::1
|
|
]]></screen><para>Um pequeno comando em shell poderia ajudar voce a gerar este endereço, baseado em um endereço IPv4 fornecido:</para><screen>
|
|
<![CDATA[ipv4="1.2.3.4"; sla="5"; printf "2002:%02x%02x:%02x%02x:%04x::1" `echo $ipv4
|
|
¬ | tr "." " "` $sla
|
|
]]></screen><para>Veja também <link linkend="tunneling-6to4.">tunneling using 6to4</link> e <link linkend="information-joinipv6-6to4-tunneling">information about 6to4 relay routers</link>.</para></sect3><sect3>
|
|
<title>Designado pelo provedor para roteamento hierárquico</title>
|
|
<para>Este endereço é delegado pelo ISP e começa com</para><screen>
|
|
<![CDATA[2001:
|
|
]]></screen><para>Prefixos de ISP's maiores (ou AS's) são delegados pelos <link linkend="information-majorregionregistries">local registries</link> e tem atualmente um tamanho de prefixo /32.</para>
|
|
<para>Qualquer outro ISP/empresa pode solicitar um prefixo de tamanho /48, mas isto depende da política de distribuição de endereços dos registros locais de cada país ou região.</para></sect3><sect3>
|
|
<title>Endereços reservados para exemplos e documentação</title>
|
|
<para>Atualmente, dois blocos de endereço estão reservados para exemplos e documentação. Veja a<ulink url="http://www.faqs.org/rfcs/rfc3849.html">RFC 3849 / IPv6 Address Prefix Reserved for Documentation</ulink>:</para><screen>
|
|
<![CDATA[3fff:ffff::/32
|
|
2001:0DB8::/32 EXAMPLENET-WF
|
|
]]></screen><para>Estes endereços devem ser filtrados baseados no endereço de origem e NÃO devem ser roteados em roteadores de borda em direção à internet, se possível.</para></sect3></sect2><sect2>
|
|
<title>Endereços Multicast</title>
|
|
<para>Endereços Multicast são usados por serviços específicos.</para>
|
|
<para>Eles sempre começam com (xx é o valor de escopo)</para><screen>
|
|
<![CDATA[ffxy:
|
|
]]></screen><para>Existem divisões entre escopo e tipo:</para><sect3>
|
|
<title>Escopo Multicast</title>
|
|
<para>O escopo Multicast é um parametro usado para especificar a distancia máxima que um pacote multicast pode "viajar" a partir de sua origem.</para>
|
|
<para>Atualmente, os seguintes escopos (ou regiões) estão definidos:</para><itemizedlist>
|
|
<listitem><para>ffx1: nó local, os pacotes nunca deixam o nó.</para></listitem><listitem><para>ffx2: link-local, os pacotes nunca são encaminhados pelos routers, assim eles nunca deixam o link especificado.</para></listitem><listitem><para>ffx5: site-local, os pacotes nunca deixam o site.</para></listitem><listitem><para>ffx8: organization-local, os pacotes nunca deixam a organização (não é tão fácil de implementar, mas deve ser coberto pelo protocolo de roteamento).</para></listitem><listitem><para>ffxe: escopo global.</para></listitem><listitem><para>outros são reservados</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Tipos Multicast</title>
|
|
<para>Já existem muitos tipos definidos/reservados (veja<ulink url="http://www.faqs.org/rfcs/rfc4291.html">RFC 4291 / IP Version 6 Addressing Architecture</ulink> para mais detalhes). Alguns exemplos são:</para><itemizedlist>
|
|
<listitem><para>Endereço All Nodes: ID = 1h, endereça todos os host no nó local (ff01:0:0:0:0:0:0:1) ou no link conectado (ff02:0:0:0:0:0:0:1).</para></listitem><listitem><para>Endereço All Routers: ID = 2h, endereça tosos os routers no nó local (ff01:0:0:0:0:0:0:2), no link conectado (ff02:0:0:0:0:0:0:2), ou no site local (ff05:0:0:0:0:0:0:2)</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Endereço multicast solicitado nó link-local</title>
|
|
<para>Um endereço de multicast especial que é usado como endereço de destino para a descoberta da vizinhança , uma vez que no IPv6 não há ARP, como existe no IPv4.</para>
|
|
<para>Um exemplo deste endereço se parece com</para><screen>
|
|
<![CDATA[ff02::1:ff00:1234
|
|
]]></screen><para>Os prefixos usados mostram que este é um endereço multicast link-local. O sufixo é gerado a partir do endereço de destino. Neste exemplo, um pacote deveria ser enviado ao endereço "fe80::1234", mas a parte de rede não conhece o MAC atual deste destino. Ele então substitui os 104 bits mais altos com "ff02:0:0:0:0:1:ff00::/104" e deixa os menores 24 bits intocados. Este endereço então é agora usado no link para achar o nó correspondente que tem que enviar uma resposta contendo o endereço MAC usado na camada 2.</para></sect3></sect2><sect2>
|
|
<title>Endereços Anycast</title>
|
|
<para>Endereços Anycast são endereços especiais e eles são usados para muitas coisas, como o servidor DNS ou DHCP mais próximo, e outras coisas. Estes endereços são obtidos do espaço de endereçamento Unicast (aggregatable global ou site-local). O mecanismo anycast (do ponto de vista do cliente) será tratado pelos protocolos de roteamento dinamico.</para>
|
|
<para>Nota: Endereços anycast não podem ser usados como endereços de origem, pois eles se aplicam somente a endereços de destino.</para><sect3>
|
|
<title>Endereços Anycast Subnet-router</title>
|
|
<para>Um exemplo simples para um endereço unicast é o anycast subnet-router. Assumindo que um nó tem os seguintes endereços globais IPv6 configurados:</para><screen>
|
|
<![CDATA[2001:db8:100:f101:210:a4ff:fee3:9566/64 <- Node's address
|
|
]]></screen><para>O endereço unicast subnet-router será criado removendo o sufixo (os 64 bits menos significantes) completamente:</para><screen>
|
|
<![CDATA[2001:db8:100:f101::/64 <- subnet-router anycast address
|
|
]]></screen></sect3></sect2></sect1><sect1>
|
|
<title>Tipos de endereço (parte de host)</title>
|
|
<para>Para a auto-configuração e questões de mobilidade, foi decidido usar os 64 bits de menor significado como a parte de host do endereço na maioria dos tipos de endereços atuais. Desta forma, cada subnet pode suportar uma grande quantidade de endereços.</para>
|
|
<para>A parte de host pode ser verificada de maneira distinta:</para><sect2>
|
|
<title>Computado automaticamente (também conhecido como stateless)</title>
|
|
<para>Com a auto-configuração, a parte host do endereço é feita através da conversão do endereço MAC da interface (se disponível), através do método EUI-64, para um único endereço IPv6. Se nenhum MAC estiver disponível para este dispositivo (isto acontece bastante em dispositivos virtuais), outra coisa (como o endereço IPv4 ou o MAC da interface física) é usada no lugar.</para>
|
|
<para>Exemplo: uma placa de rede tem o seguinte endereço MAC (48 bit):</para><screen>
|
|
<![CDATA[00:10:a4:01:23:45
|
|
]]></screen><para>Isto poderia ser expandido de acordo com o tutorial do IEEE -<ulink url="http://standards.ieee.org/regauth/oui/tutorials/EUI64.html">IEEE-Tutorial EUI-64</ulink> resultando no endereço abaixo:</para><screen>
|
|
<![CDATA[0210:a4ff:fe01:2345
|
|
]]></screen><para>Com um prefixo já fornecido, o resultado é o endereço IPv6 mostrado abaixo:</para><screen>
|
|
<![CDATA[2001:0db8:0100:f101:0210:a4ff:fe01:2345
|
|
]]></screen><sect3>
|
|
<title>Problema de privacidade com os endereços automaticamente computados e uma solução</title>
|
|
<para>Por causa da parte host do endereço "automaticamente computado" ser único, (exceto quando um fabricante de placas de rede usa o mesmo MAC em mais de um NIC), o rastreamento de um cliente é possível quando não há um proxy de qualquer tipo.</para>
|
|
<para>Este é um problema já conhecido, e a sua solução foi definida através da extensão de privacidade, definida na<ulink url="http://www.faqs.org/rfcs/rfc3041.html">RFC 3041 / Privacy Extensions for Stateless Address Autoconfiguration in IPv6</ulink> (já existe também um novo draft disponível: <ulink url="http://www.ietf.org/ids.by.wg/ipv6.html">draft-ietf-ipv6-privacy-addrs-v2-*</ulink>). Usando um valor estático e um valor randomico, um novo sufixo é gerado de tempos em tempos.</para>
|
|
<para>Nota: isto é somente interessante em conexões finais de clientes, e não é realmente útil para servidores já conhecidos.</para></sect3></sect2><sect2>
|
|
<title>Definido manualmente</title>
|
|
<para>Para servidores, provavelmente é mais fácil se lembrar de endereços mais simples, mas isto também pode ser resolvido. Em IPv6, é possível configurar um endereço adicional para uma interface. Veja o exemplo:</para><screen>
|
|
<![CDATA[2001:0db8:100:f101::1
|
|
]]></screen><para>Para sufixos manuais como o ::1 mostrado acima, é necessário que o sétimo bit mais significativo seja definido como 0 (o bit universal/local do identificador gerado automaticamente). Existe também uma outra combinação de bits (não utilizada) que é reservada para endereços unicast.</para></sect2></sect1><sect1>
|
|
<title>Tamanho de prefixos para roteamento</title>
|
|
<para>Na fase inicial de projeto e design do IPv6, foi planejada a utilização hierárquica de roteamento para reduzir o tamanho das tabelas de roteamento ao menor valor possível. As razões por trás desta abordagem foram o grande número de rotas nos grandes roteadores de borda (cerca de 300.000 em janeiro de 2011), reduzindo a necessidade de memória nos routers e a capacidade de se utilizar chips ASIC (Application Specified Integrated Circuit) para manipular esta tabela, aumentando a velocidade (uma tabela menor aumenta a velocidade).
|
|
</para>
|
|
<para>A visão de hoje é que o roteamento será mais hierárquico para redes com somente 1 ISP. Em redes com mais de 1 conexão, isto não é possível, e está sujeita a sistemas multi-homed (informações de multi-homing:<ulink url="http://www.ietf.org/ids.by.wg/multi6.html">drafts-ietf-multi6-*</ulink>,<ulink url="http://arneill-py.sacramento.ca.us/ipv6mh/">IPv6 Multihoming Solutions</ulink>).</para><sect2>
|
|
<title>Tamanho de prefixo (também conhecido como "netmasks")</title>
|
|
<para>Semelhante ao IPv4, a rede roteável entra em cena. Por causa da notação do padrão de máscara de rede (128 bits) não parecer bom, os designers utilizaram o mesmo método utilizado no IPv4, chamado Classless Inter Domain Routing (CIDR,<ulink url="http://www.faqs.org/rfcs/rfc1519.html">RFC 1519 / Classless Inter-Domain Routing</ulink>)o qual especifica o número de bits do endereço IP que será usado para o roteamento. E ele também é chamado notação "slash".</para>
|
|
<para>Exemplo:</para><screen>
|
|
<![CDATA[2001:0db8:100:1:2:3:4:5/48
|
|
]]></screen><para>Esta notação pode ser expandida:</para><itemizedlist>
|
|
<listitem><para>Rede:</para></listitem></itemizedlist><screen>
|
|
<![CDATA[2001:0db8:0100:0000:0000:0000:0000:0000
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>Máscara de rede:</para></listitem></itemizedlist><screen>
|
|
<![CDATA[ffff:ffff:ffff:0000:0000:0000:0000:0000
|
|
]]></screen></sect2><sect2>
|
|
<title>Encontrando uma rota</title>
|
|
<para>Em circunstancias normais, (sem QoS), a procura em uma tabela de roteamento resulta na rota mais adequada com o número mais significante de bits do endereço. Em outras palavras, a rota com o maior prefixo tem a preferencia.</para>
|
|
<para>Por exemplo, se uma tabela de rotas mostra as seguintes entradas (a lista é parcial):</para><screen>
|
|
<![CDATA[2001:0db8:100::/48 :: U 1 0 0 sit1
|
|
2000::/3 ::192.88.99.1 UG 1 0 0 tun6to4
|
|
]]></screen><para>Os endereços de destino mostrados dos pacotes IPv6 serão roteados através das interfaces mostradas</para><screen>
|
|
<![CDATA[2001:0db8:100:1:2:3:4:5/48 -> routed through device sit1
|
|
2001:0db8:200:1:2:3:4:5/48 -> routed through device tun6to4
|
|
]]></screen></sect2></sect1></chapter><chapter id='chapter-systemcheck' >
|
|
<title><!-- anchor id="chapter-systemcheck" -->Verificação do sistema para IPv6</title>
|
|
<para>Antes de voce começar a utilizar o IPv6 em uma máquina com Linux, é necessário testar para saber se seu sistema tem o suporte ao protocolo. Talvez voce tenha que fazer algum ajuste para prepara-lo antes de começar a usar.</para><sect1 id='systemcheck-kernel' >
|
|
<title><!-- anchor id="systemcheck-kernel" -->Kernel com IPv6</title>
|
|
<para>As distribuições mais novas de Linux já tem o kernel com suporte ao IPv6, e este suporte geralmente acontece com a compilação em módulos, mas é possível que estes módulos sejam carregados no momento do boot.</para>
|
|
<para>Nota: voce não deve usar o kernel da série 2.2, porque ele já não é mais atualizado. A série 2.4 também já não tem todas as atualizações de acordo com as últimas RFC's, então recomendamos utilizar um kernel da série 2.6.</para><sect2>
|
|
<title>Verificação do suporte a IPv6 no kernel utilizado</title>
|
|
<para>Para verificar se o seu kernel já está com o suporte a IPv6 habilitado, de uma olhada nos arquivos do diretório /proc. A seguinte entrada deve existir:</para><screen>
|
|
<![CDATA[/proc/net/if_inet6
|
|
]]></screen><para>Para quem gosta de scripts, é possível usar estes comandos:</para><screen>
|
|
<![CDATA[# test -f /proc/net/if_inet6 && echo "Running kernel is IPv6 ready"
|
|
]]></screen><para>Se este teste falhar, provavelmente seu sistema não está com os módulos de IPv6 carregados.</para></sect2><sect2>
|
|
<title>Tentando carregar os módulos para o IPv6</title>
|
|
<para>Voce pode tentar carregar os módulos do IPv6 com o comando</para><screen>
|
|
<![CDATA[# modprobe ipv6
|
|
]]></screen><para>Se a carga ocorreu sem problemas, verifique o status com estes comandos:</para><screen>
|
|
<![CDATA[# lsmod |grep -w 'ipv6' && echo "IPv6 module successfully loaded"
|
|
]]></screen><para>Depois disso, rode os comandos novamente do item 4.1.1 para ter certeza de que está tudo certo.</para>
|
|
<para>Note: a remoção do módulo (rmmod) não é suportada, e recomendo não utilizar, pois pode haver alguma instabilidade no sistema.</para><sect3>
|
|
<title>Carga automática do módulo</title>
|
|
<para>É possível automatizar a carga do módulo IPv6 conforme seja necessário. Para isto, basta adicionar a seguinte entrada no arquivo de configuração (/etc/modules.conf ou /etc/conf.modules):</para><screen>
|
|
<![CDATA[alias net-pf-10 ipv6 # automatically load IPv6 module on demand
|
|
]]></screen><para>Também é possível desabilitar a carga do módulo automaticamente usando a seguinte entrada:</para><screen>
|
|
<![CDATA[alias net-pf-10 off # disable automatically load of IPv6 module on demand
|
|
]]></screen><para>Nota: no kernel da série 2.6, o mecanismo carregador de módulos mudou, e o novo arquivo de configuração é o /etc/modprobe.conf.</para></sect3></sect2><sect2>
|
|
<title>Compilando o kernel 2.6 para suportar o IPv6</title>
|
|
<para>Se os dois resultados acima foram negativos, e o seu kernel não tem suporte para o IPv6, então voce tem algumas coisas a fazer:</para><itemizedlist>
|
|
<listitem><para>Atualizar a sua distribuição para uma que suporte o IPv6 (recomendado para os novatos)</para></listitem><listitem><para>Compilar um novo kernel (fácil, se voce souber quais opções são necessárias)</para></listitem><listitem><para>Recompilar os fontes do kernel dado pela sua distribuição (nem sempre tão fácil)</para></listitem><listitem><para>Compilar um kernel com as extensões USAGI</para></listitem></itemizedlist><para>Se voce decidir compilar um kernel, voce precisa ter alguma experiencia nisso e também ler o<ulink url="http://www.tldp.org/HOWTO/Kernel-HOWTO.html">Linux Kernel HOWTO</ulink>.</para>
|
|
<para>Uma comparação entre o kernel vanilla e as extensões USAGI está disponível aqui<ulink url="http://www.bieringer.de/linux/IPv6/status/IPv6+Linux-status-kernel.html">IPv6+Linux-Status-Kernel</ulink>.</para><sect3>
|
|
<title>Compilando um kernel vanilla</title>
|
|
<para>Mais detalhes e dicas sobre a compilação de um kernel com suporte a IPv6 pode ser encontrado em<ulink url="http://www.bieringer.de/linux/IPv6/IPv6-HOWTO/IPv6-HOWTO-2.html#kernel">IPv6-HOWTO-2#kernel</ulink>.</para>
|
|
<para>Nota: voce deve usar, sempre que possível, um kernel da séria 2.6, uma vez que o suporte ao IPv6 na série 2.4 já não teve as últimas atualizações definidas nas RFC's, e a série 2.2 não tem mais o suporte atualizado ou mesmo mantido por alguém.</para></sect3><sect3>
|
|
<title>Compilando um kernel com as extensões USAGI</title>
|
|
<para>Para a família vanilla de kernel, recomendado somente para usuários avançados, os quais já estão familiarizados com o IPv6 e com compilação de kernel. Veja também<ulink url="http://www.linux-ipv6.org/faq.html">USAGI project / FAQ</ulink> e <ulink url="http://www.deepspace6.net/docs/best_ipv6_support.html">Obtaining the best IPv6 support with Linux (Article)</ulink> (<ulink url="http://mirrors.bieringer.de/www.deepspace6.net/docs/best_ipv6_support.html">Mirror</ulink>).</para></sect3></sect2><sect2>
|
|
<title>Dispositivos de rede com suporte a IPv6</title>
|
|
<para>Nem todos os dispositivos de rede tem suporte (ou terão) para transportar pacotes IPv6. Um status atualizado pode ser encontrado em<ulink url="http://www.bieringer.de/linux/IPv6/status/IPv6+Linux-status-kernel.html#transport">IPv6+Linux-status-kernel.html#transport</ulink>.</para>
|
|
<para>O maior problema disso é causado na implementação da camada de rede, já que o pacote IPv6 não é reconhecido pelo cabeçalho IP (6 ao invés de 4). Ele é reconhecido pelo protocolo da camada 2 (transporte). Da mesma maneira, qualquer protocolo da camada 2 que não usa numeração de protocolo não conseguirá encaminhar os pacotes IPv6.</para>
|
|
<para>Nota: mesmo assim o pacote ainda é transportado pelo link, mas no lado receptor, o encaminhamento não ocorrerá (voce pode verificar isso com a utilização do tcpdump).</para><sect3>
|
|
<title>Estes links nunca suportarão IPv6</title>
|
|
<itemizedlist>
|
|
<listitem><para>Serial Line IP (SLIP, <ulink url="http://www.faqs.org/rfcs/rfc1055.html">RFC 1055 / SLIP</ulink>), deveria ser chamado de SLIPv4, nome do dispositivo: slX</para></listitem><listitem><para>Parallel Line IP (PLIP), que nem o SLIP, nome do dispositivo: plipX</para></listitem><listitem><para>ISDN com encapsulamento rawip, nome do dispositivo: isdnX</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Este link atualmente não suporta IPv6</title>
|
|
<itemizedlist>
|
|
<listitem><para>ISDN com encapsulamento syncppp, nome do dispositivo: ipppX (problema de projeto do ipppd, que deveria ter sido resolvido com um PPP mais generalista na série de kernel 2.5)</para></listitem></itemizedlist></sect3></sect2></sect1><sect1>
|
|
<title>Ferramentas de configuração de rede que suportam IPv6</title>
|
|
<para>Voce não irá muito longe, se voce estiver rodando um kernel com suporte a IPv6, mas não tiver ferramentas que o ajudem a configurar o IPv6. Existem vários pacotes para ajudá-lo neste trabalho.</para><sect2>
|
|
<title>Pacote net-tools</title>
|
|
<para>O pacote net-tools inclui algumas ferramentas como ifconfig e route, que ajudam a configurar uma interface em IPv6. Veja a saída dos comandos ifconfig -? ou route -?, se eles mostrarem algo parecido com IPv6 ou inet6, então a ferramenta tem suporte a IPv6.</para>
|
|
<para>Novamente, para quem gosta de scripts:</para><screen>
|
|
<![CDATA[# /sbin/ifconfig -? 2>& 1|grep -qw 'inet6' && echo "utility 'ifconfig' is
|
|
¬ IPv6-ready"
|
|
]]></screen><para>Verificando o route:</para><screen>
|
|
<![CDATA[# /sbin/route -? 2>& 1|grep -qw 'inet6' && echo "utility 'route' is IPv6-ready"
|
|
]]></screen></sect2><sect2>
|
|
<title>Pacote iproute</title>
|
|
<para>Alexey N. Kuznetsov (atual mantenedor do código de rede no Linux) criou um grupo de ferramentas que configuram redes através do dispositivo netlink. O uso destas ferramentas dá mais funcionalidades do que as do pacote net-tools, mas elas não estão muito bem documentadas e não são para os fracos de coração.</para><screen>
|
|
<![CDATA[# /sbin/ip 2>&1 |grep -qw 'inet6' && echo "utility 'ip' is IPv6-ready"
|
|
]]></screen><para>Se o programa /sbin/ip não for encontrado em seu sistema, então eu recomendo que voce instale o pacote iproute.</para><itemizedlist>
|
|
<listitem><para>Voce pode pega-lo através de sua distribuição (se houver)</para></listitem><listitem><para>Voce pode procurar o pacote RPM em<ulink url="http://rpmfind.net/linux/rpm2html/search.php?query=iproute">RPMfind/iproute</ulink> (em alguns casos é recomendada a reconstrução do SRPMS)</para></listitem></itemizedlist></sect2></sect1><sect1>
|
|
<title>Programas de teste e debug IPv6</title>
|
|
<para>Após a preparação do seu sistema para o IPv6, está na hora de usar este protocolo para a sua comunicação com outros sistemas. Primeiro voce deve aprender como analisar os pacotes através de um sniffer. Isto é altamente recomendável para que qualquer debug ou troubleshooting seja feito de maneira rápida.</para><sect2 id='program-ping6.' >
|
|
<title><!-- anchor id="program-ping6." -->Ping IPv6</title>
|
|
<para>Este programa está incluído no pacote iputils. Seu objetivo é enviar e testar o transporte de pacotes ICMPv6 echo-request packets e aguardar pelos pacotes ICMPv6 echo-reply.</para>
|
|
<para>Uso</para><screen>
|
|
<![CDATA[# ping6 <hostwithipv6address>
|
|
# ping6 <ipv6address>
|
|
# ping6 [-I <device>] <link-local-ipv6address>
|
|
]]></screen><para>Exemplo</para><screen>
|
|
<![CDATA[# ping6 -c 1 ::1
|
|
PING ::1(::1) from ::1 : 56 data bytes
|
|
64 bytes from ::1: icmp_seq=0 hops=64 time=292 usec
|
|
|
|
--- ::1 ping statistics ---
|
|
1 packets transmitted, 1 packets received, 0% packet loss
|
|
round-trip min/avg/max/mdev = 0.292/0.292/0.292/0.000 ms
|
|
]]></screen><para>Dica: o comando ping6 precisa de acesso direto ao socket e por isso precisa de permissão de root. Então se usuários comuns (não-root) tentarem usar o ping6 e não obtiverem sucesso, podem ser um dos dois problemas:</para><orderedlist>
|
|
<listitem><para>ping6 não está na variável PATH deste usuário (provavelmente porque o ping6 é geralmente localizado em /usr/sbin, e adicionar este diretório ao path do usuário comum não é muito recomendado)</para></listitem><listitem><para>ping6 não executa corretamente, geralmente porque faltam permissões de root. A sugestão neste caso é executar o comando chmod u+s /usr/sbin/ping6 para permitir o uso do programa.</para></listitem></orderedlist><sect3>
|
|
<title>Especificando a interface para o ping em IPv6</title>
|
|
<para>Ao usar um endereço link-local para pingar alguém em IPv6 o kernel pode não reconhecer ou saber através de qual interface (física ou virtual) o pacote deve ser enviado. Por causa disso, a seguinte mensagem de erro deve aparecer:</para><screen>
|
|
<![CDATA[# ping6 fe80::212:34ff:fe12:3456
|
|
connect: Invalid argument
|
|
]]></screen><para>Neste caso, voce precisa especificar qual interface deve ser usada para enviar o pacote, como mostrado abaixo:</para><screen>
|
|
<![CDATA[# ping6 -I eth0 -c 1 fe80::2e0:18ff:fe90:9205
|
|
PING fe80::212:23ff:fe12:3456(fe80::212:23ff:fe12:3456) from
|
|
¬ fe80::212:34ff:fe12:3478 eth0: 56 data bytes
|
|
64 bytes from fe80::212:23ff:fe12:3456: icmp_seq=0 hops=64 time=445 usec
|
|
|
|
--- fe80::2e0:18ff:fe90:9205 ping statistics ---
|
|
1 packets transmitted, 1 packets received, 0% packet loss round-trip
|
|
¬ min/avg/max/mdev = 0.445/0.445/0.445/0.000 ms
|
|
]]></screen></sect3><sect3>
|
|
<title>Ping6 para endereços multicast</title>
|
|
<para>Um mecanismo interessante para detectar hosts com endereço IPv6 é pingar o endereço all-node multicast:</para><screen>
|
|
<![CDATA[# ping6 -I eth0 ff02::1
|
|
PING ff02::1(ff02::1) from fe80:::2ab:cdff:feef:0123 eth0: 56 data bytes
|
|
64 bytes from ::1: icmp_seq=1 ttl=64 time=0.104 ms
|
|
64 bytes from fe80::212:34ff:fe12:3450: icmp_seq=1 ttl=64 time=0.549 ms (DUP!)
|
|
]]></screen><para>Diferente do IPv4, onde as respostas ao ping para endereços de broadcast podem ser desabilitadas, em IPv6 este comportamento não pode ser desabilitado, exceto pela utilização de um firewall IPv6 local.</para></sect3></sect2><sect2 id='program-traceroute6.' >
|
|
<title><!-- anchor id="program-traceroute6." -->Traceroute6 IPv6</title>
|
|
<para>Este programa geralmente está incluso no pacote iputils. É um programa conhecido, similar ao do IPv4. Veja o exemplo:</para><screen>
|
|
<![CDATA[# traceroute6 www.6bone.net
|
|
traceroute to 6bone.net (3ffe:b00:c18:1::10) from 2001:0db8:0000:f101::2, 30
|
|
¬ hops max, 16 byte packets
|
|
1 localipv6gateway (2001:0db8:0000:f101::1) 1.354 ms 1.566 ms 0.407 ms
|
|
2 swi6T1-T0.ipv6.switch.ch (3ffe:2000:0:400::1) 90.431 ms 91.956 ms 92.377 ms
|
|
3 3ffe:2000:0:1::132 (3ffe:2000:0:1::132) 118.945 ms 107.982 ms 114.557 ms
|
|
4 3ffe:c00:8023:2b::2 (3ffe:c00:8023:2b::2) 968.468 ms 993.392 ms 973.441 ms
|
|
5 3ffe:2e00:e:c::3 (3ffe:2e00:e:c::3) 507.784 ms 505.549 ms 508.928 ms
|
|
6 www.6bone.net (3ffe:b00:c18:1::10) 1265.85 ms * 1304.74 ms
|
|
]]></screen><para>Nota: diferente das versões mais atuais co traceroute do IPv4, que usa pacotes ICMPv4 echo-request e pacotes UDP (default), o traceroute do IPv6 só é capaz de enviar pacotes UDP. Como voce já deve saber, pacotes ICMP echo-request são mais aceitos pelos firewalls e listas de acesso (ACL) de routers do que pacotes UDP.</para></sect2><sect2 id='program-tracepath6.' >
|
|
<title><!-- anchor id="program-tracepath6." -->Tracepath6 IPv6</title>
|
|
<para>Este programa costuma estar incluído no pacote iputils. É um programa similar ao traceroute6 e ele traça o caminho para um endereço dado, descobrindo o MTU ao longo deste caminho. Veja o exemplo abaixo:</para><screen>
|
|
<![CDATA[# tracepath6 www.6bone.net
|
|
1?: [LOCALHOST] pmtu 1480
|
|
1: 3ffe:401::2c0:33ff:fe02:14 150.705ms
|
|
2: 3ffe:b00:c18::5 267.864ms
|
|
3: 3ffe:b00:c18::5 asymm 2 266.145ms pmtu 1280
|
|
3: 3ffe:3900:5::2 asymm 4 346.632ms
|
|
4: 3ffe:28ff:ffff:4::3 asymm 5 365.965ms
|
|
5: 3ffe:1cff:0:ee::2 asymm 4 534.704ms
|
|
6: 3ffe:3800::1:1 asymm 4 578.126ms !N
|
|
Resume: pmtu 1280
|
|
]]></screen></sect2><sect2 id='program-tcpdump' >
|
|
<title><!-- anchor id="program-tcpdump" -->Tcpdump IPv6</title>
|
|
<para>No Linux, o tcpdump é a maior ferramenta para a captura de pacotes. Abaixo estão alguns exemplos. O suporte ao IPv6 já está adicionado nas versões 3.6 ou superiores deste programa. </para>
|
|
<para>O tcpdump usa diversas expressões e argumentos para realizar a filtragem de pacotes para minimizar o volume de informações apresentado:</para><itemizedlist>
|
|
<listitem><para>icmp6: filtra o tráfego ICMPv6 nativo</para></listitem><listitem><para>ip6: filtra o tráfego nativo IPv6 (incluindo ICMPv6)</para></listitem><listitem><para>proto ipv6: filtra o tráfego IPv6 tunelado em IPv4 (IPv6-in-IPv4)</para></listitem><listitem><para>not port ssh: para evitar mostrar os pacotes se voce estiver usando uma conexão SSH</para></listitem></itemizedlist><para>Além disso, algumas opções são muito úteis para obter mais informações de cada pacote, bem interessantes para pacotes ICMPv6:</para><itemizedlist>
|
|
<listitem><para>"-s 512": aumenta o tamanho do pacote capturado para 512 bytes. Se for usada a opção "-s 0" o pacote é capturado por inteiro</para></listitem><listitem><para>"-s 512": aumenta o tamanho do pacote capturado para 512 bytes. Se for usada a opção "-s 0" o pacote é capturado por inteiro</para></listitem><listitem><para>"-n": não resolve os endereços para nomes, muito útil quando o DNS reverso não está funcionando corretamente</para></listitem></itemizedlist><sect3>
|
|
<title>Ping IPv6 para 2001:0db8:100:f101::1 nativo sobre um link local</title>
|
|
<screen>
|
|
<![CDATA[# tcpdump -t -n -i eth0 -s 512 -vv ip6 or proto ipv6
|
|
tcpdump: listening on eth0
|
|
2001:0db8:100:f101:2e0:18ff:fe90:9205 > 2001:0db8:100:f101::1: icmp6: echo
|
|
¬ request (len 64, hlim 64)
|
|
2001:0db8:100:f101::1 > 2001:0db8:100:f101:2e0:18ff:fe90:9205: icmp6: echo
|
|
¬ reply (len 64, hlim 64)
|
|
]]></screen></sect3><sect3>
|
|
<title>Ping IPv6 para 2001:0db8:100::1 roteado através de um túnel IPv6-in-IPv4</title>
|
|
<para>Os endereços IPv4 1.2.3.4 e 5.6.7.8 são os tunnel endpoints (todos os endereços são exemplos)</para><screen>
|
|
<![CDATA[# tcpdump -t -n -i ppp0 -s 512 -vv ip6 or proto ipv6
|
|
tcpdump: listening on ppp0
|
|
1.2.3.4 > 5.6.7.8: 2002:ffff:f5f8::1 > 2001:0db8:100::1: icmp6: echo request
|
|
¬ (len 64, hlim 64) (DF) (ttl 64, id 0, len 124)
|
|
5.6.7.8 > 1.2.3.4: 2001:0db8:100::1 > 2002:ffff:f5f8::1: icmp6: echo reply (len
|
|
¬ 64, hlim 61) (ttl 23, id 29887, len 124)
|
|
1.2.3.4 > 5.6.7.8: 2002:ffff:f5f8::1 > 2001:0db8:100::1: icmp6: echo request
|
|
¬ (len 64, hlim 64) (DF) (ttl 64, id 0, len 124)
|
|
5.6.7.8 > 1.2.3.4: 2001:0db8:100::1 > 2002:ffff:f5f8::1: icmp6: echo reply (len
|
|
¬ 64, hlim 61) (ttl 23, id 29919, len 124)
|
|
]]></screen></sect3></sect2></sect1><sect1>
|
|
<title>Programas com suporte a IPv6</title>
|
|
<para>As distribuições Linux atuais já contém a maioria dos serviços Cliente e Servidor em IPv6. Veja aqui em<ulink url="http://www.bieringer.de/linux/IPv6/status/IPv6+Linux-status-distributions.html">IPv6+Linux-Status-Distribution</ulink>. Se ainda não estiver incluído, voce pode verificar em <ulink url="http://www.bieringer.de/linux/IPv6/status/IPv6+Linux-status-apps.html">IPv6 & Linux - Current Status - Applications</ulink> se o programa já está portado para o IPv6 e pronto para o Linux. Para os programas mais comuns existem dicas disponíveis em<ulink url="http://www.bieringer.de/linux/IPv6/IPv6-HOWTO/IPv6-HOWTO-3.html">IPv6 & Linux - HowTo - Part 3</ulink> e <ulink url="http://www.bieringer.de/linux/IPv6/IPv6-HOWTO/IPv6-HOWTO-4.html">IPv6 & Linux - HowTo - Part 4</ulink>.</para></sect1><sect1>
|
|
<title>Programas cliente com suporte a IPv6</title>
|
|
<para>Para executar os testes abaixo, é necessário que seu sistema seja um host IPv6 e os exemplos mostrados podem ser feitos se voce tiver acesso ao 6bone.</para><sect2>
|
|
<title>Verificando a resolução DNS para endereços IPv6</title>
|
|
<para>Por causa dos updates de segurança aplicados nos últimos anos, o Servidor DNS que roda a versão mais atual já tem a capacidade de entender os endereços IPv6 tipo AAAA (o named A6 mais novo ainda não é usado porque só no BIND9 o suporte aos root domais ARPA IP6 está em uso). Um teste bem simples para ver o sistema resolver endereços IPv6 é:</para><screen>
|
|
<![CDATA[# host -t AAAA www.join.uni-muenster.de
|
|
]]></screen><para>e a resposta deve ser alguma coisa parecida com isso:</para><screen>
|
|
<![CDATA[www.join.uni-muenster.de. is an alias for tolot.join.uni-muenster.de.
|
|
tolot.join.uni-muenster.de. has AAAA address
|
|
¬ 2001:638:500:101:2e0:81ff:fe24:37c6
|
|
]]></screen></sect2><sect2>
|
|
<title>Cliente de Telnet com suporte a IPv6</title>
|
|
<para>Cliente de telnet com suporte a IPv6 estão disponíveis. Um teste simples pode ser feito com o comando:</para><screen>
|
|
<![CDATA[$ telnet 3ffe:400:100::1 80
|
|
Trying 3ffe:400:100::1...
|
|
Connected to 3ffe:400:100::1.
|
|
Escape character is '^]'.
|
|
HEAD / HTTP/1.0
|
|
|
|
HTTP/1.1 200 OK
|
|
Date: Sun, 16 Dec 2001 16:07:21
|
|
GMT Server: Apache/2.0.28 (Unix)
|
|
Last-Modified: Wed, 01 Aug 2001 21:34:42 GMT
|
|
ETag: "3f02-a4d-b1b3e080"
|
|
Accept-Ranges: bytes
|
|
Content-Length: 2637
|
|
Connection: close
|
|
Content-Type: text/html; charset=ISO-8859-1
|
|
|
|
Connection closed by foreign host.
|
|
]]></screen><para>Se o cliente de telnet não entende o IPv6, a mensagem de erro será "cannot resolve hostname".</para></sect2><sect2>
|
|
<title>SSH com suporte a IPv6</title>
|
|
<sect3>
|
|
<title>openssh</title>
|
|
<para>As versões atuais do openssh já suportam IPv6. Dependendo da configuração utilizada, ele tem dois comportamentos:</para><itemizedlist>
|
|
<listitem><para>--without-ipv4-default: o cliente tenta se conectar primeiro em IPv6, e ele usa IPv4 se a conexão em IPv6 não for estabelecida</para></listitem><listitem><para>--with-ipv4-default: a conexão é feita primeiro em IPv4 e para usar algum endereço IPv6, deve-se forçar a sua utilização. Veja o exemplo</para></listitem></itemizedlist><screen>
|
|
<![CDATA[$ ssh -6 ::1
|
|
user@::1's password: ******
|
|
[user@ipv6host user]$
|
|
]]></screen><para>Se seu cliente ssh não entende a opção "-6" então o suporte a IPv6 não está habilitado, como muitos pacotes de ssh na versão 1.</para></sect3><sect3>
|
|
<title>ssh.com</title>
|
|
<para>O software cliente e servidor SSH da SSH.com já suporta o IPv6 e agora ele é grátis para todos os Linux e FreeBSD, independente se o seu uso é pessoal ou comercial.</para></sect3></sect2><sect2>
|
|
<title>Browsers com suporte a IPv6</title>
|
|
<para>O status atual dos browsers com suporte a IPv6 pode ser encontrado aqui<ulink url="http://www.bieringer.de/linux/IPv6/status/IPv6+Linux-status-apps.html#HTTP">IPv6+Linux-status-apps.html#HTTP</ulink>.</para>
|
|
<para>A maioria deles ainda tem problemas pendentes, tais como:</para><orderedlist>
|
|
<listitem><para>Se a configuração de proxy usa somente endereços IPv4, os pedidos em IPv6 também serão enviados a este proxy, emas como o proxy não saberá resolver o endereço, o pedido não vai funcionar. A única solução é verificar se o seu software de proxy tem alguma atualização para resolver este problema.</para></listitem><listitem><para>Configuração automática de proxy (*.pac) não pode ser utilizada para manipular pedidos em IPv6 de maneira diferenciada (exemplo: não usar o proxy para o IPv6) por causa da sua natureza (escritos em Javascript e muito encrustado no código fonte, como é visto no Mozilla).</para></listitem></orderedlist><para>As versões anteriores de browsers também não entenderiam uma URL com o endereço IPv6, como no exemplo <ulink url="http://[2001:4dd0:f838:a006::6]/">http://[2001:4dd0:f838:a006::6]/</ulink> (isto funciona somente se a URL for usada em um browser que suporte IPv6).</para>
|
|
<para>Um pequeno teste é tentar este endereço em um browser sem o proxy configurado.</para><sect3>
|
|
<title>URLs para teste</title>
|
|
<para>Um bom ponto de partida para browsers que usam IPv6 é o site<ulink url="http://www.kame.net/">http://www.kame.net/</ulink>.Se a tartaruga da página estiver animada, a sua conexão é em IPv6. caso contrário, a tartaruga ficará parada.</para></sect3></sect2></sect1><sect1>
|
|
<title>Programas servidores com suporte a IPv6</title>
|
|
<para>Nesta parte deste HowTo, outros softwares cliente IPv6 são mencionados, assim como dicas para servidores com suporte a IPv6, como sshd, httpd, telnetd, etc, assim como outras dicas em<link linkend="chapter-hints-daemons">Hints for IPv6-enabled daemons</link>.</para></sect1><sect1 id='faq-ipv6-ready-system-check' >
|
|
<title><!-- anchor id="faq-ipv6-ready-system-check" -->FAQ (checagem de sistema com suporte a IPv6)</title>
|
|
<sect2>
|
|
<title>Usando ferramentas</title>
|
|
<sect3>
|
|
<title>Q: Não consigo pingar (ping6) o endereço link-local</title>
|
|
<para>Mensagem de erro: "connect: Invalid argument"</para>
|
|
<para>O kernel não conhece qual interface física ou virtual voce quer utilizar para enviar o pacote ICMPv6. Assim, a solução poderia aparecer assim.</para>
|
|
<para>Solução:: Determine a interface, como: "ping6 -I eth0 fe80::2e0:18ff:fe90:9205", veja também<link linkend="program-ping6.">program ping6 usage</link>.</para></sect3><sect3>
|
|
<title>Q: Não consigo pingar (ping6) ou efetuar traceroute (traceroute6) como usuário normal</title>
|
|
<para>Menagem de erro: "icmp socket: Operation not permitted"</para>
|
|
<para>Estes utilitários criam pacotes especiais ICMPv6 e então os enviam. Isto é feito usando conexões brutas no kernel. Mas estas conexões somente podem ser usadas pelo usuário "root". Desta forma, esta mensagem vai aparecer para os usuários normais.</para>
|
|
<para>Solução: Se for realmente necessário que todos os usuários utilizem estas ferramentas, voce pode adicionar o "suid" bit usando o comando "chmod u+s /caminho/para/o/programa", e veja também este link<link linkend="program-ping6.">program ping6 usage</link>Se nem todos os usuários necessitam usá-lo, voce pode mudar o grupo do programa, para "wheel" por exemplo, e todos os usuários pertencentes a este grupo poderão executar estes programas sem problema. Voce também pode configurar o "sudo" para isto também.</para></sect3></sect2></sect1></chapter><chapter id='chapter-configuration-interface' >
|
|
<title><!-- anchor id="chapter-configuration-interface" -->Configurando interfaces</title>
|
|
<sect1>
|
|
<title>Dispositivos de rede diferentes</title>
|
|
<para>Em um nó, podem haver diferentes tipos de interfaces. Elas podem estar agrupadas em classes</para><itemizedlist>
|
|
<listitem><para>Físicas, como eth0, tr0</para></listitem><listitem><para>Virtuais, como ppp0, tun0, tap0, sit0, isdn0, ippp0</para></listitem></itemizedlist><sect2>
|
|
<title>Físicas</title>
|
|
<para>As interfaces físicas, como Ethernet ou Token Ring são exemplos de interfaces comuns que não precisam de qualquer tipo de tratamento especial.</para></sect2><sect2>
|
|
<title>Virtuais</title>
|
|
<para>As interfaces virtuais sempre precisam de algum tratamento especial</para><sect3>
|
|
<title>Interfaces Túnel IPv6-in-IPv4</title>
|
|
<para>Estas interfaces normalmente recebem o nome sit<emphasis>x</emphasis>. O nome sit é uma atalho para Simple Internet Transition. Esta interface tem a capacidade de encapsular os pacotes IPv6 em pacotes IPv4 e tunelar estes pacotes para um endpoint remoto.</para>
|
|
<para>A interface sit0 tem um papel especial e não pode ser usada para túneis dedicados.</para></sect3><sect3>
|
|
<title>Interfaces PPP</title>
|
|
<para>As interfaces PPP obteem sua capacidade IPv6 do daemon PPP para IPv6.</para></sect3><sect3>
|
|
<title>Interfaces ISDN HDLC</title>
|
|
<para>A capacidade IPv6 para HDLC com encapsulamento IP já está contida no kernel</para></sect3><sect3>
|
|
<title>Interfaces ISDN PPP </title>
|
|
<para>A interface ISDN PPP (ippp) não tem o suporte ao IPv6 no kernel. E também não há qualquer plano para suportar, porque o kernel da série 2.5 ele será substituído por uma camada de interface PPP mais genérica.</para></sect3><sect3>
|
|
<title>SLIP + PLIP</title>
|
|
<para>Como mencionado anteriormente neste documento, esta interface não suporta o IPv6 (no envio até que funciona, mas a recepção não funciona).</para></sect3><sect3>
|
|
<title>Dispositivo Ether-tap</title>
|
|
<para>Dispositivos Ether-tap já possuem o IPv6 habilitado e o stateless configurado. Para usá-lo, o módulo "ethertap" deve ter sido carregado antes.</para></sect3><sect3>
|
|
<title>Dispositivos tun</title>
|
|
<para>Atualmente não foi testado por mim</para></sect3><sect3>
|
|
<title>ATM</title>
|
|
<para>01/2002: Não são mais suportados pelo kernel vanilla, mas somente pelas extensões USAGI</para></sect3><sect3>
|
|
<title>Outras</title>
|
|
<para>Eu esqueci de alguma ?</para></sect3></sect2></sect1><sect1>
|
|
<title>Colocando as interfaces em up e down</title>
|
|
<para>Existem dois métodos usados para colocar as interfaces em up ou down..</para><sect2>
|
|
<title>Usando "ip"</title>
|
|
<para>Uso: </para><screen>
|
|
<![CDATA[# ip link set dev <interface> up
|
|
# ip link set dev <interface> down
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[
|
|
# ip link set dev eth0 up
|
|
# ip link set dev eth0 down
|
|
]]></screen></sect2><sect2>
|
|
<title>Usando "ifconfig"</title>
|
|
<para>Uso: </para><screen>
|
|
<![CDATA[# /sbin/ifconfig <interface> up
|
|
# /sbin/ifconfig <interface> down
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[# /sbin/ifconfig eth0 up
|
|
# /sbin/ifconfig eth0 down
|
|
]]></screen></sect2></sect1></chapter><chapter id='chapter-configuration-address' >
|
|
<title><!-- anchor id="chapter-configuration-address" -->Configurando endereços IPv6</title>
|
|
<para>Existem várias maneiras de configurar um endereço IPv6 em uma interface. As mais comuns são "ifconfig" e "ip".</para><sect1>
|
|
<title>Mostrando os endereços IPv6 existentes</title>
|
|
<para>Antes de mais nada, voce precisa checar se já existe algum endereço IPv6 configurado e qual é o seu tipo (talvez atribuído durante uma auto-configuração stateless).</para><sect2>
|
|
<title>Usando "ip"</title>
|
|
<para>Uso:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 addr show dev <interface>
|
|
]]></screen><para>Exemplo para uma configuração de host estático:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 addr show dev eth0
|
|
2: eth0: <BROADCAST,MULTICAST,UP> mtu 1500 qdisc pfifo_ fast qlen 100
|
|
inet6 fe80::210:a4ff:fee3:9566/10 scope link
|
|
inet6 2001:0db8:0:f101::1/64 scope global
|
|
inet6 fec0:0:0:f101::1/64 scope site
|
|
]]></screen><para>Exemplo de um host auto-configurado</para>
|
|
<para>Aqui voce pode ver a configuração de IPv6 através do processo auto-magically, além do tempo de vida do endereço.</para><screen>
|
|
<![CDATA[# /sbin/ip -6 addr show dev eth0
|
|
3: eth0: <BROADCAST,MULTICAST,PROMISC,UP> mtu 1500 qdisc pfifo_fast qlen
|
|
¬ 100
|
|
inet6 2002:d950:f5f8:f101:2e0:18ff:fe90:9205/64 scope global dynamic
|
|
valid_lft 16sec preferred_lft 6sec
|
|
inet6 3ffe:400:100:f101:2e0:18ff:fe90:9205/64 scope global dynamic
|
|
valid_lft 2591997sec preferred_lft 604797sec inet6 fe80::2e0:18ff:fe90:9205/10
|
|
¬ scope link
|
|
]]></screen></sect2><sect2>
|
|
<title>Usando "ifconfig"</title>
|
|
<para>Uso:</para><screen>
|
|
<![CDATA[# /sbin/ifconfig <interface>
|
|
]]></screen><para>Exemplo (a saída foi filtrada com o grep para mostrar somente os endereços IPv6). Aqui voce pode ver diferentes endereços IPv6 com diferentes escopos.</para><screen>
|
|
<![CDATA[# /sbin/ifconfig eth0 |grep "inet6 addr:"
|
|
inet6 addr: fe80::210:a4ff:fee3:9566/10 Scope:Link
|
|
inet6 addr: 2001:0db8:0:f101::1/64 Scope:Global
|
|
inet6 addr: fec0:0:0:f101::1/64 Scope:Site
|
|
]]></screen></sect2></sect1><sect1>
|
|
<title>Adicionando um endereço IPv6</title>
|
|
<para>A adição de um endereço IPv6 é muito similar ao endereço "IP ALIAS" nas interfaces IPv4 no Linux.</para><sect2>
|
|
<title>Usando "ip"</title>
|
|
<para>Uso: </para><screen>
|
|
<![CDATA[# /sbin/ip -6 addr add <ipv6address>/<prefixlength> dev <interface>
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 addr add 2001:0db8:0:f101::1/64 dev eth0
|
|
]]></screen></sect2><sect2>
|
|
<title>Usando "ifconfig"</title>
|
|
<para>Uso: </para><screen>
|
|
<![CDATA[# /sbin/ifconfig <interface> inet6 add <ipv6address>/<prefixlength>
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[# /sbin/ifconfig eth0 inet6 add 2001:0db8:0:f101::1/64
|
|
]]></screen></sect2></sect1><sect1>
|
|
<title>Removendo um endereço IPv6</title>
|
|
<para>Como esta ação não é tão necessária, tenha cuidado ao remover endereços IPv6 que não existem, pois ao realizar esta ação em kernels mais antigos, voce pode causar um grande estrago no sistema.</para><sect2>
|
|
<title>Usando "ip"</title>
|
|
<para>Uso: </para><screen>
|
|
<![CDATA[# /sbin/ip -6 addr del <ipv6address>/<prefixlength> dev <interface>
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 addr del 2001:0db8:0:f101::1/64 dev eth0
|
|
]]></screen></sect2><sect2>
|
|
<title>Usando "ifconfig"</title>
|
|
<para>Uso:</para><screen>
|
|
<![CDATA[# /sbin/ifconfig <interface> inet6 del <ipv6address>/<prefixlength>
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[# /sbin/ifconfig eth0 inet6 del 2001:0db8:0:f101::1/64
|
|
]]></screen></sect2></sect1></chapter><chapter id='chapter-configuration-route' >
|
|
<title><!-- anchor id="chapter-configuration-route" -->Configurando rotas IPv6</title>
|
|
<para>Se voce quer deixar seu link e quer enviar pacotes a todo o mundo que está só aguardando a sua conexão em IPv6, voce vai precisar de uma rota. Se já houver um router com IPv6 habilitado (e uma rota para ele), estes passos abaixo vão te ensinar como adicionar mais rotas em IPv6.</para><sect1>
|
|
<title>Mostrando as rotas IPv6 existentes</title>
|
|
<para>Antes de mais nada, é interessante verificar quais são as rotas IPv6 já configuradas (talvez atribuído durante uma auto-configuração).</para><sect2>
|
|
<title>Usando "ip"</title>
|
|
<para>Uso:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 route show [dev <device>]
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 route show dev eth0
|
|
2001:0db8:0:f101::/64 proto kernel metric 256 mtu 1500 advmss 1440
|
|
fe80::/10 proto kernel metric 256 mtu 1500 advmss 1440
|
|
ff00::/8 proto kernel metric 256 mtu 1500 advmss 1440
|
|
default proto kernel metric 256 mtu 1500 advmss 1440
|
|
]]></screen></sect2><sect2>
|
|
<title>Usando "route"</title>
|
|
<para>Uso: </para><screen>
|
|
<![CDATA[# /sbin/route -A inet6
|
|
]]></screen><para>Exemplo (a saída foi filtrada para a interface eth0). Aqui voce pode ver rotas IPv6 para diferentes endereços em uma única interface.</para><screen>
|
|
<![CDATA[# /sbin/route -A inet6 |grep -w "eth0"
|
|
2001:0db8:0:f101 ::/64 :: UA 256 0 0 eth0 <- Interface route for global
|
|
¬ address
|
|
fe80::/10 :: UA 256 0 0 eth0 <- Interface route for link-local
|
|
¬ address
|
|
ff00::/8 :: UA 256 0 0 eth0 <- Interface route for all multicast
|
|
¬ addresses
|
|
::/0 :: UDA 256 0 0 eth0 <- Automatic default route
|
|
]]></screen></sect2></sect1><sect1>
|
|
<title>Adicionando uma rota IPv6 através de um gateway</title>
|
|
<para>Bastante necessário quando se quer acessar outras redes com IPv6 usando um router IPv6-enabled em seu link.</para><sect2>
|
|
<title>Usando "ip"</title>
|
|
<para>Uso:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 route add <ipv6network>/<prefixlength> via <ipv6address>
|
|
¬ [dev <device>]
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 route add 2000::/3 via 2001:0db8:0:f101::1
|
|
]]></screen></sect2><sect2>
|
|
<title>Usando "route"</title>
|
|
<para>Uso: </para><screen>
|
|
<![CDATA[# /sbin/route -A inet6 add <ipv6network>/<prefixlength> gw
|
|
¬ <ipv6address> [dev <device>]
|
|
]]></screen><para>Um dispositivo pode ser necessário se o dispositivo do endereço IPv6 do gateway for um dispositivo link local.</para>
|
|
<para>Veja o exemplo abaixo, como adicionar uma rota para todos os endereços globais (2000::/3) através do gateway 2001:0db8:0:f101::1</para><screen>
|
|
<![CDATA[# /sbin/route -A inet6 add 2000::/3 gw 2001:0db8:0:f101::1
|
|
]]></screen></sect2></sect1><sect1>
|
|
<title>Removendo uma rota IPv6 através de um gateway</title>
|
|
<para>Não é geralmente usada no modo manual, pois sugerimos a utilização de scripts ou shutdown nas interfaces (todas ou por interface)</para><sect2>
|
|
<title>Usando "ip"</title>
|
|
<para>Uso:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 route del <ipv6network>/<prefixlength> via <ipv6address>
|
|
¬ [dev <device>]
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 route del 2000::/3 via 2001:0db8:0:f101::1
|
|
]]></screen></sect2><sect2>
|
|
<title>Usando "route"</title>
|
|
<para>Uso: </para><screen>
|
|
<![CDATA[# /sbin/route -A inet6 del <network>/<prefixlength> gw <ipv6address> [dev
|
|
¬ <device>]
|
|
]]></screen><para>Exemplo para remover a rota adicionada anteriormente (acima):</para><screen>
|
|
<![CDATA[# /sbin/route -A inet6 del 2000::/3 gw 2001:0db8:0:f101::1
|
|
]]></screen></sect2></sect1><sect1>
|
|
<title>Adicionando uma rota IPv6 através de uma interface</title>
|
|
<para>Nem sempre usado, mas quando usado é em links ponto a ponto.</para><sect2>
|
|
<title>Usando "ip"</title>
|
|
<para>Uso:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 route add <ipv6network>/<prefixlength> dev <device>
|
|
¬ metric 1
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 route add 2000::/3 dev eth0 metric 1
|
|
]]></screen><para>A métrica "1" é usada aqui para se manter compatível com as métricas usadas pelo comando route, já que a métrica default ao se usar "ip" é "1024".</para></sect2><sect2>
|
|
<title>Usando "route"</title>
|
|
<para>Uso:</para><screen>
|
|
<![CDATA[# /sbin/route -A inet6 add <ipv6network>/<prefixlength> dev <device>
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[# /sbin/route -A inet6 add 2000::/3 dev eth0
|
|
]]></screen></sect2></sect1><sect1>
|
|
<title>Removendo uma rota IPv6 através de uma interface</title>
|
|
<para>Nem sempre utilizado manualmente, pois recomenda-se a utilização de scripts.</para><sect2>
|
|
<title>Usando "ip"</title>
|
|
<para>Uso:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 route del <ipv6network>/<prefixlength> dev <device>
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 route del 2000::/3 dev eth0
|
|
]]></screen></sect2><sect2>
|
|
<title>Usando "route"</title>
|
|
<para>Uso:</para><screen>
|
|
<![CDATA[# /sbin/route -A inet6 del <network>/<prefixlength> dev <device>
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[# /sbin/route -A inet6 del 2000::/3 dev eth0
|
|
]]></screen></sect2></sect1><sect1>
|
|
<title>FAQ para rotas em IPv6</title>
|
|
<sect2>
|
|
<title>Suporte de uma rota default IPv6</title>
|
|
<para>Uma boa idéia do IPv6 foi o roteamento hierárquico, o que proporcionaria a necessidade de menos rotas nos roteadores.</para>
|
|
<para>Aqui estão alguns problemas no kernel atual do Linux:</para><sect3>
|
|
<title>Clientes (não roteando qualquer pacote!)</title>
|
|
<para>Um cliente pode configurar uma rota default prefixo "::/0", mas eles também aprendem uma rota no processo de auto configuração, ex.: uso do radvd no link abaixo mostra:</para><screen>
|
|
<![CDATA[# ip -6 route show | grep ^default
|
|
default via fe80::212:34ff:fe12:3450 dev eth0 proto kernel metric 1024 expires
|
|
¬ 29sec mtu 1500 advmss 1440
|
|
]]></screen></sect3><sect3>
|
|
<title>Roteadores em caso de packet forwarding</title>
|
|
<para>Os linux mais velhos (pelo menos inferiores ao kernel 2.4.17) não suportam rotas default. Voce pode configura-las, mas a pesquisa na tabela vai retornar uma falha quando deveria ser encaminhado (intenção normal do roteador). Se voce ainda está usando uma versão antiga de kernel, as "rotas default" podem ser configuradas usando o prefixo de endereço global "2000::/3".</para>
|
|
<para>Nota: tome cuidado com as rotas default sem filtragem de endereços em roteadores de borda, pois o tráfego multicast ou site-local pode sair para o mundo.</para></sect3></sect2></sect1></chapter><chapter id='chapter-Neighbor-Discovery' >
|
|
<title><!-- anchor id="chapter-Neighbor-Discovery" -->Descoberta de vizinhos</title>
|
|
<para>A descoberta de vizinhos funciona como um sucessor do ARP (Address Resolution Protocol) em IPv4, no mundo IPv6. Voce pode obter estas informações sobre os vizinhos atuais, e adicionalmente voce pode configurar e excluir entradas. O kernel mantém o rastreamento das descobertas bem sucedidas (como no ARP em IPv4). Voce pode pesquisar as entradas nesta tabela usando o comando "ip".</para><sect1>
|
|
<title>Mostrando os vizinhos usando "ip"</title>
|
|
<para>Com o comando abaixo voce pode verificar a tabela de vizinhos aprendida ou configurada</para><screen>
|
|
<![CDATA[# ip -6 neigh show [dev <device>]
|
|
]]></screen><para>O exemplo a seguir mostra um vizinho, o qual é um router acessível</para><screen>
|
|
<![CDATA[# ip -6 neigh show
|
|
fe80::201:23ff:fe45:6789 dev eth0 lladdr 00:01:23:45:67:89 router nud reachable
|
|
]]></screen></sect1><sect1>
|
|
<title>Manipulando a tabela de vizinhos usando "ip"</title>
|
|
<sect2>
|
|
<title>Adicionando uma entrada manualmente</title>
|
|
<para>Com o comando abaixo, voce consegue adicionar uma entrada manualmente</para><screen>
|
|
<![CDATA[# ip -6 neigh add <IPv6 address> lladdr <link-layer address> dev <device>
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[# ip -6 neigh add fec0::1 lladdr 02:01:02:03:04:05 dev eth0
|
|
]]></screen></sect2><sect2>
|
|
<title>Excluindo uma entrada manualmente</title>
|
|
<para>Similar à adição de uma entrada, uma entrada pode ser excluída</para><screen>
|
|
<![CDATA[# ip -6 neigh del <IPv6 address> lladdr <link-layer address> dev <device>
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[# ip -6 neigh del fec0::1 lladdr 02:01:02:03:04:05 dev eth0
|
|
]]></screen></sect2><sect2>
|
|
<title>Opções mais avançadas</title>
|
|
<para>A ferramenta "ip" não é tão documentada, mas é bem útil e forte. Veja o seu help online para mais informações:</para><screen>
|
|
<![CDATA[# ip -6 neigh help
|
|
Usage: ip neigh { add | del | change | replace } { ADDR [ lladdr LLADDR ]
|
|
[ nud { permanent | noarp | stale | reachable } ]
|
|
| proxy ADDR } [ dev DEV ]
|
|
ip neigh {show|flush} [ to PREFIX ] [ dev DEV ] [ nud STATE ]
|
|
]]></screen><para>Aparentemente algumas opções são somente para o IPv4... e se voce quiser contribuir com mais informações sobre outras opções da ferramenta e usos avançados, por favor, me envie.</para></sect2></sect1></chapter><chapter id='chapter-configuring-ipv6-in-ipv4-tunnels' >
|
|
<title><!-- anchor id="chapter-configuring-ipv6-in-ipv4-tunnels" -->Configurando um túnel IPv6-in-IPv4</title>
|
|
<para>Se voce quer deixar seu link e ter uma rede IPv6 à sua volta, voce vai precisar de um túnel IPv6-in-IPv4 para acessar a web em modo IPv6.</para>
|
|
<para>Existem alguns tipos de mecanismo e também algumas possibilidades da configuração deste túnel.</para><sect1>
|
|
<title>Tipos de túneis</title>
|
|
<para>Existe mais de uma possibilidade de transportar pacotes IPvb6 em links IPv4.</para><sect2>
|
|
<title>Túnel estático ponto a ponto: 6bone</title>
|
|
<para>Um túnel ponto a ponto é um túnel dedicado em direção a um ponto final., o qual sabe informações sobre uma rede IPv6A (para rotas de volta) e os endereços IPv4 deste túnel estão definidos na <ulink url="http://www.faqs.org/rfcs/rfc2893.html">RFC 2893 / Transition Mechanisms for IPv6 Hosts and Routers</ulink>. Necessidades:</para><itemizedlist>
|
|
<listitem><para>O endereço IPv4 local do túnel precisa ser estático, global, único e acessível a partir da outra ponta</para></listitem><listitem><para>Um prefixo global IPv6 deve ser designado a voce (veja o registro 6bone)</para></listitem><listitem><para>Um ponto final remoto do túnel deve ser capaz de rotear seu prefixo IPv6para seu ponto final local (uma configuração manual pode ser necessária)</para></listitem></itemizedlist></sect2><sect2>
|
|
<title>Túnel automático</title>
|
|
<para>Um túnel automático acontece quando um nó diretamente conectado a outro nó obtém um IPv4 do outro nó anterior.</para></sect2><sect2 id='tunneling-6to4.' >
|
|
<title><!-- anchor id="tunneling-6to4." -->6to4-Tunneling</title>
|
|
<para>O túnel 6to4 (<ulink url="http://www.faqs.org/rfcs/rfc3056.html">RFC 3056 / Connection of IPv6 Domains via IPv4 Clouds</ulink>) utiliza um mecanismo simples para criar túneis automáticos. Cada nó com um endereço global único é capaz de ser uma ponta final de um túnel 6to4 (se nenhum firewall no meio do caminho bloquear este tipo de tráfego). Túneis 6to4 não costumam ser túneis um a um. Este tipo de túnel pode ser dividido em Upstream e Downstream. Além disso, um endereço especial IPv6 indica que este nó vai usar o tunelamento 6to4 para se conectar a redes IPv6 mundiais.</para><sect3>
|
|
<title>Geração de prefixo 6to4</title>
|
|
<para>O endereço 6to4 está definido abaixo (o esquema foi pego da <ulink url="http://www.faqs.org/rfcs/rfc3056.html">RFC 3056 / Connection of IPv6 Domains via IPv4 Clouds</ulink>):</para><screen>
|
|
<![CDATA[| 3+13 | 32 | 16 | 64 bits |
|
|
+---+------+-----------+--------+--------------------------------+
|
|
| FP+TLA | V4ADDR | SLA ID | Interface ID |
|
|
| 0x2002 | | | |
|
|
+---+------+-----------+--------+--------------------------------+
|
|
]]></screen><para>FP e TLA juntos (16 bits) tem o valor 0x2002. V4ADDR é o endereço único IPv4 (em notação hexadecimal). SLA é o identificador de rede (65536 redes locais possíveis) e são usados para representar a sua estrutura de rede local.</para>
|
|
<para>Para os gateways, tal prefixo é gerado normalmente usando o SLA “0000” e o sufixo "::1" (não é uma exigencia, pode ser arbitrário com um escopo local) e então assinalado a uma interface de túnel 6to4. Veja que a Microsoft também utiliza V4ADDR para o sufixo.</para></sect3><sect3>
|
|
<title>Tunelamento Upstream 6to4</title>
|
|
<para>O nó tem que saber para qual ponta remota de túnel os pacotes IPv4 com pacotes IPv6 devem ser encaminhados. No início dos tempos de tunelamento 6to4, upstreams dedicados aceitavam que os routers fizessem isso. Veja <ulink url="http://www.kfu.com/~nsayer/6to4/">NSayer's 6to4 information</ulink> para uma lista de routers.</para>
|
|
<para>Hoje em dia, os routers upstream 6to4 podem ser encontrados automaticamente, usando o endereço de unicast 192.88.99.1. Os protocolos de roteamento se incumbem desta função, veja <ulink url="http://www.faqs.org/rfcs/rfc3068.html">RFC 3068 / An Anycast Prefix for 6to4 Relay Routers</ulink> para mais detalhes. </para></sect3><sect3>
|
|
<title>Tunelamento Downstream 6to4</title>
|
|
<para>O downstream (6bone -> seu nó com 6to4 habilitado) não é realmente correto e pode variar de um host remoto estranho que originou os pacotes que foram enviados a voce. Existem duas possibilidades:</para><itemizedlist>
|
|
<listitem><para>Estes hosts remotos usam endereços 6to4 e enviam os pacotes de volta diretamente a seu nó (veja abaixo)</para></listitem><listitem><para>Estes hosts remotos enviam os pacotes de volta à rede IPv6 e dependendo do roteamento, um router no meio do caminho cria um túnel automaticamente em direção ao seu nó.</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Tráfego 6to4 possível</title>
|
|
<itemizedlist>
|
|
<listitem><para>6to4 para 6to4: normalmente é um túnel direto entre as duas pontas, ambos habilitados em 6to4</para></listitem><listitem><para>6to4 para não-6to4: é enviado via um túnel upstream</para></listitem><listitem><para>não-6to4 para 6to4: é enviado via um túnel downstream</para></listitem></itemizedlist></sect3></sect2></sect1><sect1>
|
|
<title>Mostrando os túneis existentes</title>
|
|
<sect2>
|
|
<title>Usando "ip"</title>
|
|
<para>Uso:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 tunnel show [<device>]
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 tunnel show
|
|
sit0: ipv6/ip remote any local any ttl 64 nopmtudisc
|
|
sit1: ipv6/ip remote 195.226.187.50 local any ttl 64
|
|
]]></screen></sect2><sect2>
|
|
<title>Usando "route"</title>
|
|
<para>Uso:</para><screen>
|
|
<![CDATA[# /sbin/route -A inet6
|
|
]]></screen><para>Exemplo (a saída está filtrada para mostrar somente os túneis através da interface virtual sit0):</para><screen>
|
|
<![CDATA[# /sbin/route -A inet6 | grep "\Wsit0\W*$"
|
|
::/96 :: U 256 2 0 sit0
|
|
2002::/16 :: UA 256 0 0 sit0
|
|
2000::/3 ::193.113.58.75 UG 1 0 0 sit0
|
|
fe80::/10 :: UA 256 0 0 sit0
|
|
ff00::/8 :: UA 256 0 0 sit0
|
|
]]></screen></sect2></sect1><sect1 id='conf-ipv6-in-ipv4-point-to-point-tunnels' >
|
|
<title><!-- anchor id="conf-ipv6-in-ipv4-point-to-point-tunnels" -->Configuração de um túnel ponto a ponto</title>
|
|
<para>Existem possibilidades para adicionar ou remover um túnel ponto a ponto.</para>
|
|
<para>Uma boa informação adicional sobre a configuração de túneis fornecida através do comando “ip” está aqui <ulink url="http://www.deepspace6.net/docs/iproute2tunnel-en.html">Configuring tunnels with iproute2 (article)</ulink> (<ulink url="http://mirrors.bieringer.de/www.deepspace6.net/docs/iproute2tunnel-en.html">Mirror</ulink>).</para><sect2>
|
|
<title>Adicionando túneis ponto a ponto</title>
|
|
<sect3>
|
|
<title>Usando "ip"</title>
|
|
<para>Um método comum para a criação de uma quantidade pequena de túneis.</para>
|
|
<para>Use-o para criar um dispositivo túnel (mas não depois, o TTL também deve ser especificado, porque seu valor default é 0).</para><screen>
|
|
<![CDATA[# /sbin/ip tunnel add <device> mode sit ttl <ttldefault> remote
|
|
¬ <ipv4addressofforeigntunnel> local <ipv4addresslocal>
|
|
]]></screen><para>Uso (exemplo genérico para 3 túneis):</para><screen>
|
|
<![CDATA[# /sbin/ip tunnel add sit1 mode sit ttl <ttldefault> remote
|
|
¬ <ipv4addressofforeigntunnel1> local <ipv4addresslocal>
|
|
# /sbin/ip link set dev sit1 up
|
|
# /sbin/ip -6 route add <prefixtoroute1> dev sit1 metric 1
|
|
|
|
# /sbin/ip tunnel add sit2 mode sit ttl <ttldefault>
|
|
¬ <ipv4addressofforeigntunnel2> local <ipv4addresslocal>
|
|
# /sbin/ip link set dev sit2 up
|
|
# /sbin/ip -6 route add <prefixtoroute2> dev sit2 metric 1
|
|
|
|
# /sbin/ip tunnel add sit3 mode sit ttl <ttldefault>
|
|
¬ <ipv4addressofforeigntunnel3> local <ipv4addresslocal>
|
|
# /sbin/ip link set dev sit3 up
|
|
# /sbin/ip -6 route add <prefixtoroute3> dev sit3 metric 1
|
|
]]></screen></sect3><sect3>
|
|
<title>Usando "ifconfig" e "route" (obsoleto)</title>
|
|
<para>Esta não é uma maneira muito recomendada de se criar um túnel porque ele é um pouco estranho. Não há qualquer problema se voce adicionar somente um, mas se voce for configurar mais de um, voce não poderá desfazer os primeiros túneis criados e deixar os últimos em funcionamento.</para>
|
|
<para>Uso (exemplo genérico para 3 túneis):</para><screen>
|
|
<![CDATA[# /sbin/ifconfig sit0 up
|
|
|
|
# /sbin/ifconfig sit0 tunnel <ipv4addressofforeigntunnel1>
|
|
# /sbin/ifconfig sit1 up
|
|
# /sbin/route -A inet6 add <prefixtoroute1> dev sit1
|
|
|
|
# /sbin/ifconfig sit0 tunnel <ipv4addressofforeigntunnel2>
|
|
# /sbin/ifconfig sit2 up
|
|
# /sbin/route -A inet6 add <prefixtoroute2> dev sit2
|
|
|
|
# /sbin/ifconfig sit0 tunnel <ipv4addressofforeigntunnel3>
|
|
# /sbin/ifconfig sit3 up
|
|
# /sbin/route -A inet6 add <prefixtoroute3> dev sit3
|
|
]]></screen><para>Importante: NÃO USE ISSO, porque esta configuração habilita implicitamente um “tunelamento automático” de qualquer lugar na internet, e isto é um risco, então não o utilize.</para></sect3><sect3>
|
|
<title>Usando somente "route"</title>
|
|
<para>Também é possível configurar túneis no modo Non Broadcast Multiple Access (NBMA), pois é uma maneira fácil de adicionar muitos túneis de uma vez. Mas nenhum dos túneis pode ser numerado (o que não é uma característica).</para>
|
|
<para>Uso (exemplo genérico para 3 túneis):</para><screen>
|
|
<![CDATA[# /sbin/ifconfig sit0 up
|
|
|
|
# /sbin/route -A inet6 add <prefixtoroute1> gw
|
|
¬ ::<ipv4addressofforeigntunnel1> dev sit0
|
|
# /sbin/route -A inet6 add <prefixtoroute2> gw
|
|
¬ ::<ipv4addressofforeigntunnel2> dev sit0
|
|
# /sbin/route -A inet6 add <prefixtoroute3> gw
|
|
¬ ::<ipv4addressofforeigntunnel3> dev sit0
|
|
]]></screen><para>Importante: NÃO USE ISSO, porque esta configuração habilita implicitamente um “tunelamento automático” de qualquer lugar na internet, e isto é um risco, então não o utilize.</para></sect3></sect2><sect2>
|
|
<title>Removendo os túneis ponto a ponto</title>
|
|
<para>Nem sempre é necessário fazer isso manualmente, mas pode ser usado em scripts para uma limpeza ou restart de uma configuração IPv6.</para><sect3>
|
|
<title>Usando "ip"</title>
|
|
<para>Uso para remover um dispositivo túnel:</para><screen>
|
|
<![CDATA[# /sbin/ip tunnel del <device>
|
|
]]></screen><para>Uso (exemplo genérico para 3 túneis):</para><screen>
|
|
<![CDATA[# /sbin/ip -6 route del <prefixtoroute1> dev sit1
|
|
# /sbin/ip link set sit1 down
|
|
# /sbin/ip tunnel del sit1
|
|
|
|
# /sbin/ip -6 route del <prefixtoroute2> dev sit2
|
|
# /sbin/ip link set sit2 down
|
|
# /sbin/ip tunnel del sit2
|
|
|
|
# /sbin/ip -6 route del <prefixtoroute3> dev sit3
|
|
# /sbin/ip link set sit3 down
|
|
# /sbin/ip tunnel del sit3
|
|
]]></screen></sect3><sect3>
|
|
<title>Usando "ifconfig" e "route" (não é mais usado por ser estranho)</title>
|
|
<para>Não somente a criação é estranha, como também o shutdown... voce tem que remover os tuneis na ordem inversa em que eles foram criados.</para>
|
|
<para>Uso (exemplo genérico para 3 túneis):</para><screen>
|
|
<![CDATA[# /sbin/route -A inet6 del <prefixtoroute3> dev sit3
|
|
# /sbin/ifconfig sit3 down
|
|
|
|
# /sbin/route -A inet6 del <prefixtoroute2> dev sit2
|
|
# /sbin/ifconfig sit2 down
|
|
|
|
# /sbin/route -A inet6 add <prefixtoroute1> dev sit1
|
|
# /sbin/ifconfig sit1 down
|
|
|
|
# /sbin/ifconfig sit0 down
|
|
|
|
]]></screen></sect3><sect3>
|
|
<title>Usando "route"</title>
|
|
<para>Isto é como remover rotas normais em IPv6.
|
|
</para>
|
|
<para>Uso (exemplo genérico para 3 túneis):</para><screen>
|
|
<![CDATA[# /sbin/route -A inet6 del <prefixtoroute1> gw
|
|
¬ ::<ipv4addressofforeigntunnel1> dev sit0
|
|
# /sbin/route -A inet6 del <prefixtoroute2> gw
|
|
¬ ::<ipv4addressofforeigntunnel2> dev sit0
|
|
# /sbin/route -A inet6 del <prefixtoroute3> gw
|
|
¬ ::<ipv4addressofforeigntunnel3> dev sit0
|
|
|
|
# /sbin/ifconfig sit0 down
|
|
]]></screen></sect3></sect2><sect2>
|
|
<title>Tuneis ponto a ponto numerados</title>
|
|
<para>Às vezes é necessário configurar túneis ponto a ponto com endereços IPv6 como em IPv4. Isto somente é possível utilizando o primeiro (ifconfig+route - obsoleto) e o terceiro (ip+route) modo de configuração. Em tais casos, voce pode adicionar os endereços IPv6 na interface de túnel conforme é mostrado na configuração de uma interface. </para></sect2></sect1><sect1 id='configuring-ipv6to4-tunnels' >
|
|
<title><!-- anchor id="configuring-ipv6to4-tunnels" -->Configuração de túneis 6to4</title>
|
|
<para>Preste atenção pois o suporte aos túneis 6to4 atualmente não está implementado completamente no kernel vanilla da série 2.2.x (veja <link linkend="systemcheck-kernel">systemcheck/kernel</link> para mais detalhes). Veja também que o tamanho do prefixo para um endereço 6to4 é 16, uma vez que do ponto de vista da rede, todos os outros hosts habilitados para 6to4 estão na mesma camada 2.</para><sect2>
|
|
<title>Adição de um túnel 6to4</title>
|
|
<para>Antes de tudo, voce precisa calcular o seu prefixo 6to4 usando o seu endereço público IPv4 (se seu host não tem este endereço, é possível utilizar um NAT no router de borda em alguns casos especiais):</para>
|
|
<para>Assumindo que o seu endereço IPv4 seja este </para><screen>
|
|
<![CDATA[1.2.3.4
|
|
]]></screen><para>o prefixo 6to4 gerado será este</para><screen>
|
|
<![CDATA[2002:0102:0304::
|
|
]]></screen><para>Gateways locais 6to4 deveriam (mas não é uma regra fixa, pois voce pode escolher um sufixo arbitrário, se voce preferir) sempre assinalar o sufixo "::1", desta forma seu endereço local 6to4 será este</para><screen>
|
|
<![CDATA[2002:0102:0304::1
|
|
]]></screen><para>Por exemplo, use a seguinte automação:</para><screen>
|
|
<![CDATA[ipv4="1.2.3.4"; printf "2002:%02x%02x:%02x%02x::1" `echo $ipv4 | tr "." " "`
|
|
]]></screen><para>Atualmente existem duas maneiras possíveis de configurar um túnel 6to4.</para><sect3>
|
|
<title>Usando "ip" e um dispositivo de túnel dedicado</title>
|
|
<para>Esta é a maneira recomendada (um TTL deve ser especificado, pois o valor default é 0).</para>
|
|
<para>Criando um dispositivo de túnel</para><screen>
|
|
<![CDATA[# /sbin/ip tunnel add tun6to4 mode sit ttl <ttldefault> remote any local
|
|
¬ <localipv4address>
|
|
]]></screen><para>Ativando a interface</para><screen>
|
|
<![CDATA[# /sbin/ip link set dev tun6to4 up
|
|
]]></screen><para>Adicionando o endereço local 6to4 na interface (nota: o tamanho do prefixo - /16 - é importante!)</para><screen>
|
|
<![CDATA[# /sbin/ip -6 addr add <local6to4address>/16 dev tun6to4
|
|
]]></screen><para>Adicionando uma rota default para a rede global IPv6 usando o endereço anycast IPv4 todos-6to4-router</para><screen>
|
|
<![CDATA[# /sbin/ip -6 route add 2000::/3 via ::192.88.99.1 dev tun6to4 metric 1
|
|
]]></screen><para>É sabido que algumas versões do comando "ip" (exemplo SuSE Linux 9.0) não suportam endereços IPv6 no formato compatível IPv4 para seus gateways, e neste caso o endereço IPv6 relativo a ele deve ser usado:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 route add 2000::/3 via 2002:c058:6301::1 dev tun6to4 metric 1
|
|
]]></screen></sect3><sect3>
|
|
<title>Usando "ifconfig" e "route" e um dispositivo de túnel genérico "sit0" (obsoleto)</title>
|
|
<para>Este método está obsoleto porque o uso de um túnel genérico sit0 não permite especificar filtros pelo dispositivo.</para>
|
|
<para>Ativando a interface genérica sit0</para><screen>
|
|
<![CDATA[# /sbin/ifconfig sit0 up
|
|
]]></screen><para>Adicionando um endereço 6to4 na interface</para><screen>
|
|
<![CDATA[# /sbin/ifconfig sit0 add <local6to4address>/16
|
|
]]></screen><para>Adicionando uma rota default para a rede global IPv6 usando o endereço anycast IPv4 todos-6to4-router</para><screen>
|
|
<![CDATA[# /sbin/route -A inet6 add 2000::/3 gw ::192.88.99.1 dev sit0
|
|
]]></screen></sect3></sect2><sect2>
|
|
<title>Removendo um túnel 6to4</title>
|
|
<sect3>
|
|
<title>Usando "ip" e um dispositivo de túnel dedicado</title>
|
|
<para>Remova todas as rotas que utilizam este dispositivo</para><screen>
|
|
<![CDATA[# /sbin/ip -6 route flush dev tun6to4
|
|
]]></screen><para>Desligue a interface</para><screen>
|
|
<![CDATA[# /sbin/ip link set dev tun6to4 down
|
|
]]></screen><para>Remova o dispositivo criado</para><screen>
|
|
<![CDATA[# /sbin/ip tunnel del tun6to4
|
|
]]></screen></sect3><sect3>
|
|
<title>Usando "ifconfig" e "route" e o dispositivo genérico de túnel "sit0" (obsoleto)</title>
|
|
<para>Remova as rotas default que usam esta interface</para><screen>
|
|
<![CDATA[# /sbin/route -A inet6 del 2000::/3 gw ::192.88.99.1 dev sit0
|
|
]]></screen><para>Remova o endereço local 6to4 desta interface</para><screen>
|
|
<![CDATA[# /sbin/ifconfig sit0 del <local6to4address>/16
|
|
]]></screen><para>Desligue o dispositivo genérico de túnel (cuidado com isto, pois ela ainda pode estar em uso...)</para><screen>
|
|
<![CDATA[# /sbin/ifconfig sit0 down
|
|
]]></screen></sect3></sect2></sect1></chapter><chapter id='chapter-configuring-ipv4-in-ipv6-tunnels' >
|
|
<title><!-- anchor id="chapter-configuring-ipv4-in-ipv6-tunnels" -->Configurando túneis IPv4-in-IPv6</title>
|
|
<para>A <ulink url="http://www.faqs.org/rfcs/rfc2473.html">RFC 2473 / Generic Packet Tunneling in IPv6 Specification</ulink> especifica o mecanismo para tunelar diferentes tipos de pacotes em IPv6 incluindo IPv4.</para>
|
|
<para>NOTAE: O suporte para túneis IPv4-in-IPv6 está disponível somente a partir da versão de kernel 2.6.22.</para><sect1>
|
|
<title>Mostrando os túneis existentes</title>
|
|
<para>Uso:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 tunnel show [<device>]
|
|
]]></screen><para>Exemplo:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 tunnel show mode any
|
|
ip6tnl0: ipv6/ipv6 remote :: local :: encaplimit 0 hoplimit 0 tclass 0x00
|
|
¬ flowlabel 0x00000 (flowinfo 0x00000000)
|
|
ip6tnl1: ip/ipv6 remote fd00:0:0:2::a local fd00:0:0:2::1 dev eth1 encaplimit 4
|
|
¬ hoplimit 64 tclass 0x00 flowlabel 0x00000 (flowinfo 0x00000000)
|
|
]]></screen><para>NOTA: Se voce não incluir "mode any", somente os túneis IPv6-in-IPv6 serão mostrados.</para></sect1><sect1>
|
|
<title>Configuração de túnel ponto a ponto</title>
|
|
<para>Uso para criar um dispositivo de túnel 4over6 </para><screen>
|
|
<![CDATA[# /sbin/ip tunnel add <device> mode ip4ip6 remote <ipv6addressofforeigntunnel>
|
|
¬ local <ipv6addresslocal>
|
|
]]></screen><para>Uso (exemplo genérico para 3 túneis):</para><screen>
|
|
<![CDATA[# /sbin/ip -6 tunnel add ip6tnl1 mode ip4ip6 remote
|
|
¬ <ipv6addressofforeigntunnel1> local <ipv6addresslocal>
|
|
# /sbin/ip link set dev ip6tnl1 up
|
|
# /sbin/ip -6 route add <prefixtoroute1> dev ip6tnl1 metric 1
|
|
|
|
# /sbin/ip -6 tunnel add ip6tnl2 mode ip4ip6 remote
|
|
¬ <ipv6addressofforeigntunnel2> local <ipv6addresslocal>
|
|
# /sbin/ip link set dev ip6tnl2 up
|
|
# /sbin/ip -6 route add <prefixtoroute2> dev ip6tnl2 metric 1
|
|
|
|
# /sbin/ip -6 tunnel add ip6tnl3 mode ip4ip6 remote
|
|
¬ <ipv6addressofforeigntunnel3> local <ipv6addresslocal>
|
|
# /sbin/ip link set dev ip6tnl3 up
|
|
# /sbin/ip -6 route add <prefixtoroute3> dev ip6tnl3 metric 1
|
|
]]></screen></sect1><sect1>
|
|
<title>Removendo túneis ponto a ponto</title>
|
|
<para>Uso ara remover um dispositivo de túnel:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 tunnel del <device>
|
|
]]></screen><para>Uso (exemplo genérico para 3 túneis):</para><screen>
|
|
<![CDATA[# /sbin/ip -6 route del <prefixtoroute1> dev ip6tnl1
|
|
# /sbin/ip link set ip6tnl1 down
|
|
# /sbin/ip -6 tunnel del ip6tnl1
|
|
|
|
# /sbin/ip -6 route del <prefixtoroute2> dev ip6tnl2
|
|
# /sbin/ip link set ip6tnl2 down
|
|
# /sbin/ip -6 tunnel del ip6tnl2
|
|
|
|
# /sbin/ip -6 route del <prefixtoroute3> dev ip6tnl3
|
|
# /sbin/ip link set ip6tnl3 down
|
|
# /sbin/ip -6 tunnel del ip6tnl3
|
|
]]></screen></sect1></chapter><chapter id='chapter-kernel-settings' >
|
|
<title><!-- anchor id="chapter-kernel-settings" -->Configuraçoes de Kernel nos arquivos do /proc</title>
|
|
<para id='proc-filesystem' ><!-- anchor id="proc-filesystem" -->Nota: a fonte desta seção é em sua maioria o arquivo "ip-sysctl.txt", o qual está incluído no diretório "Documentation/networking" do código fonte do kernel usado. Crédito para Pekka Savola pela manutençao da parte IPv6 neste arquivo. Além disso, muito do que está escrito abaixo é um Copy & Paste deste arquivo mencionado.</para><sect1>
|
|
<title>Como acessar os arquivos do /proc</title>
|
|
<sect2>
|
|
<title>Usando "cat" e "echo"</title>
|
|
<para>Usar os comandos "cat" e "echo" é a maneira mais simples de acessar os arquivos deste diretório, mas alguns pontos devem ser observados:</para><itemizedlist>
|
|
<listitem><para>O sistema de arquivos /proc deve estar habilitado no kernel , ou seja, a seguinte chave deve estar configurada</para></listitem></itemizedlist><screen>
|
|
<![CDATA[CONFIG_PROC_FS=y
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>O sistema de arquivos já deve estar montado, o que pode ser testado como comando</para></listitem></itemizedlist><screen>
|
|
<![CDATA[# mount | grep "type proc"
|
|
none on /proc type proc (rw)
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>Voce pode ler e também escrever (geralmente como root) nos arquivos contidos aqui (/proc)</para></listitem></itemizedlist><para>Normalmente, somente as entradas localizadas em /proc/sys/* podem ser alteradas, as demais são somentepara leitura e para obtenção de informações.</para><sect3>
|
|
<title>Obtendo um valor</title>
|
|
<para>O valor de uma entrada pode ser obtido com o comando "cat":</para><screen>
|
|
<![CDATA[# cat /proc/sys/net/ipv6/conf/all/forwarding
|
|
0
|
|
]]></screen></sect3><sect3>
|
|
<title>Definindo um valor</title>
|
|
<para>Um novo valor pode ser definido (se a entrada aceitar a escrita) através do comando "echo":</para><screen>
|
|
<![CDATA[# echo "1" >/proc/sys/net/ipv6/conf/all/forwarding
|
|
]]></screen></sect3></sect2><sect2>
|
|
<title>Usando "sysctl"</title>
|
|
<para>O uso do programa "syysctl" para acessar as chaves do kernel é uma maneira moderna utilizada hoje em dia. Voce também pode usar se o sistema de arquivos /proc não estiver montado. Mas voce só terá acesso às entradas /proc/sys/*!</para>
|
|
<para>O programa "sysctl" está incluído no pacote "procps" (em sistemas Red Hat Linux).</para><itemizedlist>
|
|
<listitem><para>A interface do sysctl deve estar habilitada no kernel, então a seguinte chave deve estar habilitada</para></listitem></itemizedlist><screen>
|
|
<![CDATA[CONFIG_SYSCTL=y
|
|
]]></screen><sect3>
|
|
<title>Obtendo um valor</title>
|
|
<para>O valor de uma entrada pode ser obtida da seguinte maneira:</para><screen>
|
|
<![CDATA[# sysctl net.ipv6.conf.all.forwarding
|
|
net.ipv6.conf.all.forwarding = 0
|
|
]]></screen></sect3><sect3>
|
|
<title>Definindo um valor</title>
|
|
<para>Um novo valor pode ser definido (se a entrada aceitar a escrita):</para><screen>
|
|
<![CDATA[# sysctl -w net.ipv6.conf.all.forwarding=1
|
|
net.ipv6.conf.all.forwarding = 1
|
|
]]></screen><para>Nota: Não use espaços entre o sinal = para definir os valores. Se forem possíveis diversos valores, coloque-os entre aspas</para><screen>
|
|
<![CDATA[# sysctl -w net.ipv4.ip_local_port_range="32768 61000"
|
|
net.ipv4.ip_local_port_range = 32768 61000
|
|
]]></screen></sect3><sect3>
|
|
<title>Adicionais</title>
|
|
<para>Nota: Existem versões em campo que mostram "/" ao invés de "."</para>
|
|
<para>Para mais detalhes, de uma olhada na manpage do sysctl.</para>
|
|
<para>Dica: para achar mais rapidamente as definiçoes, use a opçao "-a" (mostra todas as entradas) junto com o comando "grep".</para></sect3></sect2><sect2>
|
|
<title>Valores encontrados nas entradas /proc</title>
|
|
<para>Existem vários formatos vistos no sistema de arquivos /proc:</para><itemizedlist>
|
|
<listitem><para>BOOLEANO: simplesmente um "0" (falso) ou um "1" (verdadeiro)</para></listitem><listitem><para>INTEIRO: um valor inteiro, também pode ser sem sinal</para></listitem><listitem><para>linhas mais sofisticadas com muitos valores: às vezes uma linha de cabeçalho também é mostrada, senão, uma olhada no código fonte do kernel pode ser necessário para entender o significado dos valores apresentados...</para></listitem></itemizedlist></sect2></sect1><sect1 id='proc-sys-net-ipv6.' >
|
|
<title><!-- anchor id="proc-sys-net-ipv6." -->Entradas em /proc/sys/net/ipv6/</title>
|
|
<sect2>
|
|
<title>conf/default/*</title>
|
|
<para>Muda as configurações específicas da interface.</para></sect2><sect2>
|
|
<title>conf/all/*</title>
|
|
<para>Muda todas as configurações esoecíficas da interface.</para>
|
|
<para>Exceção: "conf/all/forwarding" tem um significado diferente aqui</para><sect3>
|
|
<title>conf/all/forwarding</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: BOOLEANO</para></listitem></itemizedlist><para>Isto habilita o encaminhamento de pacotes IPv6 entre todas as interfaces.</para>
|
|
<para>Em IPv6 voce não pode controlar o envio de pacotes por dispositivo. este encaminhamento deve ser feito através de regras do IPv6-netfilter (controlado com ip6tables) e especificando os dispositivos de entrada e saída (veja <link linkend="firewalling-netfilter6.">Firewalling/Netfilter6</link> para mais detalhes). Isto é diferente no IPv4, onde é possível controlar o encaminhamento por dispositivo (a decisão é feita na interface onde o pacote entra).</para>
|
|
<para>Isto também define todas as interfaces do host e/ou router para o valor especificado. Veja os detalhes abaixo. Esta definição refere-se ao encaminhamento global.</para>
|
|
<para>Se este valor é 0, nenhum pacote IPv6 é encaminhado, os pacotes nunca deixarão outra interface, seja ela física ou lógica, como os túneis.</para></sect3></sect2><sect2>
|
|
<title>conf/interface/*</title>
|
|
<para>Muda configurações especiais por interface.</para>
|
|
<para>O comportamento funcional de certos ajustes é diferente, dependendo se o encaminhamento local está habilitado ou não.</para><sect3>
|
|
<title>accept_ra</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: BOOLEAN</para></listitem><listitem><para>Ajuste default: habilitado se o encaminhamento local está desabilitado, e desabilitado se o encaminhamento local está habilitado.</para></listitem></itemizedlist><para>Aceita Router Advertisements, e configura automaticamente esta interface com os dados recebidos.</para></sect3><sect3>
|
|
<title>accept_redirects</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipi: BOOLEAN</para></listitem><listitem><para>Ajuste default: habilitado se o encaminhamento local está desabilitado, e desabilitado se o encaminhamento local está habilitado.</para></listitem></itemizedlist><para>Aceita os Redirects enviados por um router IPv6.</para></sect3><sect3>
|
|
<title>autoconf</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: BOOLEAN</para></listitem><listitem><para>Ajuste default: habilitado se o accept_ra_pinfo está babilitado, e desabilitado se o accept_ra_pinfo estiver desabilitado.</para></listitem></itemizedlist><para>Os endereços e prefixos usados na configuração automática proveem de anúncios dos routers.</para></sect3><sect3>
|
|
<title>dad_transmits</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 1</para></listitem></itemizedlist><para>Quantidade de probes de detecção de endereços duplicados enviados.</para></sect3><sect3>
|
|
<title>forwarding</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: BOOLEAN</para></listitem><listitem><para>Default: FALSE se o encaminhamento global estiver desabilitado (default), caso contrário TRUE</para></listitem></itemizedlist><para>Comportamento Host/Router específico.</para>
|
|
<para>Nota: É recomendado ter a mesma configuração em todas as interfaces; cenários diferentes são bem incomuns.</para><itemizedlist>
|
|
<listitem><para>Valor FALSE: Por default, o comportamento do Host é assumido. Isto significa:</para></listitem></itemizedlist><orderedlist>
|
|
<listitem><para>O flag IsRouter não está definido em aúncios de vizinhança.</para></listitem><listitem><para>Solicitaçoes Router são enviados quando necessário.</para></listitem><listitem><para>Se accept_ra é TRUE (default), aceita anúncios router (e fazem auti configuração).</para></listitem><listitem><para>Se accept_redirects é TRUE (default), aceita Redirects.</para></listitem></orderedlist><itemizedlist>
|
|
<listitem><para>Valor TRUE: se o encaminhamento local está habilitado, o comportamento Router é assumido. Isto significa que o contrário da lista acima pode acontecer:</para></listitem></itemizedlist><orderedlist>
|
|
<listitem><para>O flag IsRouter é definido nos anúncios de vizinhança.</para></listitem><listitem><para>Solicitaçoes Router não são enviadas.</para></listitem><listitem><para>Anúncios Router são ignorados.</para></listitem><listitem><para>Redirects são ignorados.</para></listitem></orderedlist></sect3><sect3>
|
|
<title>hop_limit</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 64</para></listitem></itemizedlist><para>Hop Limit default para definir.</para></sect3><sect3>
|
|
<title>mtu</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 1280 (mínimo necessário no IPv6)</para></listitem></itemizedlist><para>Default Maximum Transfer Unit</para></sect3><sect3>
|
|
<title>router_solicitation_delay</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 1</para></listitem></itemizedlist><para>Número de segundos a esperar após a interface ser ativada antes de enviar solicitaçoes Router.</para></sect3><sect3>
|
|
<title>router_solicitation_interval</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 4</para></listitem></itemizedlist><para>Número de segundos a esperar entre solicitaçoes Router. </para></sect3><sect3>
|
|
<title>router_solicitations</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 3</para></listitem></itemizedlist><para>Número de solicitaçoes Router a enviar até assumir que não há um router presente.</para></sect3></sect2><sect2>
|
|
<title>neigh/default/*</title>
|
|
<para>Muda as definiçoes default para detecçao de vizinhos e alguns valores globais e de limites:</para><sect3>
|
|
<title>gc_thresh1</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 128</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>gc_thresh2</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 512</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>gc_thresh3</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 1024</para></listitem></itemizedlist><para>Parametro para o tamanho da tabela de vizinhança.</para>
|
|
<para>Aumente este valor se voce tem muitas interfaces e os routers começam a apresentar problemas misteriosos de funcionamento e falhas. Ou se uma mensagem dessas aparecer <ulink url="http://www.zebra.org/">Zebra (routing daemon)</ulink>:</para><screen>
|
|
<![CDATA[ZEBRA: netlink-listen error: No buffer space available, type=RTM_NEWROUTE(24),
|
|
¬ seq=426, pid=0
|
|
]]></screen></sect3><sect3>
|
|
<title>gc_interval</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 30</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3></sect2><sect2>
|
|
<title>neigh/interface/*</title>
|
|
<para>Muda ajustes especiais por interface para detecção de vizinhos.</para><sect3>
|
|
<title>anycast_delay</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 100</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>gc_stale_time</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 60</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>proxy_qlen</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 64</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>unres_qlen</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 3</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>app_solicit</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 0</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>locktime</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 0</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>retrans_time</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 100</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>base_reachable_time</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 30</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>mcast_solicit</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 3</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>ucast_solicit</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 3</para></listitem></itemizedlist><para>Precisa ser preenchido</para></sect3><sect3>
|
|
<title>delay_first_probe_time</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 5</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>proxy_delay</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 80</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3></sect2><sect2>
|
|
<title>route/*</title>
|
|
<para>Ajustes globais para roteamento.</para><sect3>
|
|
<title>flush</title>
|
|
<para>Removido nas novas versões de kernel - Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>gc_interval</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 30</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>gc_thresh</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 1024</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>mtu_expires</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 600</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>gc_elasticity</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 0</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>gc_min_interval</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 5</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>gc_timeout</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 60</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>min_adv_mss</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 12</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3><sect3>
|
|
<title>max_size</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: INTEGER</para></listitem><listitem><para>Default: 4096</para></listitem></itemizedlist><para>Precisa ser preenchido.</para></sect3></sect2></sect1><sect1 id='proc-sys-net-ipv4.' >
|
|
<title><!-- anchor id="proc-sys-net-ipv4." -->Entradas relacionadas a IPv6 em /proc/sys/net/ipv4/</title>
|
|
<para>Neste momento (e será até que o IPv6 seja completamente convertido para um módulo independente do kernel) algumas chaves para IPv6 são usadas aqui.</para><sect2>
|
|
<title>ip_*</title>
|
|
<sect3>
|
|
<title>ip_local_port_range</title>
|
|
<para>Esta definição também é usada para o IPv6.</para></sect3></sect2><sect2>
|
|
<title>tcp_*</title>
|
|
<para>Esta definição também é usada para o IPv6.</para></sect2><sect2>
|
|
<title>icmp_*</title>
|
|
<para>Esta definição não é usada para o IPv6. Para habilitar o limite ICMPv6 (o que é muito recomendado) regras netfilter-v6 devem ser usadas.</para></sect2><sect2>
|
|
<title>others</title>
|
|
<para>Desconhecido, mas provavelmente não usado pelo IPv6.</para></sect2></sect1><sect1 id='proc-net' >
|
|
<title><!-- anchor id="proc-net" -->Entradas em /proc/net relacionadas com IPv6</title>
|
|
<para>No /proc/net existem diversas variáveis disponíveis, somente para leitura, Não é possível obter informaçoes através do "sysctl", então utilize "cat".</para><sect2>
|
|
<title>if_inet6</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: Uma linha por endereço contendo vários valores</para></listitem></itemizedlist><para>Aqui todos os endereços IPv6 cpnfigurados são mostrados em um formato especial. O exemplo mostra somente a interface de loopback. O significado é mostrado abaixo (veja "net/ipv6/addrconf.c" para mais informações).</para><screen>
|
|
<![CDATA[# cat /proc/net/if_inet6
|
|
00000000000000000000000000000001 01 80 10 80 lo
|
|
+------------------------------+ ++ ++ ++ ++ ++
|
|
| | | | | |
|
|
1 2 3 4 5 6
|
|
]]></screen><orderedlist>
|
|
<listitem><para>Endereço IPv6 mostrado em hexadecimal (32 caracteres) sem os dois pontos ":" como separadores</para></listitem><listitem><para>Número do dispositivo netlink (índice da interface) em hexadecimal (veja “ip addr” , também)</para></listitem><listitem><para>tamanho do prefixo, em hexadecimal</para></listitem><listitem><para>Valor do escopo (veja o fonte do kernel " include/net/ipv6.h" e "net/ipv6/addrconf.c" para mais informações)</para></listitem><listitem><para>Flags da interface (veja "include/linux/rtnetlink.h" e"net/ipv6/addrconf.c" para mais informações)</para></listitem><listitem><para>Nome do disppositivo</para></listitem></orderedlist></sect2><sect2>
|
|
<title>ipv6_route</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: Uma linha por rota contém várias valores</para></listitem></itemizedlist><para>Aqui toda a configuração de rotas em IPv6 é mostrada em um formato especialt. O exemplo mostra informações somente para a interface de loopback O significado é mostrado abaixo (veja "net/ipv6/route.c" para mais informações).</para><screen>
|
|
<![CDATA[# cat /proc/net/ipv6_route
|
|
00000000000000000000000000000000 00 00000000000000000000000000000000 00
|
|
+------------------------------+ ++ +------------------------------+ ++
|
|
| | | |
|
|
1 2 3 4
|
|
|
|
¬ 00000000000000000000000000000000 ffffffff 00000001 00000001 00200200 lo
|
|
¬ +------------------------------+ +------+ +------+ +------+ +------+ ++
|
|
¬ | | | | | |
|
|
¬ 5 6 7 8 9 10
|
|
]]></screen><orderedlist>
|
|
<listitem><para>Rede de destino IPv6 mostrada em hexadecimal (32 caracteres) som dois pontos ":" como separador</para></listitem><listitem><para>Tamanho do prefixo de destino, em hexadecimal</para></listitem><listitem><para>Rede de origem IPv6 mostrada em hexadecimal (32 caracteres) som dois pontos ":" como separador</para></listitem><listitem><para>Tamanho do prefixo de origem, em hexadecimal</para></listitem><listitem><para>Próximo salto IPv6 mostrado em hexadecimal (32 caracteres) som dois pontos ":" como separador</para></listitem><listitem><para>Métrica em hexadecimal</para></listitem><listitem><para>Contador de referencia</para></listitem><listitem><para>Contadoer de uso</para></listitem><listitem><para>Flags</para></listitem><listitem><para>Nome do dispositivo</para></listitem></orderedlist></sect2><sect2>
|
|
<title>sockstat6</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: Uma linha por protocolo, com descrição e valor</para></listitem></itemizedlist><para>Estatísticas sobre o uso de sockets IPv6. Exemplo:</para><screen>
|
|
<![CDATA[# cat /proc/net/sockstat6
|
|
TCP6: inuse 7
|
|
UDP6: inuse 2
|
|
RAW6: inuse 1
|
|
FRAG6: inuse 0 memory 0
|
|
]]></screen></sect2><sect2>
|
|
<title>tcp6</title>
|
|
<para>Precisa ser preenchido.</para></sect2><sect2>
|
|
<title>udp6</title>
|
|
<para>Precisa ser preenchido.</para></sect2><sect2>
|
|
<title>igmp6</title>
|
|
<para>Precisa ser preenchido.</para></sect2><sect2>
|
|
<title>raw6</title>
|
|
<para>Precisa ser preenchido.</para></sect2><sect2>
|
|
<title>ip6_flowlabel</title>
|
|
<para>Precisa ser preenchido.</para></sect2><sect2>
|
|
<title>rt6_stats</title>
|
|
<para>Precisa ser preenchido.</para></sect2><sect2>
|
|
<title>snmp6</title>
|
|
<itemizedlist>
|
|
<listitem><para>Tipo: Uma linha por descrição SNMP e valor</para></listitem></itemizedlist><para>Estatísticas SNMP podem ser obtidas via um servidor SNMP e suas MIB's relacionadas, através um software de gerencia de rede.</para></sect2><sect2>
|
|
<title>ip6_tables_names</title>
|
|
<para>Tabelas netfilter6 disponíveis</para></sect2></sect1></chapter><chapter id='netlink' >
|
|
<title><!-- anchor id="netlink" -->Netlink-Interface to kernel</title>
|
|
<para>To be filled...I have no experience with that...</para></chapter><chapter id='resolver' >
|
|
<title><!-- anchor id="resolver" -->Address Resolver</title>
|
|
<para>Name to IPv4 or IPv6 address resolving is usually done using a libc resolver library. There are some issues known using the function <emphasis>getaddrinfo</emphasis>.</para>
|
|
<para>More info can be found at <ulink url="http://www.bieringer.de/linux/IPv6/getaddrinfo/">Linux & IPv6: getaddrinfo and search domains - Research</ulink> and <ulink url="http://people.redhat.com/drepper/linux-rfc3484.html">RFC 3484 on Linux</ulink>.</para>
|
|
<para>
|
|
More to be filled later...</para></chapter><chapter id='network-debugging' >
|
|
<title><!-- anchor id="network-debugging" -->Network debugging</title>
|
|
<sect1>
|
|
<title>Server socket binding</title>
|
|
<sect2>
|
|
<title>Using “netstat” for server socket binding check</title>
|
|
<para>It's always interesting which server sockets are currently active on a node. Using “netstat” is a short way to get such information: </para>
|
|
<para>Used options: -nlptu</para>
|
|
<para>Example:</para><screen>
|
|
<![CDATA[# netstat -nlptu
|
|
Active Internet connections (only servers)
|
|
Proto Recv-Q Send-Q Local Address Foreign Address State
|
|
¬ PID/Program name
|
|
tcp 0 0 0.0.0.0:32768 0.0.0.0:* LISTEN
|
|
¬ 1258/rpc.statd
|
|
tcp 0 0 0.0.0.0:32769 0.0.0.0:* LISTEN
|
|
¬ 1502/rpc.mountd
|
|
tcp 0 0 0.0.0.0:515 0.0.0.0:* LISTEN
|
|
¬ 22433/lpd Waiting
|
|
tcp 0 0 1.2.3.1:139 0.0.0.0:* LISTEN
|
|
¬ 1746/smbd
|
|
tcp 0 0 0.0.0.0:111 0.0.0.0:* LISTEN
|
|
¬ 1230/portmap
|
|
tcp 0 0 0.0.0.0:6000 0.0.0.0:* LISTEN
|
|
¬ 3551/X
|
|
tcp 0 0 1.2.3.1:8081 0.0.0.0:* LISTEN
|
|
¬ 18735/junkbuster
|
|
tcp 0 0 1.2.3.1:3128 0.0.0.0:* LISTEN
|
|
¬ 18822/(squid)
|
|
tcp 0 0 127.0.0.1:953 0.0.0.0:* LISTEN
|
|
¬ 30734/named
|
|
tcp 0 0 ::ffff:1.2.3.1:993 :::* LISTEN
|
|
¬ 6742/xinetd-ipv6
|
|
tcp 0 0 :::13 :::* LISTEN
|
|
¬ 6742/xinetd-ipv6
|
|
tcp 0 0 ::ffff:1.2.3.1:143 :::* LISTEN
|
|
¬ 6742/xinetd-ipv6
|
|
tcp 0 0 :::53 :::* LISTEN
|
|
¬ 30734/named
|
|
tcp 0 0 :::22 :::* LISTEN
|
|
¬ 1410/sshd
|
|
tcp 0 0 :::6010 :::* LISTEN
|
|
¬ 13237/sshd
|
|
udp 0 0 0.0.0.0:32768 0.0.0.0:*
|
|
¬ 1258/rpc.statd
|
|
udp 0 0 0.0.0.0:2049 0.0.0.0:*
|
|
¬ -
|
|
udp 0 0 0.0.0.0:32770 0.0.0.0:*
|
|
¬ 1502/rpc.mountd
|
|
udp 0 0 0.0.0.0:32771 0.0.0.0:*
|
|
¬ -
|
|
udp 0 0 1.2.3.1:137 0.0.0.0:*
|
|
¬ 1751/nmbd
|
|
udp 0 0 0.0.0.0:137 0.0.0.0:*
|
|
¬ 1751/nmbd
|
|
udp 0 0 1.2.3.1:138 0.0.0.0:*
|
|
¬ 1751/nmbd
|
|
udp 0 0 0.0.0.0:138 0.0.0.0:*
|
|
¬ 1751/nmbd
|
|
udp 0 0 0.0.0.0:33044 0.0.0.0:*
|
|
¬ 30734/named
|
|
udp 0 0 1.2.3.1:53 0.0.0.0:*
|
|
¬ 30734/named
|
|
udp 0 0 127.0.0.1:53 0.0.0.0:*
|
|
¬ 30734/named
|
|
udp 0 0 0.0.0.0:67 0.0.0.0:*
|
|
¬ 1530/dhcpd
|
|
udp 0 0 0.0.0.0:67 0.0.0.0:*
|
|
¬ 1530/dhcpd
|
|
udp 0 0 0.0.0.0:32858 0.0.0.0:*
|
|
¬ 18822/(squid)
|
|
udp 0 0 0.0.0.0:4827 0.0.0.0:*
|
|
¬ 18822/(squid)
|
|
udp 0 0 0.0.0.0:111 0.0.0.0:*
|
|
¬ 1230/portmap
|
|
udp 0 0 :::53 :::*
|
|
¬ 30734/named
|
|
]]></screen></sect2></sect1><sect1 id='examples-tcpdump' >
|
|
<title><!-- anchor id="examples-tcpdump" -->Examples for tcpdump packet dumps</title>
|
|
<para>Here some examples of captured packets are shown, perhaps useful for your own debugging...</para>
|
|
<para>...more coming next...</para><sect2>
|
|
<title>Router discovery</title>
|
|
<sect3>
|
|
<title>Router advertisement</title>
|
|
<screen>
|
|
<![CDATA[15:43:49.484751 fe80::212:34ff:fe12:3450 > ff02::1: icmp6: router
|
|
¬ advertisement(chlim=64, router_ltime=30, reachable_time=0,
|
|
¬ retrans_time=0)(prefix info: AR valid_ltime=30, preffered_ltime=20,
|
|
¬ prefix=2002:0102:0304:1::/64)(prefix info: LAR valid_ltime=2592000,
|
|
¬ preffered_ltime=604800, prefix=2001:0db8:0:1::/64)(src lladdr:
|
|
¬ 0:12:34:12:34:50) (len 88, hlim 255)
|
|
]]></screen><para>Router with link-local address “fe80::212:34ff:fe12:3450” send an advertisement to the all-node-on-link multicast address “ff02::1” containing two prefixes “2002:0102:0304:1::/64” (lifetime 30 s) and “2001:0db8:0:1::/64” (lifetime 2592000 s) including its own layer 2 MAC address “0:12:34:12:34:50”.</para></sect3><sect3>
|
|
<title>Router solicitation</title>
|
|
<screen>
|
|
<![CDATA[15:44:21.152646 fe80::212:34ff:fe12:3456 > ff02::2: icmp6: router solicitation
|
|
¬ (src lladdr: 0:12:34:12:34:56) (len 16, hlim 255)
|
|
]]></screen><para>Node with link-local address “fe80::212:34ff:fe12:3456” and layer 2 MAC address “0:12:34:12:34:56” is looking for a router on-link, therefore sending this solicitation to the all-router-on-link multicast address “ff02::2”.</para></sect3></sect2><sect2>
|
|
<title>Neighbor discovery</title>
|
|
<sect3>
|
|
<title>Neighbor discovery solicitation for duplicate address detection</title>
|
|
<para>Following packets are sent by a node with layer 2 MAC address “0:12:34:12:34:56” during autoconfiguration to check whether a potential address is already used by another node on the link sending this to the solicited-node link-local multicast address.</para><itemizedlist>
|
|
<listitem><para>Node wants to configure its link-local address “fe80::212:34ff:fe12:3456”, checks for duplicate now</para></listitem></itemizedlist><screen>
|
|
<![CDATA[15:44:17.712338 :: > ff02::1:ff12:3456: icmp6: neighbor sol: who has
|
|
¬ fe80::212:34ff:fe12:3456(src lladdr: 0:12:34:12:34:56) (len 32, hlim 255)
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>Node wants to configure its global address “2002:0102:0304:1:212:34ff:fe12:3456” (after receiving advertisement shown above), checks for duplicate now</para></listitem></itemizedlist><screen>
|
|
<![CDATA[15:44:21.905596 :: > ff02::1:ff12:3456: icmp6: neighbor sol: who has
|
|
¬ 2002:0102:0304:1:212:34ff:fe12:3456(src lladdr: 0:12:34:12:34:56) (len 32,
|
|
¬ hlim 255)
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>Node wants to configure its global address “2001:0db8:0:1:212:34ff:fe12:3456” (after receiving advertisement shown above), checks for duplicate now</para></listitem></itemizedlist><screen>
|
|
<![CDATA[15:44:22.304028 :: > ff02::1:ff12:3456: icmp6: neighbor sol: who has
|
|
¬ 2001:0db8:0:1:212:34ff:fe12:3456(src lladdr: 0:12:34:12:34:56) (len 32, hlim
|
|
¬ 255)
|
|
]]></screen></sect3><sect3>
|
|
<title>Neighbor discovery solicitation for looking for host or gateway</title>
|
|
<itemizedlist>
|
|
<listitem><para>Node wants to send packages to “2001:0db8:0:1::10” but has no layer 2 MAC address to send packet, so send solicitation now</para></listitem></itemizedlist><screen>
|
|
<![CDATA[13:07:47.664538 2002:0102:0304:1:2e0:18ff:fe90:9205 > ff02::1:ff00:10: icmp6:
|
|
¬ neighbor sol: who has 2001:0db8:0:1::10(src lladdr: 0:e0:18:90:92:5) (len 32,
|
|
¬ hlim 255)
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>Node looks for “fe80::10” now</para></listitem></itemizedlist><screen>
|
|
<![CDATA[13:11:20.870070 fe80::2e0:18ff:fe90:9205 > ff02::1:ff00:10: icmp6: neighbor
|
|
¬ sol: who has fe80::10(src lladdr: 0:e0:18:90:92:5) (len 32, hlim 255)
|
|
]]></screen></sect3></sect2></sect1></chapter><chapter id='chapter-support-persistent-configuration' >
|
|
<title><!-- anchor id="chapter-support-persistent-configuration" -->Support for persistent IPv6 configuration in Linux distributions</title>
|
|
<para>Some Linux distribution contain already support of a persistent IPv6 configuration using existing or new configuration and script files and some hook in the IPv4 script files.</para><sect1>
|
|
<title>Red Hat Linux and “clones”</title>
|
|
<para>Since starting writing the <ulink url="http://www.bieringer.de/linux/IPv6/">IPv6 & Linux - HowTo</ulink> it was my intention to enable a persistent IPv6 configuration which catch most of the wished cases like host-only, router-only, dual-homed-host, router with second stub network, normal tunnels, 6to4 tunnels, and so on. Nowadays there exists a set of configuration and script files which do the job very well (never heard about real problems, but I don't know how many use the set). Because this configuration and script files are extended from time to time, they got their own homepage: <ulink url="http://www.deepspace6.net/projects/initscripts-ipv6.html">initscripts-ipv6 homepage</ulink> (<ulink url="http://mirrors.bieringer.de/www.deepspace6.net/projects/initscripts-ipv6.html">Mirror</ulink>). Because I began my IPv6 experience using a Red Hat Linux 5.0 clone, my IPv6 development systems are mostly Red Hat Linux based now, it's kind a logic that the scripts are developed for this kind of distribution (so called <emphasis>historic issue</emphasis>). Also it was very easy to extend some configuration files, create new ones and create some simple hook for calling IPv6 setup during IPv4 setup.</para>
|
|
<para>Fortunately, in Red Hat Linux since 7.1 a snapshot of my IPv6 scripts is included, this was and is still further on assisted by Pekka Savola.</para>
|
|
<para>Mandrake since version 8.0 also includes an IPv6-enabled initscript package, but a minor bug still prevents usage (“ifconfig” misses “inet6” before “add”).</para><sect2>
|
|
<title>Test for IPv6 support of network configuration scripts</title>
|
|
<para>You can test, whether your Linux distribution contain support for persistent IPv6 configuration using my set. Following script library should exist:</para><screen>
|
|
<![CDATA[/etc/sysconfig/network-scripts/network-functions-ipv6
|
|
]]></screen><para>Auto-magically test:</para><screen>
|
|
<![CDATA[# test -f /etc/sysconfig/network-scripts/network-functions-ipv6 && echo "Main
|
|
¬ IPv6 script library exists"
|
|
]]></screen><para>The version of the library is important if you miss some features. You can get it executing following (or easier look at the top of the file):</para><screen>
|
|
<![CDATA[# source /etc/sysconfig/network-scripts/network-functions-ipv6 &&
|
|
¬ getversion_ipv6_functions
|
|
20011124
|
|
]]></screen><para>In shown example, the used version is 20011124. Check this against latest information on <ulink url="http://www.deepspace6.net/projects/initscripts-ipv6.html">initscripts-ipv6 homepage</ulink> (<ulink url="http://mirrors.bieringer.de/www.deepspace6.net/projects/initscripts-ipv6.html">Mirror</ulink>) to see what has been changed. You will find there also a change-log.</para></sect2><sect2>
|
|
<title>Short hint for enabling IPv6 on current RHL 7.1, 7.2, 7.3, ...</title>
|
|
<itemizedlist>
|
|
<listitem><para>Check whether running system has already IPv6 module loaded</para></listitem></itemizedlist><screen>
|
|
<![CDATA[# modprobe -c | grep net-pf-10
|
|
alias net-pf-10 off
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>If result is “off”, then enable IPv6 networking by editing /etc/sysconfig/network, add following new line</para></listitem></itemizedlist><screen>
|
|
<![CDATA[NETWORKING_IPV6=yes
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>Reboot or restart networking using</para></listitem></itemizedlist><screen>
|
|
<![CDATA[# service network restart
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>Now IPv6 module should be loaded</para></listitem></itemizedlist><screen>
|
|
<![CDATA[# modprobe -c | grep ipv6
|
|
alias net-pf-10 ipv6
|
|
]]></screen><para>If your system is on a link which provides router advertisement, autoconfiguration will be done automatically. For more information which settings are supported see /usr/share/doc/initscripts-$version/sysconfig.txt.</para></sect2></sect1><sect1>
|
|
<title>SuSE Linux</title>
|
|
<para>In newer 7.x versions there is a really rudimentary support available, see /etc/rc.config for details.</para>
|
|
<para>Because of the really different configuration and script file structure it is hard (or impossible) to use the set for Red Hat Linux and clones with this distribution.
|
|
In versions 8.x they completly change their configuration setup. </para><sect2>
|
|
<title>SuSE Linux 7.3</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.feyrer.de/IPv6/SuSE73-IPv6+6to4-setup.html">How to setup 6to4 IPv6 with SuSE 7.3</ulink></para></listitem></itemizedlist></sect2><sect2>
|
|
<title>SuSE Linux 8.0</title>
|
|
<sect3>
|
|
<title>IPv6 address configuration</title>
|
|
<para>Edit file /etc/sysconfig/network/ifcfg-<Interface-Name> and setup following value</para><screen>
|
|
<![CDATA[IP6ADDR="<ipv6-address>/<prefix>"
|
|
]]></screen></sect3><sect3>
|
|
<title>Additional information</title>
|
|
<para>See file /usr/share/doc/packages/sysconfig/README</para></sect3></sect2><sect2>
|
|
<title>SuSE Linux 8.1</title>
|
|
<sect3>
|
|
<title>IPv6 address configuration</title>
|
|
<para>Edit file /etc/sysconfig/network/ifcfg-<Interface-Name> and setup following value</para><screen>
|
|
<![CDATA[IPADDR="<ipv6-address>/<prefix>"
|
|
]]></screen></sect3><sect3>
|
|
<title>Additional information</title>
|
|
<para>See file /usr/share/doc/packages/sysconfig/Network </para></sect3></sect2></sect1><sect1 id='Configuration-Debian-Linux' >
|
|
<title><!-- anchor id="Configuration-Debian-Linux" -->Debian Linux</title>
|
|
<para>Following information was contributed by Stephane Bortzmeyer <bortzmeyer at nic dot fr></para><orderedlist>
|
|
<listitem><para>Be sure that IPv6 is loaded, either because it is compiled into the kernel or because the module is loaded. For the latest, three solutions, adding it to /etc/modules, using the pre-up trick shown later or using kmod (not detailed here).</para></listitem><listitem><para>Configure your interface. Here we assume eth0 and address (2001:0db8:1234:5::1:1). Edit /etc/network/interfaces:</para></listitem></orderedlist><screen>
|
|
<![CDATA[iface eth0 inet6 static
|
|
pre-up modprobe ipv6
|
|
address 2001:0db8:1234:5::1:1
|
|
# To suppress completely autoconfiguration:
|
|
# up echo 0 > /proc/sys/net/ipv6/conf/all/autoconf
|
|
netmask 64
|
|
# The router is autoconfigured and has no fixed address.
|
|
# It is magically
|
|
# found. (/proc/sys/net/ipv6/conf/all/accept_ra). Otherwise:
|
|
#gateway 2001:0db8:1234:5::1
|
|
]]></screen><para>And you reboot or you just</para><screen>
|
|
<![CDATA[# ifup --force eth0
|
|
]]></screen><para>and you have your static address. </para><sect2>
|
|
<title>Further information</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://ipv6.debian.net/">IPv6 with Debian Linux</ulink></para></listitem><listitem><para>Jean-Marc V. Liotier's <ulink url="http://www.ruwenzori.net/ipv6/Jims_LAN_IPv6_global_connectivity_howto.html">HOWTO for Freenet6 & Debian Users</ulink> (announced 24.12.2002 on <link linkend="information-maillists">mailinglist</link> users@ipv6.org )</para></listitem></itemizedlist></sect2></sect1></chapter><chapter id='chapter-autoconfiguration' >
|
|
<title><!-- anchor id="chapter-autoconfiguration" -->Auto-configuration</title>
|
|
<sect1>
|
|
<title>Stateless auto-configuration</title>
|
|
<para>Is supported and seen on the assigned link-local address after an IPv6-enabled interface is up.</para>
|
|
<para>Example:</para><screen>
|
|
<![CDATA[# ip -6 addr show dev eth0 scope link
|
|
2: eth0: <BROADCAST,MULTICAST,UP> mtu 1500 qlen1000
|
|
inet6 fe80::211:d8ff:fe6b:f0f5/64 scope link
|
|
valid_lft forever preferred_lft forever
|
|
]]></screen></sect1><sect1>
|
|
<title>Stateful auto-configuration using Router Advertisement Daemon (radvd)</title>
|
|
<para>to be filled. See <link linkend="hints-daemons-radvd">radvd daemon autoconfiguration</link> below.</para></sect1><sect1>
|
|
<title>Dynamic Host Configuration Protocol v6 (DHCPv6)</title>
|
|
<para>After a long time discussing issues, finally <ulink url="http://www.faqs.org/rfcs/rfc3315.html">RFC 3315 / Dynamic Host Configuration Protocol for IPv6 (DHCPv6)</ulink> was finished. At time updating this part (10/2005) currently two implementations are available:</para><itemizedlist>
|
|
<listitem><para><ulink url="http://klub.com.pl/dhcpv6/">Dibbler</ulink> by Tomasz Mrugalski <thomson at klub dot com dot pl> (<link linkend="hints-daemons-dibbler">Hints for configuration</link>)</para></listitem><listitem><para><ulink url="http://dhcpv6.sourceforge.net/">DHCPv6 on Sourceforge</ulink> (<link linkend="hints-daemons-dhcpv6.">Hints for configuration</link>)</para></listitem><listitem><para><ulink url="http://www.isc.org/software/dhcp">ISC DHCP</ulink> (<link linkend="hints-daemons-isc-dhcp">Hints for configuration</link>)</para></listitem></itemizedlist></sect1></chapter><chapter id='chapter-mobility' >
|
|
<title><!-- anchor id="chapter-mobility" -->Mobility</title>
|
|
<sect1>
|
|
<title>Common information</title>
|
|
<sect2>
|
|
<title>Node Mobility</title>
|
|
<para>Support for IPv6 mobility can be enabled in Linux by installing the MIPL2 implementation found at: <ulink url="http://www.mobile-ipv6.org/">http://www.mobile-ipv6.org/</ulink></para>
|
|
<para>This implementation is compliant with RFC 3775. It is composed of a kernel patch and a mobility daemon called mip6d. Version 2.0.1 applies on Linux kernel 2.6.15.</para>
|
|
<para>Installation and setup are described in the <ulink url="http://tldp.org/HOWTO/Mobile-IPv6-HOWTO/">Linux Mobile IPv6 HOWTO</ulink>.</para></sect2><sect2>
|
|
<title>Network Mobility</title>
|
|
<para>There also exists an implementation of network mobility for Linux, it is called NEPL and is based on MIPL. It can also be downloaded from: <ulink url="http://www.mobile-ipv6.org/">http://www.mobile-ipv6.org/</ulink>.</para>
|
|
<para>The HOWTO document describing setup and configuration is available at: <ulink url="http://www.nautilus6.org/doc/nepl-howto/">http://www.nautilus6.org/doc/nepl-howto/</ulink>.</para></sect2><sect2>
|
|
<title>Links</title>
|
|
<itemizedlist>
|
|
<listitem><para>Mobile IPv6 for Linux (MIPL) project: <ulink url="http://www.mobile-ipv6.org/">http://www.mobile-ipv6.org/</ulink></para></listitem><listitem><para>Nautilus6 working group: <ulink url="http://nautilus6.org/">http://nautilus6.org/</ulink></para></listitem><listitem><para>Fast Handovers for Mobile IPv6 for Linux project: <ulink url="http://www.fmipv6.org/">http://www.fmipv6.org/</ulink></para></listitem><listitem><para>USAGI-patched Mobile IPv6 for Linux (UMIP):<ulink url="http://umip.linux-ipv6.org/">http://umip.linux-ipv6.org/</ulink></para></listitem><listitem><para>Deploying IPsec/IKE-protected MIPv6 under Linux:<ulink url="http://natisbad.org/MIPv6/">http://natisbad.org/MIPv6/</ulink></para></listitem><listitem><para><ulink url="http://www.faqs.org/rfcs/rfc3775.html">RFC 3775 / Mobility Support in IPv6</ulink></para></listitem><listitem><para><ulink url="http://www.faqs.org/rfcs/rfc3776.html">RFC 3776 / Using IPsec to Protect Mobile IPv6 Signaling Between Mobile Nodes and Home Agents</ulink></para></listitem><listitem><para><ulink url="http://www.faqs.org/rfcs/rfc3963.html">RFC 3963 / Network Mobility (NEMO)</ulink></para></listitem><listitem><para><ulink url="http://www.faqs.org/rfcs/rfc4068.html">RFC 4068 / Fast Handovers for Mobile IPv6</ulink></para></listitem><listitem><para><ulink url="http://www.faqs.org/rfcs/rfc4423.html">RFC 4423 / Host Identity Protocol (HIP) Architecture</ulink></para></listitem><listitem><para><ulink url="http://www.faqs.org/rfcs/rfc5201.html">RFC 5201 / Host Identity Protocol</ulink></para></listitem><listitem><para>HIP implementations: <ulink url="http://infrahip.hiit.fi/">http://infrahip.hiit.fi/</ulink>, <ulink url="http://hip4inter.net/">http://hip4inter.net/</ulink>, <ulink url="http://www.openhip.org/">http://www.openhip.org/</ulink></para></listitem></itemizedlist></sect2></sect1></chapter><chapter id='chapter-firewalling-security' >
|
|
<title><!-- anchor id="chapter-firewalling-security" -->Firewalling</title>
|
|
<para>IPv6 firewalling is important, especially if using IPv6 on internal networks with global IPv6 addresses. Because unlike at IPv4 networks where in common internal hosts are protected automatically using private IPv4 addresses like <ulink url="http://www.faqs.org/rfcs/rfc1918.html">RFC 1918 / Address Allocation for Private Internets</ulink> or Automatic Private IP Addressing (APIPA)<ulink url="http://www.google.com/search?q=apipa+microsoft">Google search for Microsoft + APIPA</ulink>, in IPv6 normally global addresses are used and someone with IPv6 connectivity can reach all internal IPv6 enabled nodes.</para><sect1 id='firewalling-netfilter6.' >
|
|
<title><!-- anchor id="firewalling-netfilter6." -->Firewalling using netfilter6 </title>
|
|
<para>Native IPv6 firewalling is only supported in kernel versions 2.4+. In older 2.2- you can only filter IPv6-in-IPv4 by protocol 41. </para>
|
|
<para>Attention: no warranty that described rules or examples can really protect your system! </para>
|
|
<para>Audit your ruleset after installation, see <xref linkend="IPv6-security-auditing"> for more.</para>
|
|
<para>Since kernel version 2.6.20 IPv6 connection tracking is fully working (and does not break IPv4 NAT anymore like versions before)</para><sect2>
|
|
<title>More information</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.netfilter.org/">Netfilter project</ulink></para></listitem><listitem><para><ulink url="https://lists.netfilter.org/mailman/listinfo/netfilter">maillist archive of netfilter users</ulink></para></listitem><listitem><para><ulink url="https://lists.netfilter.org/mailman/listinfo/netfilter-devel">maillist archive of netfilter developers</ulink></para></listitem><listitem><para><ulink url="http://www.bieringer.de/linux/IPv6/status/IPv6+Linux-status-kernel.html#netfilter6 ">Unofficial status informations</ulink></para></listitem></itemizedlist></sect2></sect1><sect1>
|
|
<title>Preparation</title>
|
|
<para>This step is only needed if distributed kernel and netfilter doesn't fit your requirements and new features are available but still not built-in.</para><sect2>
|
|
<title>Get sources</title>
|
|
<para>Get the latest kernel source: <ulink url="http://www.kernel.org/">http://www.kernel.org/</ulink></para>
|
|
<para>Get the latest iptables package: </para><itemizedlist>
|
|
<listitem><para>Source tarball (for kernel patches): <ulink url="http://www.netfilter.org/">http://www.netfilter.org/</ulink></para></listitem></itemizedlist></sect2><sect2>
|
|
<title>Extract sources</title>
|
|
<para>Change to source directory: </para><screen>
|
|
<![CDATA[# cd /path/to/src
|
|
]]></screen><para>Unpack and rename kernel sources </para><screen>
|
|
<![CDATA[# tar z|jxf kernel-version.tar.gz|bz2
|
|
# mv linux linux-version-iptables-version+IPv6
|
|
]]></screen><para>Unpack iptables sources </para><screen>
|
|
<![CDATA[# tar z|jxf iptables-version.tar.gz|bz2
|
|
]]></screen></sect2><sect2>
|
|
<title>Apply latest iptables/IPv6-related patches to kernel source</title>
|
|
<para>Change to iptables directory </para><screen>
|
|
<![CDATA[# cd iptables-version
|
|
]]></screen><para>Apply pending patches </para><screen>
|
|
<![CDATA[# make pending-patches KERNEL_DIR=/path/to/src/linux-version-iptables-version/
|
|
]]></screen><para>Apply additional IPv6 related patches (still not in the vanilla kernel included) </para><screen>
|
|
<![CDATA[# make patch-o-matic KERNEL_DIR=/path/to/src/linux-version-iptables-version/
|
|
]]></screen><para>Say yes at following options (iptables-1.2.2) </para><itemizedlist>
|
|
<listitem><para>ah-esp.patch </para></listitem><listitem><para>masq-dynaddr.patch (only needed for systems with dynamic IP assigned WAN connections like PPP or PPPoE) </para></listitem><listitem><para>ipv6-agr.patch.ipv6 </para></listitem><listitem><para>ipv6-ports.patch.ipv6 </para></listitem><listitem><para>LOG.patch.ipv6 </para></listitem><listitem><para>REJECT.patch.ipv6 </para></listitem></itemizedlist><para>Check IPv6 extensions </para><screen>
|
|
<![CDATA[# make print-extensions
|
|
Extensions found: IPv6:owner IPv6:limit IPv6:mac IPv6:multiport
|
|
]]></screen></sect2><sect2>
|
|
<title>Configure, build and install new kernel</title>
|
|
<para>Change to kernel sources </para><screen>
|
|
<![CDATA[# cd /path/to/src/linux-version-iptables-version/
|
|
]]></screen><para>Edit Makefile </para><screen>
|
|
<![CDATA[- EXTRAVERSION =
|
|
+ EXTRAVERSION = -iptables-version+IPv6-try
|
|
]]></screen><para>Run configure, enable IPv6 related </para><screen>
|
|
<![CDATA[ Code maturity level options
|
|
Prompt for development and/or incomplete code/drivers : yes
|
|
Networking options
|
|
Network packet filtering: yes
|
|
The IPv6 protocol: module
|
|
IPv6: Netfilter Configuration
|
|
IP6 tables support: module
|
|
All new options like following:
|
|
limit match support: module
|
|
MAC address match support: module
|
|
Multiple port match support: module
|
|
Owner match support: module
|
|
netfilter MARK match support: module
|
|
Aggregated address check: module
|
|
Packet filtering: module
|
|
REJECT target support: module
|
|
LOG target support: module
|
|
Packet mangling: module
|
|
MARK target support: module
|
|
]]></screen><para>Configure other related to your system, too </para>
|
|
<para>Compilation and installing: see the kernel section here and other HOWTOs </para></sect2><sect2>
|
|
<title>Rebuild and install binaries of iptables</title>
|
|
<para>Make sure, that upper kernel source tree is also available at /usr/src/linux/ </para>
|
|
<para>Rename older directory </para><screen>
|
|
<![CDATA[# mv /usr/src/linux /usr/src/linux.old
|
|
]]></screen><para>Create a new softlink </para><screen>
|
|
<![CDATA[# ln -s /path/to/src/linux-version-iptables-version /usr/src/linux
|
|
]]></screen><para>Rebuild SRPMS </para><screen>
|
|
<![CDATA[# rpm --rebuild /path/to/SRPMS/iptables-version-release.src.rpm
|
|
]]></screen><para>Install new iptables packages (iptables + iptables-ipv6) </para><itemizedlist>
|
|
<listitem><para>On RH 7.1 systems, normally, already an older version is installed, therefore use "freshen" </para></listitem></itemizedlist><screen>
|
|
<![CDATA[# rpm -Fhv /path/to/RPMS/cpu/iptables*-version-release.cpu.rpm
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>If not already installed, use "install" </para></listitem></itemizedlist><screen>
|
|
<![CDATA[# rpm -ihv /path/to/RPMS/cpu/iptables*-version-release.cpu.rpm
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>On RH 6.2 systems, normally, no kernel 2.4.x is installed, therefore the requirements don't fit. Use "--nodeps" to install it </para></listitem></itemizedlist><screen>
|
|
<![CDATA[# rpm -ihv --nodeps /path/to/RPMS/cpu/iptables*-version-release.cpu.rpm
|
|
]]></screen><para>Perhaps it's necessary to create a softlink for iptables libraries where iptables looks for them </para><screen>
|
|
<![CDATA[# ln -s /lib/iptables/ /usr/lib/iptables
|
|
]]></screen></sect2></sect1><sect1>
|
|
<title>Usage</title>
|
|
<sect2>
|
|
<title>Check for support</title>
|
|
<para>Load module, if so compiled </para><screen>
|
|
<![CDATA[# modprobe ip6_tables
|
|
]]></screen><para>Check for capability </para><screen>
|
|
<![CDATA[# [ ! -f /proc/net/ip6_tables_names ] && echo "Current kernel doesn't support
|
|
¬ 'ip6tables' firewalling (IPv6)!"
|
|
]]></screen></sect2><sect2>
|
|
<title>Learn how to use ip6tables</title>
|
|
<sect3>
|
|
<title>List all IPv6 netfilter entries </title>
|
|
<itemizedlist>
|
|
<listitem><para>Short </para></listitem></itemizedlist><screen>
|
|
<![CDATA[# ip6tables -L
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>Extended </para></listitem></itemizedlist><screen>
|
|
<![CDATA[# ip6tables -n -v --line-numbers -L
|
|
]]></screen></sect3><sect3>
|
|
<title>List specified filter </title>
|
|
<screen>
|
|
<![CDATA[# ip6tables -n -v --line-numbers -L INPUT
|
|
]]></screen></sect3><sect3>
|
|
<title>Insert a log rule at the input filter with options </title>
|
|
<screen>
|
|
<![CDATA[# ip6tables --table filter --append INPUT -j LOG --log-prefix "INPUT:"
|
|
¬ --log-level 7
|
|
]]></screen></sect3><sect3>
|
|
<title>Insert a drop rule at the input filter </title>
|
|
<screen>
|
|
<![CDATA[# ip6tables --table filter --append INPUT -j DROP
|
|
]]></screen></sect3><sect3>
|
|
<title>Delete a rule by number </title>
|
|
<screen>
|
|
<![CDATA[# ip6tables --table filter --delete INPUT 1
|
|
]]></screen></sect3><sect3>
|
|
<title>Enable connection tracking</title>
|
|
<para>Since kernel version 2.6.20 IPv6 connection tracking is well supported and should be used instead of using stateless filter rules.</para><screen>
|
|
<![CDATA[# ip6tables -A INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
|
|
]]></screen></sect3><sect3>
|
|
<title>Allow ICMPv6</title>
|
|
<para>Using older kernels (unpatched kernel 2.4.5 and iptables-1.2.2) no type can be specified</para><itemizedlist>
|
|
<listitem><para>Accept incoming ICMPv6 through tunnels </para></listitem></itemizedlist><screen>
|
|
<![CDATA[# ip6tables -A INPUT -i sit+ -p icmpv6 -j ACCEPT
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>Allow outgoing ICMPv6 through tunnels </para></listitem></itemizedlist><screen>
|
|
<![CDATA[# ip6tables -A OUTPUT -o sit+ -p icmpv6 -j ACCEPT
|
|
]]></screen><para>Newer kernels allow specifying of ICMPv6 types:</para><screen>
|
|
<![CDATA[# ip6tables -A INPUT -p icmpv6 --icmpv6-type echo-request -j ACCEPT
|
|
]]></screen></sect3><sect3>
|
|
<title>Rate-limiting</title>
|
|
<para>Because it can happen (author already saw it to times) that an ICMPv6 storm will raise up, you should use available rate limiting for at least ICMPv6 ruleset. In addition logging rules should also get rate limiting to prevent DoS attacks against syslog and storage of log file partition. An example for a rate limited ICMPv6 looks like:</para><screen>
|
|
<![CDATA[# ip6tables -A INPUT --protocol icmpv6 --icmpv6-type echo-request
|
|
¬ -j ACCEPT --match limit --limit 30/minute
|
|
]]></screen></sect3><sect3>
|
|
<title>Allow incoming SSH</title>
|
|
<para>Here an example is shown for a ruleset which allows incoming SSH connection from a specified IPv6 address </para><itemizedlist>
|
|
<listitem><para>Allow incoming SSH from 2001:0db8:100::1/128 </para></listitem></itemizedlist><screen>
|
|
<![CDATA[# ip6tables -A INPUT -i sit+ -p tcp -s 2001:0db8:100::1/128 --sport 512:65535
|
|
¬ --dport 22 -j ACCEPT
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>Allow response packets (no longer needed if connection tracking is used!) </para></listitem></itemizedlist><screen>
|
|
<![CDATA[# ip6tables -A OUTPUT -o sit+ -p tcp -d 2001:0db8:100::1/128 --dport 512:65535
|
|
¬ --sport 22 ! --syn -j ACCEPT
|
|
]]></screen></sect3><sect3>
|
|
<title>Enable tunneled IPv6-in-IPv4</title>
|
|
<para>To accept tunneled IPv6-in-IPv4 packets, you have to insert rules in your IPv4 firewall setup relating to such packets, for example </para><itemizedlist>
|
|
<listitem><para>Accept incoming IPv6-in-IPv4 on interface ppp0 </para></listitem></itemizedlist><screen>
|
|
<![CDATA[# iptables -A INPUT -i ppp0 -p ipv6 -j ACCEPT
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>Allow outgoing IPv6-in-IPv4 to interface ppp0 </para></listitem></itemizedlist><screen>
|
|
<![CDATA[# iptables -A OUTPUT -o ppp0 -p ipv6 -j ACCEPT
|
|
]]></screen><para>If you have only a static tunnel, you can specify the IPv4 addresses, too, like </para><itemizedlist>
|
|
<listitem><para>Accept incoming IPv6-in-IPv4 on interface ppp0 from tunnel endpoint 192.0.2.2</para></listitem></itemizedlist><screen>
|
|
<![CDATA[# iptables -A INPUT -i ppp0 -p ipv6 -s 192.0.2.2 -j ACCEPT
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>Allow outgoing IPv6-in-IPv4 to interface ppp0 to tunnel endpoint 1.2.3.4 </para></listitem></itemizedlist><screen>
|
|
<![CDATA[# iptables -A OUTPUT -o ppp0 -p ipv6 -d 192.0.2.2 -j ACCEPT
|
|
]]></screen></sect3><sect3>
|
|
<title>Protection against incoming TCP connection requests</title>
|
|
<para>VERY RECOMMENDED! For security issues you should really insert a rule which blocks incoming TCP connection requests. Adapt "-i" option, if other interface names are in use! </para><itemizedlist>
|
|
<listitem><para>Block incoming TCP connection requests to this host </para></listitem></itemizedlist><screen>
|
|
<![CDATA[# ip6tables -I INPUT -i sit+ -p tcp --syn -j DROP
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>Block incoming TCP connection requests to hosts behind this router </para></listitem></itemizedlist><screen>
|
|
<![CDATA[# ip6tables -I FORWARD -i sit+ -p tcp --syn -j DROP
|
|
]]></screen><para>Perhaps the rules have to be placed below others, but that is work you have to think about it. Best way is to create a script and execute rules in a specified way. </para></sect3><sect3>
|
|
<title>Protection against incoming UDP connection requests</title>
|
|
<para>ALSO RECOMMENDED! Like mentioned on my firewall information it's possible to control the ports on outgoing UDP/TCP sessions. So if all of your local IPv6 systems are using local ports e.g. from 32768 to 60999 you are able to filter UDP connections also (until connection tracking works) like: </para><itemizedlist>
|
|
<listitem><para>Block incoming UDP packets which cannot be responses of outgoing requests of this host </para></listitem></itemizedlist><screen>
|
|
<![CDATA[# ip6tables -I INPUT -i sit+ -p udp ! --dport 32768:60999 -j DROP
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>Block incoming UDP packets which cannot be responses of forwarded requests of hosts behind this router </para></listitem></itemizedlist><screen>
|
|
<![CDATA[# ip6tables -I FORWARD -i sit+ -p udp ! --dport 32768:60999 -j DROP
|
|
]]></screen></sect3></sect2><sect2>
|
|
<title>Examples</title>
|
|
<sect3>
|
|
<title>Simple example for Fedora</title>
|
|
<para>Following lines show a simple firewall configuration for Fedora 6 (since kernel version 2.6.20). It was modfied from the default one (generated by system-config-firewall) for supporting connection tracking and return the proper ICMPv6 code for rejects. Incoming SSH (port 22) connections are allowed.</para><screen>
|
|
<![CDATA[File: /etc/sysconfig/ip6tables
|
|
|
|
*filter :INPUT ACCEPT [0:0]
|
|
:FORWARD ACCEPT [0:0]
|
|
:OUTPUT ACCEPT [0:0]
|
|
:RH-Firewall-1-INPUT - [0:0]
|
|
-A INPUT -j RH-Firewall-1-INPUT
|
|
-A FORWARD -j RH-Firewall-1-INPUT
|
|
-A RH-Firewall-1-INPUT -i lo -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -p icmpv6 -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -p 50 -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -p 51 -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -p udp --dport 5353 -d ff02::fb -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -p udp -m udp --dport 631 -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -p tcp -m tcp --dport 631 -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -m state --state NEW -p tcp --dport 22 -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -j REJECT --reject-with icmp6-adm-prohibited
|
|
COMMIT
|
|
]]></screen><para>For completeness also the IPv4 configuration is shown here:</para><screen>
|
|
<![CDATA[File: /etc/sysconfig/iptables
|
|
|
|
*filter :INPUT ACCEPT [0:0]
|
|
:FORWARD ACCEPT [0:0]
|
|
:OUTPUT ACCEPT [0:0]
|
|
:RH-Firewall-1-INPUT - [0:0]
|
|
-A INPUT -j RH-Firewall-1-INPUT
|
|
-A FORWARD -j RH-Firewall-1-INPUT
|
|
-A RH-Firewall-1-INPUT -i lo -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -p icmp --icmp-type any -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -p 50 -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -p 51 -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -p udp --dport 5353 -d 224.0.0.251 -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -p udp -m udp --dport 631 -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -p tcp -m tcp --dport 631 -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 22 -j ACCEPT
|
|
-A RH-Firewall-1-INPUT -j REJECT --reject-with icmp-host-prohibited
|
|
COMMIT
|
|
]]></screen><para>Usage:</para><itemizedlist>
|
|
<listitem><para>Create/modify the configuration files</para></listitem><listitem><para>Activate IPv4 & IPv6 firewalling</para></listitem></itemizedlist><screen>
|
|
<![CDATA[# service iptables start
|
|
# service ip6tables start
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>Enable automatic start after reboot</para></listitem></itemizedlist><screen>
|
|
<![CDATA[# chkconfig iptables on
|
|
# chkconfig ip6tables on
|
|
]]></screen></sect3><sect3>
|
|
<title>Sophisticated example</title>
|
|
<para>Following lines show a more sophisticated but still stateless filter setup as an example. Happy netfilter6 ruleset creation.... </para><screen>
|
|
<![CDATA[# ip6tables -n -v -L
|
|
Chain INPUT (policy DROP 0 packets, 0 bytes)
|
|
pkts bytes target prot opt in out source destination
|
|
0 0 extIN all sit+ * ::/0 ::/0
|
|
4 384 intIN all eth0 * ::/0 ::/0
|
|
0 0 ACCEPT all * * ::1/128 ::1/128
|
|
0 0 ACCEPT all lo * ::/0 ::/0
|
|
0 0 LOG all * * ::/0 ::/0
|
|
¬ LOG flags 0 level 7 prefix `INPUT-default:'
|
|
0 0 DROP all * * ::/0 ::/0
|
|
|
|
Chain FORWARD (policy DROP 0 packets, 0 bytes)
|
|
pkts bytes target prot opt in out source destination
|
|
¬
|
|
0 0 int2ext all eth0 sit+ ::/0 ::/0
|
|
0 0 ext2int all sit+ eth0 ::/0 ::/0
|
|
0 0 LOG all * * ::/0 ::/0
|
|
¬ LOG flags 0 level 7 prefix `FORWARD-default:'
|
|
0 0 DROP all * * ::/0 ::/0
|
|
|
|
Chain OUTPUT (policy DROP 0 packets, 0 bytes)
|
|
pkts bytes target prot opt in out source destination
|
|
¬
|
|
0 0 extOUT all * sit+ ::/0 ::/0
|
|
4 384 intOUT all * eth0 ::/0 ::/0
|
|
0 0 ACCEPT all * * ::1/128 ::1/128
|
|
0 0 ACCEPT all * lo ::/0 ::/0
|
|
0 0 LOG all * * ::/0 ::/0
|
|
¬ LOG flags 0 level 7 prefix `OUTPUT-default:'
|
|
0 0 DROP all * * ::/0 ::/0
|
|
|
|
Chain ext2int (1 references)
|
|
pkts bytes target prot opt in out source destination
|
|
¬
|
|
0 0 ACCEPT icmpv6 * * ::/0 ::/0
|
|
0 0 ACCEPT tcp * * ::/0 ::/0
|
|
¬ tcp spts:1:65535 dpts:1024:65535 flags:!0x16/0x02
|
|
0 0 LOG all * * ::/0 ::/0
|
|
¬ LOG flags 0 level 7 prefix `ext2int-default:'
|
|
0 0 DROP tcp * * ::/0 ::/0
|
|
0 0 DROP udp * * ::/0 ::/0
|
|
0 0 DROP all * * ::/0 ::/0
|
|
|
|
Chain extIN (1 references)
|
|
pkts bytes target prot opt in out source destination
|
|
¬
|
|
0 0 ACCEPT tcp * * 3ffe:400:100::1/128 ::/0
|
|
¬ tcp spts:512:65535 dpt:22
|
|
0 0 ACCEPT tcp * * 3ffe:400:100::2/128 ::/0
|
|
¬ tcp spts:512:65535 dpt:22
|
|
0 0 ACCEPT icmpv6 * * ::/0 ::/0
|
|
0 0 ACCEPT tcp * * ::/0 ::/0
|
|
¬ tcp spts:1:65535 dpts:1024:65535 flags:!0x16/0x02
|
|
0 0 ACCEPT udp * * ::/0 ::/0
|
|
¬ udp spts:1:65535 dpts:1024:65535
|
|
0 0 LOG all * * ::/0 ::/0
|
|
¬ limit: avg 5/min burst 5 LOG flags 0 level 7 prefix `extIN-default:'
|
|
0 0 DROP all * * ::/0 ::/0
|
|
|
|
Chain extOUT (1 references)
|
|
pkts bytes target prot opt in out source destination
|
|
¬
|
|
0 0 ACCEPT tcp * * ::/0
|
|
¬ 2001:0db8:100::1/128tcp spt:22 dpts:512:65535 flags:!0x16/0x02
|
|
0 0 ACCEPT tcp * * ::/0
|
|
¬ 2001:0db8:100::2/128tcp spt:22 dpts:512:65535 flags:!0x16/0x02
|
|
0 0 ACCEPT icmpv6 * * ::/0 ::/0
|
|
0 0 ACCEPT tcp * * ::/0 ::/0
|
|
¬ tcp spts:1024:65535 dpts:1:65535
|
|
0 0 ACCEPT udp * * ::/0 ::/0
|
|
¬ udp spts:1024:65535 dpts:1:65535
|
|
0 0 LOG all * * ::/0 ::/0
|
|
¬ LOG flags 0 level 7 prefix `extOUT-default:'
|
|
0 0 DROP all * * ::/0 ::/0
|
|
|
|
Chain int2ext (1 references)
|
|
pkts bytes target prot opt in out source destination
|
|
¬
|
|
0 0 ACCEPT icmpv6 * * ::/0 ::/0
|
|
0 0 ACCEPT tcp * * ::/0 ::/0
|
|
¬ tcp spts:1024:65535 dpts:1:65535
|
|
0 0 LOG all * * ::/0 ::/0
|
|
¬ LOG flags 0 level 7 prefix `int2ext:'
|
|
0 0 DROP all * * ::/0 ::/0
|
|
0 0 LOG all * * ::/0 ::/0
|
|
¬ LOG flags 0 level 7 prefix `int2ext-default:'
|
|
0 0 DROP tcp * * ::/0 ::/0
|
|
0 0 DROP udp * * ::/0 ::/0
|
|
0 0 DROP all * * ::/0 ::/0
|
|
|
|
Chain intIN (1 references)
|
|
pkts bytes target prot opt in out source destination
|
|
¬
|
|
0 0 ACCEPT all * * ::/0
|
|
¬ fe80::/ffc0::
|
|
4 384 ACCEPT all * * ::/0 ff02::/16
|
|
|
|
Chain intOUT (1 references)
|
|
pkts bytes target prot opt in out source destination
|
|
¬
|
|
0 0 ACCEPT all * * ::/0
|
|
¬ fe80::/ffc0::
|
|
4 384 ACCEPT all * * ::/0 ff02::/16
|
|
0 0 LOG all * * ::/0 ::/0
|
|
¬ LOG flags 0 level 7 prefix `intOUT-default:'
|
|
0 0 DROP all * * ::/0 ::/0
|
|
]]></screen></sect3></sect2></sect1></chapter><chapter id='chapter-security' >
|
|
<title><!-- anchor id="chapter-security" -->Security</title>
|
|
<sect1>
|
|
<title>Node security</title>
|
|
<para>It's very recommended to apply all available patches and disable all not necessary services. Also bind services to the needed IPv4/IPv6 addresses only and install local firewalling.</para>
|
|
<para>More to be filled...</para></sect1><sect1>
|
|
<title>Access limitations</title>
|
|
<para>Many services uses the tcp_wrapper library for access control. Below is described the <link linkend="hints-daemons-tcpwrapper">use of tcp_wrapper</link>.</para>
|
|
<para>More to be filled...</para></sect1><sect1 id='IPv6-security-auditing' >
|
|
<title><!-- anchor id="IPv6-security-auditing" -->IPv6 security auditing</title>
|
|
<para>Currently there are no comfortable tools out which are able to check a system over network for IPv6 security issues. Neither <ulink url="http://www.nessus.org/">Nessus</ulink> nor any commercial security scanner is as far as I know able to scan IPv6 addresses.</para><sect2>
|
|
<title>Legal issues</title>
|
|
<para>ATTENTION: always take care that you only scan your own systems or after receiving a written order, otherwise legal issues are able to come up to you.
|
|
CHECK destination IPv6 addresses TWICE before starting a scan.</para></sect2><sect2>
|
|
<title>Security auditing using IPv6-enabled netcat</title>
|
|
<para>With the IPv6-enabled netcat (see <ulink url="http://www.bieringer.de/linux/IPv6/status/IPv6+Linux-status-apps.html#security-auditing">IPv6+Linux-status-apps/security-auditing</ulink> for more) you can run a portscan by wrapping a script around which run through a port range, grab banners and so on. Usage example:</para><screen>
|
|
<![CDATA[# nc6 ::1 daytime
|
|
13 JUL 2002 11:22:22 CEST
|
|
]]></screen></sect2><sect2>
|
|
<title>Security auditing using IPv6-enabled nmap</title>
|
|
<para><ulink url="http://www.insecure.org/nmap/">NMap</ulink>, one of the best portscaner around the world, supports IPv6 since version 3.10ALPHA1. Usage example:</para><screen>
|
|
<![CDATA[# nmap -6 -sT ::1
|
|
Starting nmap V. 3.10ALPHA3 ( www.insecure.org/nmap/ )
|
|
Interesting ports on localhost6 (::1):
|
|
(The 1600 ports scanned but not shown below are in state: closed)
|
|
Port State Service
|
|
22/tcp open ssh
|
|
53/tcp open domain
|
|
515/tcp open printer
|
|
2401/tcp open cvspserver
|
|
Nmap run completed -- 1 IP address (1 host up) scanned in 0.525 seconds
|
|
]]></screen></sect2><sect2>
|
|
<title>Security auditing using IPv6-enabled strobe</title>
|
|
<para>Strobe is a (compared to NMap) more a low budget portscanner, but there is an IPv6-enabling patch available (see <ulink url="http://www.bieringer.de/linux/IPv6/status/IPv6+Linux-status-apps.html#security-auditing">IPv6+Linux-status-apps/security-auditing</ulink> for more). Usage example:</para><screen>
|
|
<![CDATA[# ./strobe ::1 strobe 1.05 (c) 1995-1999 Julian Assange <proff@iq.org>.
|
|
::1 2401 unassigned unknown
|
|
::1 22 ssh Secure Shell - RSA encrypted rsh
|
|
::1 515 printer spooler (lpd)
|
|
::1 6010 unassigned unknown
|
|
::1 53 domain Domain Name Server
|
|
]]></screen><para>Note: strobe isn't really developed further on, the shown version number isn't the right one.</para></sect2><sect2>
|
|
<title>Audit results</title>
|
|
<para>If the result of an audit mismatch your IPv6 security policy, use IPv6 firewalling to close the holes, e.g. using netfilter6 (see <link linkend="firewalling-netfilter6.">Firewalling/Netfilter6</link> for more).</para>
|
|
<para>Info: More detailed information concerning IPv6 Security can be found here: </para><itemizedlist>
|
|
<listitem><para><ulink url="http://www.ietf.org/ids.by.wg/v6ops.html">IETF drafts - IPv6 Operations (v6ops)</ulink></para></listitem><listitem><para><ulink url="http://www.faqs.org/rfcs/rfc3964.html">RFC 3964 / Security Considerations for 6to4</ulink></para></listitem></itemizedlist></sect2></sect1></chapter><chapter id='chapter-encryption-authentication' >
|
|
<title><!-- anchor id="chapter-encryption-authentication" -->Encryption and Authentication</title>
|
|
<para>Unlike in IPv4, encryption and authentication is a mandatory feature of IPv6. Those features are normally implemented using IPsec (which can be also used by IPv4).</para><sect1>
|
|
<title>Modes of using encryption and authentication</title>
|
|
<para>Two modes of encryption and authentication of a connection are possible:</para><sect2>
|
|
<title>Transport mode</title>
|
|
<para>Transport mode is a real end-to-end connection mode. Here, only the payload (usually ICMP, TCP or UDP) is encrypted with their particular header, while the IP header is not encrypted (but usually included in authentication).</para>
|
|
<para>Using AES-128 for encryption and SHA1 for authentication, this mode decreases the MTU by 42 octets.</para></sect2><sect2>
|
|
<title>Tunnel mode</title>
|
|
<para>Tunnel mode can be used either for end-to-end or for gateway-to-gateway connection modes. Here, the complete IP packet is being encrypted and gets a new IP header prepended, all together constituing a new IP packet (this mechanism is also known as "encapsulation")</para>
|
|
<para>This mode usually decreases the MTU by 40 octets from the MTU of transport mode. I.e. using AES-128 for encryption and SHA1 for authentication 82 octets less than the normal MTU.</para></sect2></sect1><sect1>
|
|
<title>Support in kernel (ESP and AH)</title>
|
|
<sect2>
|
|
<title>Support in vanilla Linux kernel 2.4.x</title>
|
|
<para>At the time of writing missing in vanilla up to 2.4.28. There was an issue about keeping the Linux kernel source free of export/import-control-laws regarding encryption code. This is also one case why <ulink url="http://www.freeswan.org/">FreeS/WAN project</ulink> wasn't included in vanilla source. Perhaps a backport from 2.6.x will be done in the future.</para></sect2><sect2>
|
|
<title>Support in vanilla Linux kernel 2.6.x</title>
|
|
<para>Current versions (as time of writing 2.6.9 and upper) support native IPsec for IPv4 and IPv6.</para>
|
|
<para>Implementation was helped by the USAGI project.</para></sect2></sect1><sect1>
|
|
<title>Automatic key exchange (IKE)</title>
|
|
<para>IPsec requires a key exchange of a secret. This is mostly done automatically by so called IKE daemons. They also handle the authentication of the peers, either by a common known secret (so called “pre-shared secret”) or by RSA keys (which can also be used from X.509 certificates).</para>
|
|
<para>Currently, two different IKE daemons are available for Linux, which totally differ in configuration and usage.</para>
|
|
<para>I prefer “pluto” from the *S/WAN implementation because of the easier and one-config-only setup.</para><sect2>
|
|
<title>IKE daemon “racoon”</title>
|
|
<para>The IKE daemon “racoon” is taken from the KAME project and ported to Linux. Modern Linux distributions contain this daemon in the package “ipsec-tools”. Two executables are required for a proper IPsec setup. Take a look on <ulink url="http://lartc.org/howto/lartc.ipsec.html">Linux Advanced Routing & Traffic Control HOWTO / IPSEC</ulink>, too.</para><sect3>
|
|
<title>Manipulation of the IPsec SA/SP database with the tool “setkey”</title>
|
|
<para>“setkey” is important to define the security policy (SP) for the kernel.</para>
|
|
<para>File: /etc/racoon/setkey.sh</para><itemizedlist>
|
|
<listitem><para>Example for an end-to-end encrypted connection in transport mode</para></listitem></itemizedlist><screen>
|
|
<![CDATA[#!/sbin/setkey -f
|
|
flush;
|
|
spdflush;
|
|
spdadd 2001:db8:1:1::1 2001:db8:2:2::2 any -P out ipsec esp/transport//require;
|
|
spdadd 2001:db8:2:2::2 2001:db8:1:1::1 any -P in ipsec esp/transport//require;
|
|
|
|
]]></screen><itemizedlist>
|
|
<listitem><para>Example for a end-to-end encrypted connection in tunnel mode</para></listitem></itemizedlist><screen>
|
|
<![CDATA[#!/sbin/setkey -f
|
|
flush;
|
|
spdflush;
|
|
spdadd 2001:db8:1:1::1 2001:db8:2:2::2 any -P out ipsec
|
|
¬ esp/tunnel/2001:db8:1:1::1-2001:db8:2:2::2/require;
|
|
spdadd 2001:db8:2:2::2 2001:db8:1:1::1 any -P in ipsec
|
|
¬ esp/tunnel/2001:db8:2:2::2-2001:db8:1:1::1/require;
|
|
]]></screen><para>For the other peer, you have to replace “in” with “out”.</para></sect3><sect3>
|
|
<title>Configuration of the IKE daemon “racoon”</title>
|
|
<para>“racoon” requires a configuration file for proper execution. It includes the related settings to the security policy, which should be set up previously using “setkey”.</para>
|
|
<para>File: /etc/racoon/racoon.conf</para><screen>
|
|
<![CDATA[# Racoon IKE daemon configuration file.
|
|
# See 'man racoon.conf' for a description of the format and entries.
|
|
path include "/etc/racoon";
|
|
path pre_shared_key "/etc/racoon/psk.txt";
|
|
|
|
listen
|
|
{
|
|
isakmp 2001:db8:1:1::1;
|
|
}
|
|
|
|
remote 2001:db8:2:2::2
|
|
{
|
|
exchange_mode main;
|
|
lifetime time 24 hour;
|
|
proposal
|
|
{
|
|
encryption_algorithm 3des;
|
|
hash_algorithm md5;
|
|
authentication_method pre_shared_key;
|
|
dh_group 2;
|
|
}
|
|
}
|
|
|
|
# gateway-to-gateway
|
|
sainfo address 2001:db8:1:1::1 any address 2001:db8:2:2::2 any
|
|
{
|
|
lifetime time 1 hour;
|
|
encryption_algorithm 3des;
|
|
authentication_algorithm hmac_md5;
|
|
compression_algorithm deflate;
|
|
}
|
|
|
|
sainfo address 2001:db8:2:2::2 any address 2001:db8:1:1::1 any
|
|
{
|
|
lifetime time 1 hour;
|
|
encryption_algorithm 3des;
|
|
authentication_algorithm hmac_md5;
|
|
compression_algorithm deflate;
|
|
}
|
|
]]></screen><para>Also set up the pre-shared secret:</para>
|
|
<para>File: /etc/racoon/psk.txt</para><screen>
|
|
<![CDATA[# file for pre-shared keys used for IKE authentication
|
|
# format is: 'identifier' 'key'
|
|
|
|
2001:db8:2:2::2 verysecret
|
|
]]></screen></sect3><sect3>
|
|
<title>Running IPsec with IKE daemon “racoon”</title>
|
|
<para>At least the daemon needs to be started. For the first time, use debug and foreground mode. The following example shows a successful IKE phase 1 (ISAKMP-SA) and 2 (IPsec-SA) negotiation:</para><screen>
|
|
<![CDATA[# racoon -F -v -f /etc/racoon/racoon.conf
|
|
Foreground mode.
|
|
2005-01-01 20:30:15: INFO: @(#)ipsec-tools 0.3.3
|
|
¬ (http://ipsec-tools.sourceforge.net)
|
|
2005-01-01 20:30:15: INFO: @(#)This product linked
|
|
¬ OpenSSL 0.9.7a Feb 19 2003 (http://www.openssl.org/)
|
|
2005-01-01 20:30:15: INFO: 2001:db8:1:1::1[500] used as isakmp port (fd=7)
|
|
2005-01-01 20:31:06: INFO: IPsec-SA request for 2001:db8:2:2::2
|
|
¬ queued due to no phase1 found.
|
|
2005-01-01 20:31:06: INFO: initiate new phase 1 negotiation:
|
|
¬ 2001:db8:1:1::1[500]<=>2001:db8:2:2::2[500]
|
|
2005-01-01 20:31:06: INFO: begin Identity Protection mode.
|
|
2005-01-01 20:31:09: INFO: ISAKMP-SA established
|
|
¬ 2001:db8:1:1::1[500]-2001:db8:2:2::2[500] spi:da3d3693289c9698:ac039a402b2db401
|
|
2005-01-01 20:31:09: INFO: initiate new phase 2 negotiation:
|
|
¬ 2001:6f8:900:94::2[0]<=>2001:db8:2:2::2[0]
|
|
2005-01-01 20:31:10: INFO: IPsec-SA established:
|
|
¬ ESP/Tunnel 2001:db8:2:2::2->2001:db8:1:1::1 spi=253935531(0xf22bfab)
|
|
2005-01-01 20:31:10: INFO: IPsec-SA established:
|
|
¬ ESP/Tunnel 2001:db8:1:1::1->2001:db8:2:2::2 spi=175002564(0xa6e53c4)
|
|
]]></screen><para>Each direction got its own IPsec-SA (like defined in the IPsec standard). With “tcpdump” on the related interface, you will see as result of an IPv6 ping:</para><screen>
|
|
<![CDATA[20:35:55.305707 2001:db8:1:1::1 > 2001:db8:2:2::2: ESP(spi=0x0a6e53c4,seq=0x3)
|
|
20:35:55.537522 2001:db8:2:2::2 > 2001:db8:1:1::1: ESP(spi=0x0f22bfab,seq=0x3)
|
|
]]></screen><para>As expected, the negotiated SPIs are being used here.</para>
|
|
<para>And using “setkey”, current active parameters are shown:</para><screen>
|
|
<![CDATA[# setkey -D
|
|
2001:db8:1:1::1 2001:db8:2:2::2
|
|
esp mode=tunnel spi=175002564(0x0a6e53c4) reqid=0(0x00000000)
|
|
E: 3des-cbc bd26bc45 aea0d249 ef9c6b89 7056080f 5d9fa49c 924e2edd
|
|
A: hmac-md5 60c2c505 517dd8b7 c9609128 a5efc2db
|
|
seq=0x00000000 replay=4 flags=0x00000000 state=mature
|
|
created: Jan 1 20:31:10 2005 current: Jan 1 20:40:47 2005
|
|
diff: 577(s) hard: 3600(s) soft: 2880(s)
|
|
last: Jan 1 20:35:05 2005 hard: 0(s) soft: 0(s)
|
|
current: 540(bytes) hard: 0(bytes) soft: 0(bytes)
|
|
allocated: 3 hard: 0 soft: 0
|
|
sadb_seq=1 pid=22358 refcnt=0
|
|
2001:db8:2:2::2 2001:db8:1:1::1
|
|
esp mode=tunnel spi=253935531(0x0f22bfab) reqid=0(0x00000000)
|
|
E: 3des-cbc c1ddba65 83debd62 3f6683c1 20e747ac 933d203f 4777a7ce
|
|
A: hmac-md5 3f957db9 9adddc8c 44e5739d 3f53ca0e
|
|
seq=0x00000000 replay=4 flags=0x00000000 state=mature
|
|
created: Jan 1 20:31:10 2005 current: Jan 1 20:40:47 2005
|
|
diff: 577(s) hard: 3600(s) soft: 2880(s)
|
|
last: Jan 1 20:35:05 2005 hard: 0(s) soft: 0(s)
|
|
current: 312(bytes) hard: 0(bytes) soft: 0(bytes)
|
|
allocated: 3 hard: 0 soft: 0
|
|
sadb_seq=0 pid=22358 refcnt=0
|
|
]]></screen></sect3></sect2><sect2>
|
|
<title>IKE daemon “pluto”</title>
|
|
<para>The IKE daemon “pluto” is included in distributions of the *S/WAN projects. *S/WAN project starts at the beginning as <ulink url="http://www.freeswan.org/">FreeS/WAN</ulink>. Unfortunately, the FreeS/WAN project stopped further development in 2004. Because of the slow pace of development in the past, two spin-offs started: <ulink url="http://www.strongswan.org/">strongSwan</ulink> and <ulink url="http://www.openswan.org/">Openswan</ulink>. Today, readily installable packages are available for at least Openswan (included in Fedora Core 3).</para>
|
|
<para>A major difference to “racoon”, only one configuration file is required. Also, an initscript exists for automatic setup after booting.</para><sect3>
|
|
<title>Configuration of the IKE daemon “pluto”</title>
|
|
<para>The configuration is very similar to the IPv4 one, only one important option is necessary.</para>
|
|
<para>File: /etc/ipsec.conf</para><screen>
|
|
<![CDATA[# /etc/ipsec.conf - Openswan IPsec configuration file
|
|
#
|
|
# Manual: ipsec.conf.5
|
|
version 2.0 # conforms to second version of ipsec.conf specification
|
|
|
|
# basic configuration
|
|
config setup
|
|
# Debug-logging controls: "none" for (almost) none, "all" for lots.
|
|
# klipsdebug=none
|
|
# plutodebug="control parsing"
|
|
|
|
#Disable Opportunistic Encryption
|
|
include /etc/ipsec.d/examples/no_oe.conf
|
|
|
|
conn ipv6-p1-p2
|
|
connaddrfamily=ipv6 # Important for IPv6!
|
|
left=2001:db8:1:1::1
|
|
right=2001:db8:2:2::2
|
|
authby=secret
|
|
esp=aes128-sha1
|
|
ike=aes128-sha-modp1024
|
|
type=transport
|
|
#type=tunnel
|
|
compress=no
|
|
#compress=yes
|
|
auto=add
|
|
#auto=start
|
|
|
|
]]></screen><para>Don't forget to define the pre-shared secret here also.</para>
|
|
<para>File: /etc/ipsec.secrets</para><screen>
|
|
<![CDATA[2001:db8:1:1::1 2001:db8:2:2::2 : PSK "verysecret"
|
|
]]></screen></sect3><sect3>
|
|
<title>Running IPsec with IKE daemon “pluto”</title>
|
|
<para>If installation of Openswan was successfully, an initscript should exist for starting IPsec, simply run (on each peer):</para><screen>
|
|
<![CDATA[# /etc/rc.d/init.d/ipsec start
|
|
]]></screen><para>Afterwards, start this connection on one peer. If you saw the line “IPsec SA established”, all worked fine.</para><screen>
|
|
<![CDATA[# ipsec auto --up ipv6-peer1-peer2
|
|
104 "ipv6-p1-p2" #1: STATE_MAIN_I1: initiate
|
|
106 "ipv6-p1-p2" #1: STATE_MAIN_I2: sent MI2, expecting MR2
|
|
108 "ipv6-p1-p2" #1: STATE_MAIN_I3: sent MI3, expecting MR3
|
|
004 "ipv6-p1-p2" #1: STATE_MAIN_I4: ISAKMP SA established
|
|
112 "ipv6-p1-p2" #2: STATE_QUICK_I1: initiate
|
|
004 "ipv6-p1-p2" #2: STATE_QUICK_I2: sent QI2,
|
|
¬ IPsec SA established {ESP=>0xa98b7710 <0xa51e1f22}
|
|
]]></screen><para>Because *S/WAN and setkey/racoon do use the same IPsec implementation in Linux 2.6.x kernel, “setkey” can be used here too to show current active parameters:</para><screen>
|
|
<![CDATA[# setkey -D
|
|
2001:db8:1:1::1 2001:db8:2:2::2
|
|
esp mode=transport spi=2844489488(0xa98b7710) reqid=16385(0x00004001)
|
|
E: aes-cbc 082ee274 2744bae5 7451da37 1162b483
|
|
A: hmac-sha1 b7803753 757417da 477b1c1a 64070455 ab79082c
|
|
seq=0x00000000 replay=64 flags=0x00000000 state=mature
|
|
created: Jan 1 21:16:32 2005 current: Jan 1 21:22:20 2005
|
|
diff: 348(s) hard: 0(s) soft: 0(s)
|
|
last: hard: 0(s) soft: 0(s)
|
|
current: 0(bytes) hard: 0(bytes) soft: 0(bytes)
|
|
allocated: 0 hard: 0 soft: 0
|
|
sadb_seq=1 pid=23825 refcnt=0
|
|
2001:db8:2:2::2 2001:db8:1:1::1
|
|
esp mode=transport spi=2770214690(0xa51e1f22) reqid=16385(0x00004001)
|
|
E: aes-cbc 6f59cc30 8d856056 65e07b76 552cac18
|
|
A: hmac-sha1 c7c7d82b abfca8b1 5440021f e0c3b335 975b508b
|
|
seq=0x00000000 replay=64 flags=0x00000000 state=mature
|
|
created: Jan 1 21:16:31 2005 current: Jan 1 21:22:20 2005
|
|
diff: 349(s) hard: 0(s) soft: 0(s)
|
|
last: hard: 0(s) soft: 0(s)
|
|
current: 0(bytes) hard: 0(bytes) soft: 0(bytes)
|
|
allocated: 0 hard: 0 soft: 0
|
|
sadb_seq=0 pid=23825 refcnt=0
|
|
]]></screen></sect3></sect2></sect1><sect1>
|
|
<title>Additional informations:</title>
|
|
<para>On Linux Kernel 2.6.x you can get the policy and status of IPsec also using “ip”:</para><screen>
|
|
<![CDATA[# ip xfrm policy
|
|
...
|
|
|
|
# ip xfrm state
|
|
...
|
|
]]></screen></sect1></chapter><chapter id='chapter-qos' >
|
|
<title><!-- anchor id="chapter-qos" -->Quality of Service (QoS)</title>
|
|
<para>IPv6 supports QoS with use of Flow Labels and Traffic Classes.</para>
|
|
<para>Additional infos:</para><itemizedlist>
|
|
<listitem><para><ulink url="http://www.faqs.org/rfcs/rfc3697.html">RFC 3697 / IPv6 Flow Label Specification</ulink></para></listitem></itemizedlist><sect1>
|
|
<title>General</title>
|
|
<para>Proper working QoS is only possible on the outgoing interface of a router or host, where the bottleneck begins. Everything else is a hickup and not subject to work as expected or has a successful result.</para><screen>
|
|
<![CDATA[-------------->-------
|
|
Queue 1 \
|
|
--->--- ---->--------->--------->---------------
|
|
Big pipe Queue 2 Queue 1 / Queue 2 / Queue 3 Thin Pipe
|
|
--->---- ---->--------->--------->---------------
|
|
Queue 3 /
|
|
-------------->-------
|
|
]]></screen></sect1><sect1>
|
|
<title>Linux QoS using “tc”</title>
|
|
<para>Linux is using “tc” from the “iproute2” package to configure traffic shaping, generally described in the <ulink url="http://lartc.org/">Linux Advanced Routing & Traffic Control HOWTO</ulink>.</para><sect2>
|
|
<title>Example for a constant bitrate queuing</title>
|
|
<para>With the “cbq” scheduler, pipes with constant bit rates can be defined.</para><sect3>
|
|
<title>Root qdisc definition</title>
|
|
<para>Define root qdisc with a bandwidth of 1000 MBit/s on eth1</para><screen>
|
|
<![CDATA[# tc qdisc add dev eth1 root handle 1: cbq avpkt 1000 bandwidth 1000Mbit
|
|
]]></screen></sect3><sect3>
|
|
<title>QoS class definition</title>
|
|
<para>Define a class 1:1 with 1 MBit/s</para><screen>
|
|
<![CDATA[# tc class add dev eth1 parent 1: classid 1:1 cbq rate 1Mbit allot 1500 bounded
|
|
]]></screen><para>Define a class 1:2 with 50 MBit/s</para><screen>
|
|
<![CDATA[# tc class add dev eth1 parent 1: classid 1:2 cbq rate 50Mbit allot 1500 bounded
|
|
]]></screen><para>Define a class 1:3 with 10 MBit/s</para><screen>
|
|
<![CDATA[# tc class add dev eth1 parent 1: classid 1:3 cbq rate 10Mbit allot 1500 bounded
|
|
]]></screen><para>Define a class 1:4 with 200 kBit/s</para><screen>
|
|
<![CDATA[# tc class add dev eth1 parent 1: classid 1:4 cbq rate 200kbit allot 1500 bounded
|
|
]]></screen></sect3><sect3>
|
|
<title>QoS filter definition</title>
|
|
<para>Define a filter for IPv4 (<emphasis>protocol ip</emphasis>), TCP (<emphasis>match ip protocol 6 0xff</emphasis>) destination port 5001 (<emphasis>match ip dport 5001 0xffff</emphasis>) using class 1:2 from above</para><screen>
|
|
<![CDATA[# tc filter add dev eth1 parent 1: protocol ip u32 match ip protocol 6 0xff match ip dport 5001 0xffff flowid 1:1
|
|
]]></screen><para>Define a filter for IPv6 (<emphasis>protocol ip</emphasis>), TCP (<emphasis>match ip6 protocol 6 0xff</emphasis>) destination port 5001 using class 1:2 from above</para><screen>
|
|
<![CDATA[# tc filter add dev eth1 parent 1: protocol ipv6 u32 match ip6 protocol 6 0xff match ip6 dport 5001 0xffff flowid 1:2
|
|
]]></screen><para>Define a filter for IPv6 for packets having flow label 12345 (<emphasis>match ip6 flowlabel 12345 0x3ffff</emphasis>) using class 1:3 from above</para><screen>
|
|
<![CDATA[# tc filter add dev eth1 parent 1: protocol ipv6 u32 match ip6 flowlabel 12345 0x3ffff flowid 1:3
|
|
]]></screen><para>Define a filter for IPv6 for packets having Linux iptables mark 32 (<emphasis>handle 32 fw</emphasis>) specified using class 1:4 from above</para><screen>
|
|
<![CDATA[# tc filter add dev eth1 parent 1: protocol ipv6 handle 32 fw flowid 1:4
|
|
]]></screen><para>The last filter definition requires an entry in the ip6tables to mark a packet</para><screen>
|
|
<![CDATA[# ip6tables -A POSTROUTING -t mangle -p tcp --dport 5003 -j MARK --set-mark 32
|
|
]]></screen></sect3><sect3>
|
|
<title>Testing filter definitions using iperf</title>
|
|
<para>Start on server side each one one separate console:</para><screen>
|
|
<![CDATA[# iperf -V -s -p 5001
|
|
# iperf -V -s -p 5002
|
|
# iperf -V -s -p 5003
|
|
]]></screen><para>Start on client side and compare results:</para><screen>
|
|
<![CDATA[# iperf -V -c SERVER-IPv4 -p 5001 (expected: 1 MBit/s)
|
|
# iperf -V -c SERVER-IPv6 -p 5001 (expected: 50 MBit/s)
|
|
# iperf -V -c SERVER-IPv4 -p 5002 (expected: >> 50 MBit/s && <= 1000 MBit/s)
|
|
# iperf -V -c SERVER-IPv6 -p 5002 (expected: >> 50 MBit/s && <= 1000 MBit/s)
|
|
# iperf -V -c SERVER-IPv4 -p 5003 (expected: >> 50 MBit/s && <= 1000 MBit/s)
|
|
# iperf -V -c SERVER-IPv6 -p 5003 (expected: 200 kBit/s)
|
|
]]></screen><para>The rate result should be as defined in the classes (see above), the results on port 5002 should be very similar independend from used IP version.</para></sect3></sect2></sect1></chapter><chapter id='chapter-hints-daemons' >
|
|
<title><!-- anchor id="chapter-hints-daemons" -->Hints for IPv6-enabled daemons</title>
|
|
<para>Here some hints are shown for IPv6-enabled daemons.</para><sect1 id='hints-daemons-bind' >
|
|
<title><!-- anchor id="hints-daemons-bind" -->Berkeley Internet Name Domain (BIND) daemon “named”</title>
|
|
<para>IPv6 is supported since version 9. Always use newest available version. At least version 9.1.3 must be used, older versions can contain remote exploitable security holes.</para><sect2>
|
|
<title>Listening on IPv6 addresses</title>
|
|
<para>Note: unlike in IPv4 current versions doesn't allow to bind a server socket to dedicated IPv6 addresses, so only <emphasis>any</emphasis> or <emphasis>none</emphasis> are valid. Because this can be a security issue, check the Access Control List (ACL) section below, too!</para><sect3>
|
|
<title>Enable BIND named for listening on IPv6 address</title>
|
|
<para>To enable IPv6 for listening, following options are requested to change</para><screen>
|
|
<![CDATA[options {
|
|
# sure other options here, too
|
|
listen-on-v6 { any; };
|
|
};
|
|
]]></screen><para>This should result after restart in e.g.</para><screen>
|
|
<![CDATA[# netstat -lnptu |grep "named\W*$"
|
|
tcp 0 0 :::53 :::* LISTEN 1234/named
|
|
¬ # incoming TCP requests
|
|
udp 0 0 1.2.3.4:53 0.0.0.0:* 1234/named
|
|
¬ # incoming UDP requests to IPv4 1.2.3.4
|
|
udp 0 0 127.0.0.1:53 0.0.0.0:* 1234/named
|
|
¬ # incoming UDP requests to IPv4 localhost
|
|
udp 0 0 0.0.0.0:32868 0.0.0.0:* 1234/named
|
|
¬ # dynamic chosen port for outgoing queries
|
|
udp 0 0 :::53 :::* 1234/named
|
|
¬ # incoming UDP request to any IPv6
|
|
]]></screen><para>And a simple test looks like</para><screen>
|
|
<![CDATA[# dig localhost @::1
|
|
]]></screen><para>and should show you a result.</para></sect3><sect3>
|
|
<title>Disable BIND named for listening on IPv6 address</title>
|
|
<para>To disable IPv6 for listening, following options are requested to change</para><screen>
|
|
<![CDATA[options {
|
|
# sure other options here, too
|
|
listen-on-v6 { none; };
|
|
};
|
|
]]></screen></sect3></sect2><sect2>
|
|
<title>IPv6 enabled Access Control Lists (ACL)</title>
|
|
<para>IPv6 enabled ACLs are possible and should be used whenever it's possible. An example looks like following:</para><screen>
|
|
<![CDATA[acl internal-net {
|
|
127.0.0.1;
|
|
1.2.3.0/24;
|
|
2001:0db8:100::/56;
|
|
::1/128;
|
|
::ffff:1.2.3.4/128;
|
|
};
|
|
acl ns-internal-net {
|
|
1.2.3.4;
|
|
1.2.3.5;
|
|
2001:0db8:100::4/128;
|
|
2001:0db8:100::5/128;
|
|
};
|
|
]]></screen><para>This ACLs can be used e.g. for queries of clients and transfer zones to secondary name-servers. This prevents also your caching name-server to be used from outside using IPv6.</para><screen>
|
|
<![CDATA[options {
|
|
# sure other options here, too
|
|
listen-on-v6 { none; };
|
|
allow-query { internal-net; };
|
|
allow-transfer { ns-internal-net; };
|
|
};
|
|
]]></screen><para>It's also possible to set the <emphasis>allow-query </emphasis>and <emphasis>allow-transfer</emphasis> option for most of single zone definitions, too.</para></sect2><sect2>
|
|
<title>Sending queries with dedicated IPv6 address</title>
|
|
<para>This option is not required, but perhaps needed:</para><screen>
|
|
<![CDATA[query-source-v6 address <ipv6address|*> port <port|*>;
|
|
]]></screen></sect2><sect2>
|
|
<title>Per zone defined dedicated IPv6 addresses</title>
|
|
<para>It's also possible to define per zone some IPv6 addresses.</para><sect3>
|
|
<title>Transfer source address </title>
|
|
<para>Transfer source address is used for outgoing zone transfers:</para><screen>
|
|
<![CDATA[transfer-source-v6 <ipv6addr|*> [port port];
|
|
]]></screen></sect3><sect3>
|
|
<title>Notify source address </title>
|
|
<para>Notify source address is used for outgoing notify messages:</para><screen>
|
|
<![CDATA[notify-source-v6 <ipv6addr|*> [port port];
|
|
]]></screen></sect3></sect2><sect2>
|
|
<title>IPv6 DNS zone files examples</title>
|
|
<para>Some information can be also found at <ulink url="http://www.isi.edu/~bmanning/v6DNS.html">IPv6 DNS Setup Information (article)</ulink>. Perhaps also helpful is the <ulink url="http://tools.fpsn.net/ipv6-inaddr/">IPv6 Reverse DNS zone builder for BIND 8/9 (webtool)</ulink>.</para></sect2><sect2>
|
|
<title>Serving IPv6 related DNS data</title>
|
|
<para>For IPv6 new types and root zones for reverse lookups are defined:</para><itemizedlist>
|
|
<listitem><para>AAAA and reverse IP6.INT: specified in <ulink url="http://www.faqs.org/rfcs/rfc1886.html">RFC 1886 / DNS Extensions to support IP version 6</ulink>, usable since BIND version 4.9.6</para></listitem><listitem><para>A6, DNAME (DEPRECATED NOW!) and reverse IP6.ARPA: specified in <ulink url="http://www.faqs.org/rfcs/rfc2874.html">RFC 2874 / DNS Extensions to Support IPv6 Address Aggregation and Renumbering</ulink>, usable since BIND 9, but see also an information about the current state at <ulink url="http://www.ietf.org/ids.by.wg/dnsext.html">Domain Name System Extension (dnsext)</ulink></para></listitem></itemizedlist><para>Perhaps filled later more content, for the meantime take a look at given RFCs and</para><itemizedlist>
|
|
<listitem><para>AAAA and reverse IP6.INT: <ulink url="http://www.isi.edu/~bmanning/v6DNS.html">IPv6 DNS Setup Information</ulink></para></listitem><listitem><para>A6, DNAME (DEPRECATED NOW!) and reverse IP6.ARPA: take a look into chapter 4 and 6 of the BIND 9 Administrator Reference Manual (ARM) distributed with the bind-package or get this here: <ulink url="http://www.isc.org/sw/bind/arm93/">BIND manual version 9.3</ulink></para></listitem></itemizedlist><para>Because IP6.INT is deprecated (but still in use), a DNS server which will support IPv6 information has to serve both reverse zones.</para><sect3>
|
|
<title>Current best practice</title>
|
|
<para>Because there are some troubles around using the new formats, current best practice is:</para>
|
|
<para>Forward lookup support:</para><itemizedlist>
|
|
<listitem><para>AAAA</para></listitem></itemizedlist><para>Reverse lookup support:</para><itemizedlist>
|
|
<listitem><para>Reverse nibble format for zone ip6.int (FOR BACKWARD COMPATIBILITY)</para></listitem><listitem><para>Reverse nibble format for zone ip6.arpa (RECOMMENDED)</para></listitem></itemizedlist></sect3></sect2><sect2>
|
|
<title>Checking IPv6-enabled connect</title>
|
|
<para>To check, whether BIND named is listening on an IPv6 socket and serving data see following examples.</para><sect3>
|
|
<title>IPv6 connect, but denied by ACL</title>
|
|
<para>Specifying a dedicated server for the query, an IPv6 connect can be forced:</para><screen>
|
|
<![CDATA[$ host -t aaaa www.6bone.net 2001:0db8:200:f101::1
|
|
Using domain server:
|
|
Name: 2001:0db8:200:f101::1
|
|
Address: 2001:0db8:200:f101::1#53
|
|
Aliases:
|
|
|
|
Host www.6bone.net. not found: 5(REFUSED)
|
|
]]></screen><para>Related log entry looks like following:</para><screen>
|
|
<![CDATA[Jan 3 12:43:32 gate named[12347]: client
|
|
¬ 2001:0db8:200:f101:212:34ff:fe12:3456#32770:
|
|
query denied
|
|
]]></screen><para>If you see such entries in the log, check whether requests from this client should be allowed and perhaps review your ACL configuration.</para></sect3><sect3>
|
|
<title>Successful IPv6 connect</title>
|
|
<para>A successful IPv6 connect looks like following:</para><screen>
|
|
<![CDATA[$ host -t aaaa www.6bone.net 2001:0db8:200:f101::1
|
|
Using domain server:
|
|
Name: 2001:0db8:200:f101::1
|
|
Address: 2001:0db8:200:f101::1#53
|
|
Aliases:
|
|
|
|
www.6bone.net. is an alias for 6bone.net.
|
|
6bone.net. has AAAA address 3ffe:b00:c18:1::10
|
|
]]></screen></sect3></sect2></sect1><sect1 id='hints-daemons-xinetd' >
|
|
<title><!-- anchor id="hints-daemons-xinetd" -->Internet super daemon (xinetd)</title>
|
|
<para>IPv6 is supported since <ulink url="http://www.xinetd.org/">xinetd</ulink> version around 1.8.9. Always use newest available version. At least version 2.3.3 must be used, older versions can contain remote exploitable security holes.</para>
|
|
<para>Some Linux distribution contain an extra package for the IPv6 enabled xinetd, some others start the IPv6-enabled xinetd if following variable is set: NETWORKING_IPV6="yes", mostly done by /etc/sysconfig/network (only valid for Red Hat like distributions). In newer releases, one binary supports IPv4 and IPv6.</para>
|
|
<para>If you enable a built-in service like e.g. daytime by modifying the configuration file in /etc/xinetd.d/daytime like</para><screen>
|
|
<![CDATA[# diff -u /etc/xinetd.d/daytime.orig /etc/xinetd.d/daytime
|
|
--- /etc/xinetd.d/daytime.orig Sun Dec 16 19:00:14 2001
|
|
+++ /etc/xinetd.d/daytime Sun Dec 16 19:00:22 2001
|
|
@@ -10,5 +10,5 @@
|
|
protocol = tcp
|
|
user = root
|
|
wait = no
|
|
- disable = yes
|
|
+ disable = no
|
|
}
|
|
]]></screen><para>After restarting the xinetd you should get a positive result like:</para><screen>
|
|
<![CDATA[# netstat -lnptu -A inet6 |grep "xinetd*"
|
|
tcp 0 0 ::ffff:192.168.1.1:993 :::* LISTEN 12345/xinetd-ipv6
|
|
tcp 0 0 :::13 :::* LISTEN 12345/xinetd-ipv6 <- service
|
|
¬ daytime/tcp
|
|
tcp 0 0 ::ffff:192.168.1.1:143 :::* LISTEN 12345/xinetd-ipv6
|
|
]]></screen><para>Shown example also displays an IMAP and IMAP-SSL IPv4-only listening xinetd.</para>
|
|
<para>Note: earlier versions had a problem that an IPv4-only xinetd won't start on an IPv6-enabled node and also the IPv6-enabled xinetd won't start on an IPv4-only node. This is known to be fixed in later versions, at least version 2.3.11.</para></sect1><sect1 id='hints-daemons-apache2.' >
|
|
<title><!-- anchor id="hints-daemons-apache2." -->Webserver Apache2 (httpd2)</title>
|
|
<para>Apache web server supports IPv6 native by maintainers since 2.0.14. Available patches for the older 1.3.x series are not current and shouldn't be used in public environment, but available at <ulink url="ftp://ftp.kame.net/pub/kame/misc/">KAME / Misc</ulink>.</para><sect2>
|
|
<title>Listening on IPv6 addresses</title>
|
|
<para>Note: virtual hosts on IPv6 addresses are broken in versions until 2.0.28 (a patch is available for 2.0.28). But always try latest available version first because earlier versions had some security issues.</para><sect3>
|
|
<title>Virtual host listen on an IPv6 address only</title>
|
|
<screen>
|
|
<![CDATA[Listen [2001:0db8:100::1]:80
|
|
<VirtualHost [2001:0db8:100::1]:80>
|
|
ServerName ipv6only.yourdomain.yourtopleveldomain
|
|
# ...sure more config lines
|
|
</VirtualHost>
|
|
]]></screen></sect3><sect3>
|
|
<title>Virtual host listen on an IPv6 and on an IPv4 address</title>
|
|
<screen>
|
|
<![CDATA[Listen [2001:0db8:100::2]:80
|
|
Listen 1.2.3.4:80
|
|
<VirtualHost [2001:0db8:100::2]:80 1.2.3.4:80>
|
|
ServerName ipv6andipv4.yourdomain.yourtopleveldomain
|
|
# ...sure more config lines
|
|
</VirtualHost>
|
|
]]></screen><para>This should result after restart in e.g.</para><screen>
|
|
<![CDATA[# netstat -lnptu |grep "httpd2\W*$"
|
|
tcp 0 0 1.2.3.4:80 0.0.0.0:* LISTEN 12345/httpd2
|
|
tcp 0 0 2001:0db8:100::1:80 :::* LISTEN 12345/httpd2
|
|
tcp 0 0 2001:0db8:100::2:80 :::* LISTEN 12345/httpd2
|
|
]]></screen><para>For simple tests use the telnet example already shown.</para></sect3><sect3>
|
|
<title>Additional notes</title>
|
|
<itemizedlist>
|
|
<listitem><para>Apache2 supports a method called “sendfile” to speedup serving data. Some NIC drivers also support offline checksumming. In some cases, this can lead to connection problems and invalid TCP checksums. In this cases, disable “sendfile” either by recompiling using configure option “--without-sendfile” or by using the "EnableSendfile off" directive in configuration file.</para></listitem></itemizedlist></sect3></sect2></sect1><sect1 id='hints-daemons-radvd' >
|
|
<title><!-- anchor id="hints-daemons-radvd" -->Router Advertisement Daemon (radvd)</title>
|
|
<para>The router advertisement daemon is very useful on a LAN, if clients should be auto-configured. The daemon itself should run on the Linux default IPv6 gateway router (it's not required that this is also the default IPv4 gateway, so pay attention who on your LAN is sending router advertisements). </para>
|
|
<para>You can specify some information and flags which should be contained in the advertisement. Common used are</para><itemizedlist>
|
|
<listitem><para>Prefix (needed)</para></listitem><listitem><para>Lifetime of the prefix</para></listitem><listitem><para>Frequency of sending advertisements (optional)</para></listitem></itemizedlist><para>After a proper configuration, the daemon sends advertisements through specified interfaces and clients are hopefully receive them and auto-magically configure addresses with received prefix and the default route.</para><sect2>
|
|
<title>Configuring radvd</title>
|
|
<sect3>
|
|
<title>Simple configuration</title>
|
|
<para>Radvd's config file is normally /etc/radvd.conf. An simple example looks like following:</para><screen>
|
|
<![CDATA[interface eth0 {
|
|
AdvSendAdvert on;
|
|
MinRtrAdvInterval 3;
|
|
MaxRtrAdvInterval 10;
|
|
prefix 2001:0db8:0100:f101::/64 {
|
|
AdvOnLink on;
|
|
AdvAutonomous on;
|
|
AdvRouterAddr on;
|
|
};
|
|
};
|
|
]]></screen><para>This results on client side in</para><screen>
|
|
<![CDATA[# ip -6 addr show eth0
|
|
3: eth0: <BROADCAST,MULTICAST,UP> mtu 1500 qdisc pfifo_fast qlen 100
|
|
inet6 2001:0db8:100:f101:2e0:12ff:fe34:1234/64 scope global dynamic
|
|
valid_lft 2591992sec preferred_lft 604792sec
|
|
inet6 fe80::2e0:12ff:fe34:1234/10 scope link
|
|
]]></screen><para>Because no lifetime was defined, a very high value was used.</para></sect3><sect3>
|
|
<title>Special 6to4 configuration</title>
|
|
<para>Version since 0.6.2pl3 support the automatic (re)-generation of the prefix depending on an IPv4 address of a specified interface. This can be used to distribute advertisements in a LAN after the 6to4 tunneling has changed. Mostly used behind a dynamic dial-on-demand Linux router. Because of the sure shorter lifetime of such prefix (after each dial-up, another prefix is valid), the lifetime configured to minimal values:</para><screen>
|
|
<![CDATA[interface eth0 {
|
|
AdvSendAdvert on;
|
|
MinRtrAdvInterval 3;
|
|
MaxRtrAdvInterval 10;
|
|
prefix 0:0:0:f101::/64 {
|
|
AdvOnLink off;
|
|
AdvAutonomous on;
|
|
AdvRouterAddr on;
|
|
Base6to4Interface ppp0;
|
|
AdvPreferredLifetime 20;
|
|
AdvValidLifetime 30;
|
|
};
|
|
};
|
|
]]></screen><para>This results on client side in (assuming, ppp0 has currently 1.2.3.4 as local IPv4 address):</para><screen>
|
|
<![CDATA[# /sbin/ip -6 addr show eth0
|
|
3: eth0: <BROADCAST,MULTICAST,UP> mtu 1500 qdisc pfifo_fast qlen 100
|
|
inet6 2002:0102:0304:f101:2e0:12ff:fe34:1234/64 scope global dynamic
|
|
valid_lft 22sec preferred_lft 12sec
|
|
inet6 fe80::2e0:12ff:fe34:1234/10 scope link
|
|
]]></screen><para>Because a small lifetime was defined, such prefix will be thrown away quickly, if no related advertisement was received.</para>
|
|
<para>Additional note: if you do not used special 6to4 support in initscripts, you have to setup a special route on the internal interface on the router, otherwise you will get some backrouting problems. for the example showh here:</para><screen>
|
|
<![CDATA[# /sbin/ip -6 route add 2002:0102:0304:f101::/64 dev eth0 metric 1
|
|
]]></screen><para>This route needs to be replaced every time the prefix changes, which is the case after a new IPv4 address was assigned to the dial-up interface.</para></sect3></sect2><sect2>
|
|
<title>Debugging</title>
|
|
<para>A program called “radvdump” can help you looking into sent or received advertisements. Simple to use:</para><screen>
|
|
<![CDATA[# radvdump
|
|
Router advertisement from fe80::280:c8ff:feb9:cef9 (hoplimit 255)
|
|
AdvCurHopLimit: 64
|
|
AdvManagedFlag: off
|
|
AdvOtherConfigFlag: off
|
|
AdvHomeAgentFlag: off
|
|
AdvReachableTime: 0
|
|
AdvRetransTimer: 0
|
|
Prefix 2002:0102:0304:f101::/64
|
|
AdvValidLifetime: 30
|
|
AdvPreferredLifetime: 20
|
|
AdvOnLink: off
|
|
AdvAutonomous: on
|
|
AdvRouterAddr: on
|
|
Prefix 2001:0db8:100:f101::/64
|
|
AdvValidLifetime: 2592000
|
|
AdvPreferredLifetime: 604800
|
|
AdvOnLink: on
|
|
AdvAutonomous: on
|
|
AdvRouterAddr: on
|
|
AdvSourceLLAddress: 00 80 12 34 56 78
|
|
]]></screen><para>Output shows you each advertisement package in readable format. You should see your configured values here again, if not, perhaps it's not your radvd which sends the advertisement...look for another router on the link (and take the LLAddress, which is the MAC address for tracing).</para></sect2></sect1><sect1 id='hints-daemons-dhcpv6.' >
|
|
<title><!-- anchor id="hints-daemons-dhcpv6." -->Dynamic Host Configuration v6 Server (dhcp6s)</title>
|
|
<para>DHCPv6 can be used for stateful configurations. The daemon itself need not necessary run on the Linux default IPv6 gateway router. </para>
|
|
<para>You can specify more information than by using radvd. The are most similar to IPv4 DHCP server.</para>
|
|
<para>After a proper configuration, the daemon reacts on received ICMPv6 multicast packets sent by a client to address ff02::1:2</para><sect2>
|
|
<title>Configuration of the DHCPv6 server (dhcp6s)</title>
|
|
<sect3>
|
|
<title>Simple configuration</title>
|
|
<para>dhcp6s's config file is normally /etc/dhcp6s.conf. An simple example looks like following:</para><screen>
|
|
<![CDATA[interface eth0 {
|
|
server-preference 255;
|
|
renew-time 60;
|
|
rebind-time 90;
|
|
prefer-life-time 130;
|
|
valid-life-time 200;
|
|
allow rapid-commit;
|
|
option dns_servers 2001:db8:0:f101::1 sub.domain.example;
|
|
link AAA {
|
|
range 2001:db8:0:f101::1000 to 2001:db8:0:f101::ffff/64;
|
|
prefix 2001:db8:0:f101::/64;
|
|
};
|
|
};
|
|
]]></screen></sect3></sect2><sect2>
|
|
<title>Configuration of the DHCPv6 client (dhcp6c)</title>
|
|
<sect3>
|
|
<title>Simple configuration</title>
|
|
<para>dhcp6c's config file is normally /etc/dhcp6c.conf. An simple example looks like following:</para><screen>
|
|
<![CDATA[interface eth0 {
|
|
send rapid-commit;
|
|
request domain-name-servers;
|
|
};
|
|
]]></screen></sect3></sect2><sect2>
|
|
<title>Usage</title>
|
|
<sect3>
|
|
<title>dhcpv6_server</title>
|
|
<para>Start server, e.g.</para><screen>
|
|
<![CDATA[# service dhcp6s start
|
|
]]></screen></sect3><sect3>
|
|
<title>dhcpv6_client</title>
|
|
<para>Start client in foreground, e.g.</para><screen>
|
|
<![CDATA[# dhcp6c -f eth0
|
|
]]></screen></sect3></sect2><sect2>
|
|
<title>Debugging</title>
|
|
<sect3>
|
|
<title>dhcpv6_server</title>
|
|
<para>The server has one foreground and two debug toggles (both should be used for debugging), here is an example:</para><screen>
|
|
<![CDATA[# dhcp6s -d -D -f eth0
|
|
]]></screen></sect3><sect3>
|
|
<title>dhcpv6_client</title>
|
|
<para>As general debugging for test whether the IPv6 DHCP server is reable on the link use an IPv6 ping to the DHCP multicast address:</para><screen>
|
|
<![CDATA[# ping6 -I eth0 ff02::1:2
|
|
]]></screen><para>The client has one foreground and two debug toggles, here is an example:</para><screen>
|
|
<![CDATA[# dhcp6c -d -f eth0
|
|
Oct/03/2005 17:18:16 dhcpv6 doesn't support hardware type 776
|
|
Oct/03/2005 17:18:16 doesn't support sit0 address family 0
|
|
Oct/03/2005 17:18:16 netlink_recv_rtgenmsg error
|
|
Oct/03/2005 17:18:16 netlink_recv_rtgenmsg error
|
|
Oct/03/2005 17:18:17 status code for this address is: success
|
|
Oct/03/2005 17:18:17 status code: success
|
|
Oct/03/2005 17:18:17 netlink_recv_rtgenmsg error
|
|
Oct/03/2005 17:18:17 netlink_recv_rtgenmsg error
|
|
Oct/03/2005 17:18:17 assigned address 2001:db8:0:f101::1002 prefix len is not
|
|
¬ in any RAs prefix length using 64 bit instead
|
|
Oct/03/2005 17:18:17 renew time 60, rebind time 9
|
|
]]></screen><para>Note that the netlink error messages have no impact.</para></sect3></sect2></sect1><sect1 id='hints-daemons-isc-dhcp' >
|
|
<title><!-- anchor id="hints-daemons-isc-dhcp" -->ISC Dynamic Host Configuration Server (dhcpd)</title>
|
|
<para>ISC DHCP supports IPv6 since version 4.x.</para><sect2>
|
|
<title>Configuration of the ISC DHCP server for IPv6 (dhcpd)</title>
|
|
<para>Note that currently, the ISC DHCP server can only serve IPv4 or IPv6, means you have to start the daemon twice (for IPv6 with option “-6”) to support both protocols.</para><sect3>
|
|
<title>Simple configuration</title>
|
|
<para>Create a dedicated configuration file /etc/dhcp/dhcpd6.conf for the IPv6 part of the dhcpd. Note, that the router requires to have a interface configured with an IPv6 address out of the defined subnet.</para><screen>
|
|
<![CDATA[default-lease-time 600;
|
|
max-lease-time 7200;
|
|
log-facility local7;
|
|
subnet6 2001:db8:0:1::/64 {
|
|
# Range for clients
|
|
range6 2001:db8:0:1::129 2001:db8:0:1::254;
|
|
# Additional options
|
|
option dhcp6.name-servers fec0:0:0:1::1;
|
|
option dhcp6.domain-search "domain.example";
|
|
# Prefix range for delegation to sub-routers
|
|
prefix6 2001:db8:0:100:: 2001:db8:0:f00:: /56;
|
|
# Example for a fixed host address
|
|
host specialclient {
|
|
host-identifier option dhcp6.client-id 00:01:00:01:4a:1f:ba:e3:60:b9:1f:01:23:45;
|
|
fixed-address6 2001:db8:0:1::127;
|
|
}
|
|
}
|
|
]]></screen><para>Note that the “dhcp.client-id” no longer belongs to a MAC address, an unique ID is used instead! “dhcp6c” (see above) uses the file /var/lib/dhcpv6/dhcp6c_duid (would be created during first start, if not existing) as unique identity. It's a 14 byte long identifier, starting with a 2 byte length information (usually “0x000e”):</para><screen>
|
|
<![CDATA[# hexdump -e '"%07.7_ax " 1/2 "%04x" " " 14/1 "%02x:" "\n"' /var/lib/dhcpv6/dhcp6c_duid 0000000 000e 00:01:00:01:4a:1f:ba:e3:60:b9:1f:01:23:45:
|
|
]]></screen></sect3></sect2><sect2>
|
|
<title>Usage</title>
|
|
<sect3>
|
|
<title>dhcpd</title>
|
|
<para>Start server in foreground:</para><screen>
|
|
<![CDATA[# /usr/sbin/dhcpd -6 -f -cf /etc/dhcp/dhcpd.conf eth1
|
|
Internet Systems Consortium DHCP Server 4.1.0
|
|
Copyright 2004-2008 Internet Systems Consortium.
|
|
All rights reserved.
|
|
For info, please visit http://www.isc.org/sw/dhcp/
|
|
Not searching LDAP since ldap-server, ldap-port and ldap-base-dn were not specified in the config file
|
|
Wrote 0 leases to leases file.
|
|
Bound to *:547
|
|
Listening on Socket/5/eth1/2001:db8:0:1::/64
|
|
Sending on Socket/5/eth1/2001:db8:0:1::/64
|
|
]]></screen></sect3></sect2></sect1><sect1 id='hints-daemons-dibbler' >
|
|
<title><!-- anchor id="hints-daemons-dibbler" -->DHCP Server Dibbler</title>
|
|
<para>Dibbler is also a DHCP server</para><sect2>
|
|
<title>Configuration of the Dibbler DHCP server for IPv6</title>
|
|
<sect3>
|
|
<title>Simple configuration</title>
|
|
<para>Create a dedicated configuration file /etc/dibbler/server.conf . Note, that the router requires to have a interface configured with an IPv6 address out of the defined subnet.</para><screen>
|
|
<![CDATA[log-level 8
|
|
log-mode short
|
|
preference 0
|
|
iface "eth1" {
|
|
// also ranges can be defines, instead of exact values t1 1800-2000 t2 2700-3000
|
|
prefered-lifetime 3600
|
|
valid-lifetime 7200
|
|
class {
|
|
pool 2001:6f8:12d8:1::/64
|
|
}
|
|
option dns-server fec0:0:0:1::1
|
|
option domain domain.example
|
|
}
|
|
]]></screen></sect3></sect2><sect2>
|
|
<title>Usage</title>
|
|
<sect3>
|
|
<title>dibbler-server</title>
|
|
<para>Start server in foreground:</para><screen>
|
|
<![CDATA[# dibbler-server run
|
|
| Dibbler - a portable DHCPv6, version 0.7.3 (SERVER, Linux port)
|
|
| Authors : Tomasz Mrugalski<thomson(at)klub.com.pl>,Marek Senderski<msend(at)o2.pl>
|
|
| Licence : GNU GPL v2 only. Developed at Gdansk University of Technology.
|
|
| Homepage: http://klub.com.pl/dhcpv6/
|
|
2009.05.28 10:18:48 Server Notice My pid (1789) is stored in /var/lib/dibbler/server.pid
|
|
2009.05.28 10:18:48 Server Notice Detected iface eth0/3, MAC=54:52:00:01:23:45.
|
|
2009.05.28 10:18:48 Server Notice Detected iface eth1/2, MAC=54:52:00:67:89:ab.
|
|
2009.05.28 10:18:48 Server Notice Detected iface lo/1, MAC=00:00:00:00:00:00.
|
|
2009.05.28 10:18:48 Server Debug Skipping database loading.
|
|
2009.05.28 10:18:48 Server Debug Cache:server-cache.xml file: parsing started, expecting 0 entries.
|
|
2009.05.28 10:18:48 Server Notice Parsing /etc/dibbler/server.conf config file...
|
|
18:48 Server Debug Setting 0 generic option(s).
|
|
18:48 Server Debug 0 per-client configurations (exceptions) added.
|
|
18:48 Server Debug Parsing /etc/dibbler/server.conf done.
|
|
18:48 Server Info 0 client class(es) defined.
|
|
18:48 Server Debug 1 interface(s) specified in /etc/dibbler/server.conf
|
|
18:48 Server Info Mapping allow, deny list to class 0:0 allow/deny entries in total.
|
|
18:48 Server Info Interface eth1/2 configuration has been loaded.
|
|
18:48 Server Notice Running in stateful mode.
|
|
18:48 Server Info My DUID is 00:01:00:01:11:aa:6d:a7:54:52:00:67:89:ab.
|
|
18:48 Server Notice Creating multicast (ff02::1:2) socket on eth1/2 (eth1/2) interface.
|
|
18:48 Server Debug Cache: size set to 1048576 bytes, 1 cache entry size is 87 bytes, so maximum 12052 address-client pair(s) may be cached.
|
|
18:48 Server Notice Accepting connections. Next event in 4294967295 second(s).
|
|
]]></screen></sect3></sect2></sect1><sect1 id='hints-daemons-tcpwrapper' >
|
|
<title><!-- anchor id="hints-daemons-tcpwrapper" -->tcp_wrapper</title>
|
|
<para>tcp_wrapper is a library which can help you to protect service against misuse.</para><sect2>
|
|
<title>Filtering capabilities</title>
|
|
<para>You can use tcp_wrapper for</para><itemizedlist>
|
|
<listitem><para>Filtering against source addresses (IPv4 or IPv6)</para></listitem><listitem><para>Filtering against users (requires a running ident daemon on the client)</para></listitem></itemizedlist></sect2><sect2>
|
|
<title>Which program uses tcp_wrapper</title>
|
|
<para>Following are known:</para><itemizedlist>
|
|
<listitem><para>Each service which is called by xinetd (if xinetd is compiled using tcp_wrapper library)</para></listitem><listitem><para>sshd (if compiled using tcp_wrapper)</para></listitem></itemizedlist></sect2><sect2>
|
|
<title>Usage</title>
|
|
<para>tcp_wrapper is controlled by two files name /etc/hosts.allow and /etc/hosts.deny. For more information see</para><screen>
|
|
<![CDATA[$ man hosts.allow
|
|
]]></screen><sect3>
|
|
<title>Example for /etc/hosts.allow</title>
|
|
<para>In this file, each service which should be positive filtered (means connects are accepted) need a line.</para><screen>
|
|
<![CDATA[sshd: 1.2.3. [2001:0db8:100:200::]/64
|
|
daytime-stream: 1.2.3. [2001:0db8:100:200::]/64
|
|
]]></screen><para>Note: there are broken implementations around, which uses following broken IPv6 network description: [2001:0db8:100:200::/64]. Hopefully, such versions will be fixed soon.</para></sect3><sect3>
|
|
<title>Example for /etc/hosts.deny</title>
|
|
<para>This file contains all negative filter entries and should normally deny the rest using</para><screen>
|
|
<![CDATA[ALL: ALL
|
|
]]></screen><para>If this node is a more sensible one you can replace the standard line above with this one, but this can cause a DoS attack (load of mailer and spool directory), if too many connects were made in short time. Perhaps a logwatch is better for such issues.</para><screen>
|
|
<![CDATA[ALL: ALL: spawn (echo "Attempt from %h %a to %d at `date`"
|
|
| tee -a /var/log/tcp.deny.log | mail root@localhost)
|
|
]]></screen></sect3></sect2><sect2>
|
|
<title>Logging</title>
|
|
<para>Depending on the entry in the syslog daemon configuration file /etc/syslog.conf the tcp_wrapper logs normally into /var/log/secure.</para><sect3>
|
|
<title>Refused connection</title>
|
|
<para>A refused connection via IPv4 to an xinetd covered daytime service produces a line like following example</para><screen>
|
|
<![CDATA[Jan 2 20:40:44 gate xinetd-ipv6[12346]: FAIL: daytime-stream libwrap
|
|
¬ from=::ffff:1.2.3.4
|
|
Jan 2 20:32:06 gate xinetd-ipv6[12346]: FAIL: daytime-stream libwrap
|
|
from=2001:0db8:100:200::212:34ff:fe12:3456
|
|
]]></screen><para>A refused connection via IPv4 to an dual-listen sshd produces a line like following example</para><screen>
|
|
<![CDATA[Jan 2 20:24:17 gate sshd[12345]: refused connect from ::ffff:1.2.3.4
|
|
¬ (::ffff:1.2.3.4)
|
|
Jan 2 20:39:33 gate sshd[12345]: refused connect
|
|
from 2001:0db8:100:200::212:34ff:fe12:3456
|
|
¬ (2001:0db8:100:200::212:34ff:fe12:3456)
|
|
]]></screen></sect3><sect3>
|
|
<title>Permitted connection</title>
|
|
<para>A permitted connection via IPv4 to an xinetd covered daytime service produces a line like following example</para><screen>
|
|
<![CDATA[Jan 2 20:37:50 gate xinetd-ipv6[12346]: START: daytime-stream pid=0
|
|
¬ from=::ffff:1.2.3.4
|
|
Jan 2 20:37:56 gate xinetd-ipv6[12346]: START: daytime-stream pid=0
|
|
from=2001:0db8:100:200::212:34ff:fe12:3456
|
|
]]></screen><para>A permitted connection via IPv4 to an dual-listen sshd produces a line like following example</para><screen>
|
|
<![CDATA[Jan 2 20:43:10 gate sshd[21975]: Accepted password for user from ::ffff:1.2.3.4
|
|
¬ port 33381 ssh2
|
|
Jan 2 20:42:19 gate sshd[12345]: Accepted password for user
|
|
from 2001:0db8:100:200::212:34ff:fe12:3456 port 33380 ssh2
|
|
]]></screen></sect3></sect2></sect1><sect1 id='hints-daemons-vsftpd' >
|
|
<title><!-- anchor id="hints-daemons-vsftpd" -->vsftpd</title>
|
|
<sect2>
|
|
<title>Listening on IPv6 addresses</title>
|
|
<para>Edit the configuration file, ususally /etc/vsftpd/vsftpd.conf, and adjust the listen option like</para><screen>
|
|
<![CDATA[listen_ipv6=yes
|
|
]]></screen><para>That's all.</para></sect2></sect1><sect1 id='hints-daemons-proftpd' >
|
|
<title><!-- anchor id="hints-daemons-proftpd" -->proftpd</title>
|
|
<sect2>
|
|
<title>Listening on IPv6 addresses</title>
|
|
<para>Edit the configuration file, ususally /etc/proftpd.conf, but take care, not 100% logical in virtual host setup</para><screen>
|
|
<![CDATA[<VirtualHost 192.0.2.1>
|
|
...
|
|
Bind 2001:0DB8::1
|
|
...
|
|
</VirtualHost>
|
|
]]></screen><para>That's all.</para></sect2></sect1><sect1 id='hints-daemons-others' >
|
|
<title><!-- anchor id="hints-daemons-others" -->Other daemons</title>
|
|
<para>Nowadays it's mostly simple, look for either a command line option or a configuration value to enable IPv6 listening. See manual page of the daemon or check related FAQs. It can happen that you can bind a daemon only to the IPv6-“any”-address (::) and not to bind to a dedicated IPv6 address, because the lack of support (depends on that what the programmer has implemented so far...).</para></sect1></chapter><chapter id='chapter-programming' >
|
|
<title><!-- anchor id="chapter-programming" -->Programming</title>
|
|
<sect1 id='chapter-section-using-API' >
|
|
<title><!-- anchor id="chapter-section-using-API" --><!-- anchor id="chapter-programming-using-API" -->Programming using C-API</title>
|
|
<para>Related RFCs:</para><itemizedlist>
|
|
<listitem><para><ulink url="http://www.faqs.org/rfcs/rfc3493.html">RFC 3493 / Basic Socket Interface Extensions for IPv6</ulink></para></listitem><listitem><para><ulink url="http://www.faqs.org/rfcs/rfc3542.html">RFC 3542 / Advanced Sockets Application Program Interface (API) for IPv6</ulink></para></listitem></itemizedlist><para>Following contents of this section is contributed by John Wenker, Sr. Software Engineer Performance Technologies San Diego, CA USA <ulink url="http://www.pt.com/">http://www.pt.com/</ulink>.</para>
|
|
<para>
|
|
</para>
|
|
<para>This section describes how to write IPv6 client-server applications under the Linux operating system. First thing's first, and credit must be given where it is due. The information contained in this section is derived from Chapters 2 through 4 of IPv6 Network Programming by Jun-ichiro itojun Hagino (ISBN 1-55558-318-0). The reader is encouraged to consult that book for more detailed information. It describes how to convert IPv4 applications to be IPv6 compatible in a protocol-independent way, and describes some of the common problems encountered during the conversion along with suggested solutions. At the time of this writing, this is the only book of which the author is aware that specifically addresses how to program IPv6 applications [since writing this section, the author has also become aware of the Porting applications to IPv6 HowTo by Eva M. Castro at <ulink url="http://jungla.dit.upm.es/~ecastro/IPv6-web/ipv6.html">http://jungla.dit.upm.es/~ecastro/IPv6-web/ipv6.html</ulink>]. Unfortunately, of the almost 360 pages in the book, maybe 60 are actually useful (the chapters mentioned). Nevertheless, without the guidance of that book, the author would have been unable to perform his job duties or compose this HowTo. While most (but certainly not all) of the information in the Hagino book is available via the Linux 'man' pages, application programmers will save a significant amount of time and frustration by reading the indicated chapters of the book rather than searching through the 'man' pages and online documentation.</para>
|
|
<para>Other than the Hagino book, any other information presented in this HowTo was obtained through trial and error. Some items or explanations may not be entirely “correct” in the grand IPv6 scheme, but seem to work in practical application.</para>
|
|
<para>The discussion that follows assumes the reader is already experienced with the traditional TCP/IP socket API. For more information on traditional socket programming, the Internetworking with TCP/IP series of textbooks by Comer & Stevens is hard to beat, specifically Volume III: Client-Server Programming and Applications, Linux/POSIX Sockets Version (ISBN 0-13-032071-4). This HowTo also assumes that the reader has had at least a bare basic introduction to IPv6 and in particular the addressing scheme for network addresses (see Section 2.3).</para><sect2>
|
|
<title>Address Structures</title>
|
|
<para>This section provides a brief overview of the structures provided in the socket API to represent network addresses (or more specifically transport endpoints) when using the Internet protocols in a client-server application.</para><sect3>
|
|
<title>IPv4 sockaddr_in</title>
|
|
<para>In IPv4, network addresses are 32 bits long and define a network node. Addresses are written in dotted decimal notation, such as 192.0.2.1, where each number represents eight bits of the address. Such an IPv4 address is represented by the struct sockaddr_in data type, which is defined in <netinet/in.h>.</para><screen>
|
|
<![CDATA[struct sockaddr_in
|
|
{
|
|
sa_family_t sin_family;
|
|
in_port_t sin_port;
|
|
struct in_addr sin_addr;
|
|
/* Plus some padding for alignment */
|
|
};
|
|
]]></screen><para>The sin_family component indicates the address family. For IPv4 addresses, this is always set to AF_INET. The sin_addr field contains the 32-bit network address (in network byte order). Finally, the sin_port component represents the transport layer port number (in network byte order). Readers should already be familiar with this structure, as this is the standard IPv4 address structure.</para></sect3><sect3>
|
|
<title>IPv6 sockaddr_in6</title>
|
|
<para>The biggest feature of IPv6 is its increased address space. Instead of 32-bit network addresses, IPv6 allots 128 bits to an address. Addresses are written in colon-hex notation of the form fe80::2c0:8cff:fe01:2345, where each hex number separated by colons represents 16 bits of the address. Two consecutive colons indicate a string of consecutive zeros for brevity, and at most only one double-colon may appear in the address. IPv6 addresses are represented by the struct sockaddr_in6 data type, also defined in <netinet/in.h>.</para><screen>
|
|
<![CDATA[struct sockaddr_in6
|
|
{
|
|
sa_family_t sin6_family;
|
|
in_port_t sin6_port;
|
|
uint32_t sin6_flowinfo;
|
|
struct in6_addr sin6_addr;
|
|
uint32_t sin6_scope_id;
|
|
};
|
|
]]></screen><para>The sin6_family, sin6_port, and sin6_addr components of the structure have the same meaning as the corresponding fields in the sockaddr_in structure. However, the sin6_family member is set to AF_INET6 for IPv6 addresses, and the sin6_addr field holds a 128-bit address instead of only 32 bits.</para>
|
|
<para>The sin6_flowinfo field is used for flow control, but is not yet standardized and can be ignored.</para>
|
|
<para>The sin6_scope_id field has an odd use, and it seems (at least to this naïve author) that the IPv6 designers took a huge step backwards when devising this. Apparently, 128-bit IPv6 network addresses are not unique. For example, it is possible to have two hosts, on separate networks, with the same link-local address (see Figure 1). In order to pass information to a specific host, more than just the network address is required; the scope identifier must also be specified. In Linux, the network interface name is used for the scope identifier (e.g. “eth0”) [be warned that the scope identifier is implementation dependent!]. Use the ifconfig(1M) command to display a list of active network interfaces.</para>
|
|
<para>A colon-hex network address can be augmented with the scope identifier to produce a "scoped address”. The percent sign ('%') is used to delimit the network address from the scope identifier. For example, fe80::1%eth0 is a scoped IPv6 address where fe80::1 represents the 128-bit network address and eth0 is the network interface (i.e. the scope identifier). Thus, if a host resides on two networks, such as Host B in example below, the user now has to know which path to take in order to get to a particular host. In Figure 1, Host B addresses Host A using the scoped address fe80::1%eth0, while Host C is addressed with fe80::1%eth1.</para><screen>
|
|
<![CDATA[Host A (fe80::1) ---- eth0 ---- Host B ---- eth1 ---- Host C (fe80::1)
|
|
]]></screen><para>Getting back to the sockaddr_in6 structure, its sin6_scope_id field contains the index of the network interface on which a host may be found. Server applications will have this field set automatically by the socket API when they accept a connection or receive a datagram. For client applications, if a scoped address is passed as the node parameter to getaddrinfo(3) (described later in this HowTo), then the sin6_scope_id field will be filled in correctly by the system upon return from the function; if a scoped address is not supplied, then the sin6_scope_id field must be explicitly set by the client software prior to attempting to communicate with the remote server. The if_nametoindex(3) function is used to translate a network interface name into its corresponding index. It is declared in <net/if.h>.</para></sect3><sect3>
|
|
<title>Generic Addresses</title>
|
|
<para>As any programmer familiar with the traditional TCP/IP socket API knows, several socket functions deal with "generic" pointers. For example, a pointer to a generic struct sockaddr data type is passed as a parameter to some socket functions (such as connect(2) or bind(2)) rather than a pointer to a specific address type. Be careful… the sockaddr_in6 structure is larger than the generic sockaddr structure! Thus, if your program receives a generic address whose actual type is unknown (e.g. it could be an IPv4 address structure or an IPv6 address structure), you must supply sufficient storage to hold the entire address. The struct sockaddr_storage data type is defined in <bits/socket.h> for this purpose [do not #include this file directly within an application; use <sys/socket.h> as usual, and <bits/socket.h> will be implicitly included].</para>
|
|
<para>For example, consider the recvfrom(2) system call, which is used to receive a message from a remote peer. Its function prototype is:</para><screen>
|
|
<![CDATA[ssize_t recvfrom( int s,
|
|
void *buf,
|
|
size_t len,
|
|
int flags,
|
|
struct sockaddr *from,
|
|
socklen_t *fromlen );
|
|
]]></screen><para>The from parameter points to a generic sockaddr structure. If data can be received from an IPv6 peer on the socket referenced by s, then from should point to a data type of struct sockaddr_storage, as in the following dummy example:</para><screen>
|
|
<![CDATA[/*
|
|
** Read a message from a remote peer, and return a buffer pointer to
|
|
** the caller.
|
|
**
|
|
** 's' is the file descriptor for the socket.
|
|
*/
|
|
char *rcvMsg( int s )
|
|
{
|
|
static char bfr[ 1025 ]; /* Where the msg is stored. */
|
|
ssize_t count;
|
|
struct sockaddr_storage ss; /* Where the peer adr goes. */
|
|
socklen_t sslen;
|
|
sslen = sizeof( ss );
|
|
count = recvfrom( s,
|
|
bfr,
|
|
sizeof( bfr ) - 1,
|
|
0,
|
|
(struct sockaddr*) &ss,
|
|
&sslen );
|
|
bfr[ count ] = '\0'; /* Null-terminates the message. */
|
|
return bfr;
|
|
} /* End rcvMsg() */
|
|
]]></screen><para>As seen in the above example, ss (a struct sockaddr_storage data object) is used to receive the peer address information, but it's address is typecast to a generic struct sockaddr* pointer in the call to recvfrom(2). </para></sect3></sect2><sect2>
|
|
<title>Lookup Functions</title>
|
|
<para>Traditionally, hostname and service name resolution were performed by functions such as gethostbyname(3) and getservbyname(3). These traditional lookup functions are still available, but they are not forward compatible to IPv6. Instead, the IPv6 socket API provides new lookup functions that consolidate the functionality of several traditional functions. These new lookup functions are also backward compatible with IPv4, so a programmer can use the same translation algorithm in an application for both the IPv4 and IPv6 protocols. This is an important feature, because obviously a global IPv6 infrastructure isn't going to be put in place overnight. Thus, during the transition period from IPv4 to IPv6, client-server applications should be designed with the flexibility to handle both protocols simultaneously. The example programs at the end of this chapter do just that.</para>
|
|
<para>The primary lookup function in the new socket API is getaddrinfo(3). Its prototype is as follows. </para><screen>
|
|
<![CDATA[int getaddrinfo( const char *node,
|
|
const char *service,
|
|
const struct addrinfo *hints,
|
|
struct addrinfo **res );
|
|
]]></screen><para>The node parameter is a pointer to the hostname or IP address being translated. The referenced string can be a hostname, IPv4 dotted decimal address, or IPv6 colon-hex address (possibly scoped). The service parameter is a pointer to the transport layer's service name or port number. It can be specified as a name found in /etc/services or a decimal number. getaddrinfo(3) resolves the host/service combination and returns a list of address records; a pointer to the list is placed in the location pointed at by res. For example, suppose a host can be identified by both an IPv4 and IPv6 address, and that the indicated service has both a TCP entry and UDP entry in /etc/services. In such a scenario, it is not inconceivable that four address records are returned; one for TCP/IPv6, one for UDP/IPv6, one for TCP/IPv4, and one for UDP/IPv4.</para>
|
|
<para>The definition for struct addrinfo is found in <netdb.h> (as is the declaration for getaddrinfo(3) and the other functions described in this section). The structure has the following format:</para><screen>
|
|
<![CDATA[struct addrinfo
|
|
{
|
|
int ai_flags;
|
|
int ai_family;
|
|
int ai_socktype;
|
|
int ai_protocol;
|
|
socklen_t ai_addrlen;
|
|
struct sockaddr *ai_addr;
|
|
char *ai_canonname;
|
|
struct addrinfo *ai_next;
|
|
};
|
|
]]></screen><para>Consult the 'man' page for getaddrinfo(3) for detailed information about the various fields; this HowTo only describes a subset of them, and only to the extent necessary for normal IPv6 programming.</para>
|
|
<para>The ai_family, ai_socktype, and ai_protocol fields have the exact same meaning as the parameters to the socket(2) system call. The ai_family field indicates the protocol family (not the address family) associated with the record, and will be PF_INET6 for IPv6 or PF_INET for IPv4. The ai_socktype parameter indicates the type of socket to which the record corresponds; SOCK_STREAM for a reliable connection-oriented byte-stream or SOCK_DGRAM for connectionless communication. The ai_protocol field specifies the underlying transport protocol for the record.</para>
|
|
<para>The ai_addr field points to a generic struct sockaddr object. Depending on the value in the ai_family field, it will point to either a struct sockaddr_in (PF_INET) or a struct sockaddr_in6 (PF_INET6). The ai_addrlen field contains the size of the object pointed at by the ai_addr field.</para>
|
|
<para>As mentioned, getaddrinfo(3) returns a list of address records. The ai_next field points to the next record in the list.</para>
|
|
<para>The hints parameter to getaddrinfo(3) is also of type struct addrinfo and acts as a filter for the address records returned in res. If hints is NULL, all matching records are returned; but if hints is non-NULL, the referenced structure gives "hints" to getaddrinfo(3) about which records to return. Only the ai_flags, ai_family, ai_socktype, and ai_protocol fields are significant in the hints structure, and all other fields should be set to zero.</para>
|
|
<para>Programs can use hints->ai_family to specify the protocol family. For example, if it is set to PF_INET6, then only IPv6 address records are returned. Likewise, setting hints->ai_family to PF_INET results in only IPv4 address records being returned. If an application wants both IPv4 and IPv6 records, the field should be set to PF_UNSPEC.</para>
|
|
<para>The hints->socktype field can be set to SOCK_STREAM to return only records that correspond to connection-oriented byte streams, SOCK_DGRAM to return only records corresponding to connectionless communication, or 0 to return both.</para>
|
|
<para>For the Internet protocols, there is only one protocol associated with connection-oriented sockets (TCP) and one protocol associated with connectionless sockets (UDP), so setting hints->ai_socktype to SOCK_STREAM or SOCK_DGRAM is the same as saying, "Give me only TCP records," or "Give me only UDP records," respectively. With that in mind, the hints->ai_protocol field isn't really that important with the Internet protocols, and pretty much mirrors the hints->ai_socktype field. Nevertheless, hints->ai_protocol can be set to IPPROTO_TCP to return only TCP records, IPPROTO_UDP to return only UDP records, or 0 for both.</para>
|
|
<para>The node or service parameter to gethostbyname(3) can be NULL, but not both. If node is NULL, then the ai_flags field of the hints parameter specifies how the network address in a returned record is set (i.e. the sin_addr or sin6_addr field of the object pointed at by the ai_addr component in a returned record). If the AI_PASSIVE flag is set in hints, then the returned network addresses are left unresolved (all zeros). This is how server applications would use getaddrinfo(3). If the flag is not set, then the address is set to the local loopback address (::1 for IPv6 or 127.0.0.1 for IPv4). This is one way a client application can specify that the target server is running on the same machine as the client. If the service parameter is NULL, the port number in the returned address records remains unresolved.</para>
|
|
<para>The getaddrinfo(3) function returns zero on success, or an error code. In the case of an error, the gai_strerror(3) function is used to obtain a character pointer to an error message corresponding to the error code, just like strerror(3) does in the standard 'C' library.</para>
|
|
<para>Once the address list is no longer needed, it must be freed by the application. This is done with the freeaddrinfo(3) function.</para>
|
|
<para>The last function that will be mentioned in this section is getnameinfo(3). This function is the inverse of getaddrinfo(3); it is used to create a string representation of the hostname and service from a generic struct sockaddr data object. It has the following prototype. </para><screen>
|
|
<![CDATA[int getnameinfo( const struct sockaddr *sa,
|
|
socklen_t salen,
|
|
char *host,
|
|
size_t hostlen,
|
|
char *serv,
|
|
size_t servlen,
|
|
int flags );
|
|
]]></screen><para>The sa parameter points to the address structure in question, and salen contains its size. The host parameter points to a buffer where the null-terminated hostname string is placed, and the hostlen parameter is the size of that buffer. If there is no hostname that corresponds to the address, then the network address (dotted decimal or colon-hex) is placed in host. Likewise, the serv parameter points to a buffer where the null-terminated service name string (or port number) is placed, and the servlen parameter is the size of that buffer. The flags parameter modifies the function's behavior; in particular, the NI_NUMERICHOST flag indicates that the converted hostname should always be formatted in numeric form (i.e. dotted decimal or colon-hex), and the NI_NUMERICSERV flag indicates that the converted service should always be in numeric form (i.e. the port number).</para>
|
|
<para>The symbols NI_MAXHOST and NI_MAXSERV are available to applications and represent the maximum size of any converted hostname or service name, respectively. Use these when declaring output buffers for getnameinfo(3).</para></sect2><sect2>
|
|
<title>Quirks Encountered</title>
|
|
<para>Before jumping into the programming examples, there are several quirks in IPv6 of which the reader should be aware. The more significant ones (in addition to the non-uniqueness of IPv6 network addresses already discussed) are described in the paragraphs below. </para><sect3>
|
|
<title>IPv4 Mapped Addresses</title>
|
|
<para>For security reasons that this author won't pretend to understand, "IPv4 mapped addresses" should not be allowed in IPv6-capable server applications. To put it in terms that everyone can understand, this simply means that a server should not accept IPv4 traffic on an IPv6 socket (an otherwise legal operation). An IPv4 mapped address is a mixed-format address of the form:</para><screen>
|
|
<![CDATA[::ffff:192.0.2.1
|
|
]]></screen><para>where the first portion is in IPv6 colon-hex format and the last portion is in IPv4 dotted decimal notation. The dotted decimal IPv4 address is the actual network address, but it is being mapped into an IPv6 compatible format.</para>
|
|
<para>To prevent IPv4 mapped addresses from being accepted on an IPv6 socket, server applications must explicitly set the IPV6_V6ONLY socket option on all IPv6 sockets created [the Hagino book implies that this is only a concern with server applications. However, it has been observed during testing that if a client application uses an IPv4 mapped address to specify the target server, and the target server has IPv4 mapped addresses disabled, the connection still completes regardless. On the server side, the connection endpoint is an IPv4 socket as desired; but on the client side, the connection endpoint is an IPv6 socket. Setting the IPV6_V6ONLY socket option on the client side as well as the server side prevents any connection from being established at all.]. There's only one problem. Apparently, IPV6_V6ONLY isn't defined on all systems [or at least it wasn't in 2005 when the Hagino book was written]. The server example at the end of this chapter provides a method for handling this problem.</para>
|
|
<para>If IPv4 traffic cannot be handled on IPv6 sockets, then that implies that server applications must open both an IPv4 and IPv6 socket for a particular network service if it wants to handle requests from either protocol. This goes back to the flexibility issue mentioned earlier. If getaddrinfo(3) returns multiple address records, then server applications should traverse the list and open a passive socket for each address provided. </para></sect3><sect3>
|
|
<title>Cannot Specify the Scope Identifier in /etc/hosts</title>
|
|
<para>It is possible to assign a hostname to an IPv6 network address in /etc/hosts. For example, the following is an excerpt from the /etc/hosts file on the author's development system. </para><screen>
|
|
<![CDATA[ ::1 localhost
|
|
127.0.0.1 localhost
|
|
fe80::2c0:8cff:fe01:2345 pt141
|
|
192.0.2.1 pt141
|
|
]]></screen><para>The "localhost" and "pt141" hostnames can be translated to either an IPv4 or IPv6 network address. So, for example, if "pt141" is passed as the node parameter to getaddrinfo(3), the function returns both an IPv4 and IPv6 address record for the host (assuming the behavior hasn't been modified by the hints parameter). Unfortunately, a scoped address cannot be used in /etc/hosts. Doing so results in getaddrinfo(3) returning only the IPv4 record.</para></sect3><sect3>
|
|
<title>Client & Server Residing on the Same Machine</title>
|
|
<para>Suppose a machine has the IPv4 address 192.0.2.1. A client application running on that machine can connect to a server application on the same machine by using either the local loopback address (127.0.0.1) or the network address (192.0.2.1) as the target server. Much to this author's surprise (and dismay), it turns out that an IPv6 client application cannot connect to a server application on the same machine if it uses the network address of that machine as the target; it must use the local loopback address (::1). </para></sect3></sect2><sect2>
|
|
<title>Putting It All Together (A Client-Server Programming Example)</title>
|
|
<para>Now it's time to put everything discussed thus far together into a sample client-server application. The remainder of this section is devoted to a remote time-of-day application (the 'daytime' Internet service) [I noticed that Ms. Castro used a 'daytime' example in her <emphasis>Porting applications to IPv6 HowTo</emphasis>. For the record, the source code presented here is original, developed from scratch, and any similarity between it and any other publicly available 'daytime' example is purely coincidental.]. The source code presented in this section was developed and tested on a RedHat Linux release using the 2.6 kernel (2.6.9 to be specific). Readers may use the source code freely, so long as proper credit is attributed; but of course the standard disclaimer must be given first: </para><blockquote>
|
|
<para>Although the sample source code is believed to be free of errors, the author makes no guarantees as to its reliability, especially considering that some error paths were intentionally omitted for brevity. Use it at your own risk!</para>
|
|
</blockquote><para>When you get right down to it, there really aren't that many differences between IPv4 and IPv6 applications. The trick is to code IPv6 applications in a protocol-independent manner, such that they can handle both IPv4 and IPv6 simultaneously and transparently. This sample application does just that. The only protocol-dependent code in the example occurs when printing network addresses in verbose mode; but only after the ai_family field in the addrinfo structure has been checked, so the programs know exactly what type of address they're handling at the time.</para><sect3>
|
|
<title>'Daytime' Server Code</title>
|
|
<para>The server code is found in file tod6d.c (time-of-day IPv6 daemon). Once built, the server may be started using the following command syntax (assuming tod6d is the executable file):</para><screen>
|
|
<![CDATA[tod6d [-v] [service]
|
|
]]></screen><para>ARGUMENTS: </para><variablelist>
|
|
<varlistentry><term>service</term><listitem><para>The service (or well-known port) on which to listen. Default is "daytime".</para></listitem></varlistentry></variablelist><para>OPTIONS:</para><variablelist>
|
|
<varlistentry><term>-v</term><listitem><para>Turn on verbose mode.</para></listitem></varlistentry></variablelist><para>The server handles both TCP and UDP requests on the network. The server source code contained in tod6d.c follows:</para><screen>
|
|
<![CDATA[/******************************************************************************
|
|
* File: tod6d.c
|
|
* Description: Contains source code for an IPv6-capable 'daytime' server.
|
|
* Author: John Wenker, Sr. Software Engineer,
|
|
* Performance Technologies, San Diego, USA
|
|
******************************************************************************/
|
|
/*
|
|
** System header files.
|
|
*/
|
|
#include <errno.h> /* errno declaration & error codes. */
|
|
#include <netdb.h> /* getaddrinfo(3) et al. */
|
|
#include <netinet/in.h> /* sockaddr_in & sockaddr_in6 definition. */
|
|
#include <stdio.h> /* printf(3) et al. */
|
|
#include <stdlib.h> /* exit(2). */
|
|
#include <string.h> /* String manipulation & memory functions. */
|
|
#include <sys/poll.h> /* poll(2) and related definitions. */
|
|
#include <sys/socket.h> /* Socket functions (socket(2), bind(2), etc). */
|
|
#include <time.h> /* time(2) & ctime(3). */
|
|
#include <unistd.h> /* getopt(3), read(2), etc. */
|
|
/*
|
|
** Constants.
|
|
*/
|
|
#define DFLT_SERVICE "daytime" /* Default service name. */
|
|
#define INVALID_DESC -1 /* Invalid file descriptor. */
|
|
#define MAXCONNQLEN 3 /* Max nbr of connection requests to queue. */
|
|
#define MAXTCPSCKTS 2 /* One TCP socket for IPv4 & one for IPv6. */
|
|
#define MAXUDPSCKTS 2 /* One UDP socket for IPv4 & one for IPv6. */
|
|
#define VALIDOPTS "v" /* Valid command options. */
|
|
/*
|
|
** Simple boolean type definition.
|
|
*/
|
|
typedef enum { false = 0, true } boolean;
|
|
/*
|
|
** Prototypes for internal helper functions.
|
|
*/
|
|
static int openSckt( const char *service,
|
|
const char *protocol,
|
|
int desc[ ],
|
|
size_t *descSize );
|
|
static void tod( int tSckt[ ],
|
|
size_t tScktSize,
|
|
int uSckt[ ],
|
|
size_t uScktSize );
|
|
/*
|
|
** Global (within this file only) data objects.
|
|
*/
|
|
static char hostBfr[ NI_MAXHOST ]; /* For use w/getnameinfo(3). */
|
|
static const char *pgmName; /* Program name w/o dir prefix. */
|
|
static char servBfr[ NI_MAXSERV ]; /* For use w/getnameinfo(3). */
|
|
static boolean verbose = false; /* Verbose mode indication. */
|
|
/*
|
|
** Usage macro for command syntax violations.
|
|
*/
|
|
#define USAGE \
|
|
{ \
|
|
fprintf( stderr, \
|
|
"Usage: %s [-v] [service]\n", \
|
|
pgmName ); \
|
|
exit( 127 ); \
|
|
} /* End USAGE macro. */
|
|
/*
|
|
** Macro to terminate the program if a system call error occurs. The system
|
|
** call must be one of the usual type that returns -1 on error. This macro is
|
|
** a modified version of a macro authored by Dr. V. Vinge, SDSU Dept. of
|
|
** Computer Science (retired)... best professor I ever had. I hear he writes
|
|
** great science fiction in addition to robust code, too.
|
|
*/
|
|
#define CHK(expr) \
|
|
do \
|
|
{ \
|
|
if ( (expr) == -1 ) \
|
|
{ \
|
|
fprintf( stderr, \
|
|
"%s (line %d): System call ERROR - %s.\n", \
|
|
pgmName, \
|
|
__LINE__, \
|
|
strerror( errno ) ); \
|
|
exit( 1 ); \
|
|
} /* End IF system call failed. */ \
|
|
} while ( false )
|
|
/******************************************************************************
|
|
* Function: main
|
|
*
|
|
* Description:
|
|
* Set up a time-of-day server and handle network requests. This server
|
|
* handles both TCP and UDP requests.
|
|
*
|
|
* Parameters:
|
|
* The usual argc and argv parameters to a main() function.
|
|
*
|
|
* Return Value:
|
|
* This is a daemon program and never returns. However, in the degenerate
|
|
* case where no sockets are created, the function returns zero.
|
|
******************************************************************************/
|
|
int main( int argc,
|
|
char *argv[ ] )
|
|
{
|
|
int opt;
|
|
const char *service = DFLT_SERVICE;
|
|
int tSckt[ MAXTCPSCKTS ]; /* Array of TCP socket descriptors. */
|
|
size_t tScktSize = MAXTCPSCKTS; /* Size of uSckt (# of elements). */
|
|
int uSckt[ MAXUDPSCKTS ]; /* Array of UDP socket descriptors. */
|
|
size_t uScktSize = MAXUDPSCKTS; /* Size of uSckt (# of elements). */
|
|
/*
|
|
** Set the program name (w/o directory prefix).
|
|
*/
|
|
pgmName = strrchr( argv[ 0 ], '/' );
|
|
pgmName = pgmName == NULL ? argv[ 0 ] : pgmName + 1;
|
|
/*
|
|
** Process command options.
|
|
*/
|
|
opterr = 0; /* Turns off "invalid option" error messages. */
|
|
while ( ( opt = getopt( argc, argv, VALIDOPTS ) ) >= 0 )
|
|
{
|
|
switch ( opt )
|
|
{
|
|
case 'v': /* Verbose mode. */
|
|
{
|
|
verbose = true;
|
|
break;
|
|
}
|
|
default:
|
|
{
|
|
USAGE;
|
|
}
|
|
} /* End SWITCH on command option. */
|
|
} /* End WHILE processing options. */
|
|
/*
|
|
** Process command line arguments.
|
|
*/
|
|
switch ( argc - optind )
|
|
{
|
|
case 0: break;
|
|
case 1: service = argv[ optind ]; break;
|
|
default: USAGE;
|
|
} /* End SWITCH on number of command line arguments. */
|
|
/*
|
|
** Open both a TCP and UDP socket, for both IPv4 & IPv6, on which to receive
|
|
** service requests.
|
|
*/
|
|
if ( ( openSckt( service, "tcp", tSckt, &tScktSize ) < 0 ) ||
|
|
( openSckt( service, "udp", uSckt, &uScktSize ) < 0 ) )
|
|
{
|
|
exit( 1 );
|
|
}
|
|
/*
|
|
** Run the time-of-day server.
|
|
*/
|
|
if ( ( tScktSize > 0 ) || ( uScktSize > 0 ) )
|
|
{
|
|
tod( tSckt, /* tod() never returns. */
|
|
tScktSize,
|
|
uSckt,
|
|
uScktSize );
|
|
}
|
|
/*
|
|
** Since tod() never returns, execution only gets here if no sockets were
|
|
** created.
|
|
*/
|
|
if ( verbose )
|
|
{
|
|
fprintf( stderr,
|
|
"%s: No sockets opened... terminating.\n",
|
|
pgmName );
|
|
}
|
|
return 0;
|
|
} /* End main() */
|
|
/******************************************************************************
|
|
* Function: openSckt
|
|
*
|
|
* Description:
|
|
* Open passive (server) sockets for the indicated inet service & protocol.
|
|
* Notice in the last sentence that "sockets" is plural. During the interim
|
|
* transition period while everyone is switching over to IPv6, the server
|
|
* application has to open two sockets on which to listen for connections...
|
|
* one for IPv4 traffic and one for IPv6 traffic.
|
|
*
|
|
* Parameters:
|
|
* service - Pointer to a character string representing the well-known port
|
|
* on which to listen (can be a service name or a decimal number).
|
|
* protocol - Pointer to a character string representing the transport layer
|
|
* protocol (only "tcp" or "udp" are valid).
|
|
* desc - Pointer to an array into which the socket descriptors are
|
|
* placed when opened.
|
|
* descSize - This is a value-result parameter. On input, it contains the
|
|
* max number of descriptors that can be put into 'desc' (i.e. the
|
|
* number of elements in the array). Upon return, it will contain
|
|
* the number of descriptors actually opened. Any unused slots in
|
|
* 'desc' are set to INVALID_DESC.
|
|
*
|
|
* Return Value:
|
|
* 0 on success, -1 on error.
|
|
******************************************************************************/
|
|
static int openSckt( const char *service,
|
|
const char *protocol,
|
|
int desc[ ],
|
|
size_t *descSize )
|
|
{
|
|
struct addrinfo *ai;
|
|
int aiErr;
|
|
struct addrinfo *aiHead;
|
|
struct addrinfo hints = { .ai_flags = AI_PASSIVE, /* Server mode.
|
|
¬ */
|
|
.ai_family = PF_UNSPEC }; /* IPv4 or IPv6.
|
|
¬ */
|
|
size_t maxDescs = *descSize;
|
|
/*
|
|
** Initialize output parameters. When the loop completes, *descSize is 0.
|
|
*/
|
|
while ( *descSize > 0 )
|
|
{
|
|
desc[ --( *descSize ) ] = INVALID_DESC;
|
|
}
|
|
/*
|
|
** Check which protocol is selected (only TCP and UDP are valid).
|
|
*/
|
|
if ( strcmp( protocol, "tcp" ) == 0 ) /* TCP protocol. */
|
|
{
|
|
hints.ai_socktype = SOCK_STREAM;
|
|
hints.ai_protocol = IPPROTO_TCP;
|
|
}
|
|
else if ( strcmp( protocol, "udp" ) == 0 ) /* UDP protocol. */
|
|
{
|
|
hints.ai_socktype = SOCK_DGRAM;
|
|
hints.ai_protocol = IPPROTO_UDP;
|
|
}
|
|
else /* Invalid protocol. */
|
|
{
|
|
fprintf( stderr,
|
|
"%s (line %d): ERROR - Unknown transport "
|
|
"layer protocol \"%s\".\n",
|
|
pgmName,
|
|
__LINE__,
|
|
protocol );
|
|
return -1;
|
|
}
|
|
/*
|
|
** Look up the service's well-known port number. Notice that NULL is being
|
|
** passed for the 'node' parameter, and that the AI_PASSIVE flag is set in
|
|
** 'hints'. Thus, the program is requesting passive address information.
|
|
** The network address is initialized to :: (all zeros) for IPv6 records, or
|
|
** 0.0.0.0 for IPv4 records.
|
|
*/
|
|
if ( ( aiErr = getaddrinfo( NULL,
|
|
service,
|
|
&hints,
|
|
&aiHead ) ) != 0 )
|
|
{
|
|
fprintf( stderr,
|
|
"%s (line %d): ERROR - %s.\n",
|
|
pgmName,
|
|
__LINE__,
|
|
gai_strerror( aiErr ) );
|
|
return -1;
|
|
}
|
|
/*
|
|
** For each of the address records returned, attempt to set up a passive
|
|
** socket.
|
|
*/
|
|
for ( ai = aiHead;
|
|
( ai != NULL ) && ( *descSize < maxDescs );
|
|
ai = ai->ai_next )
|
|
{
|
|
if ( verbose )
|
|
{
|
|
/*
|
|
** Display the current address info. Start with the protocol-
|
|
** independent fields first.
|
|
*/
|
|
fprintf( stderr,
|
|
"Setting up a passive socket based on the "
|
|
"following address info:\n"
|
|
" ai_flags = 0x%02X\n"
|
|
" ai_family = %d (PF_INET = %d, PF_INET6 = %d)\n"
|
|
" ai_socktype = %d (SOCK_STREAM = %d, SOCK_DGRAM = %d)\n"
|
|
" ai_protocol = %d (IPPROTO_TCP = %d, IPPROTO_UDP = %d)\n"
|
|
" ai_addrlen = %d (sockaddr_in = %d, "
|
|
"sockaddr_in6 = %d)\n",
|
|
ai->ai_flags,
|
|
ai->ai_family,
|
|
PF_INET,
|
|
PF_INET6,
|
|
ai->ai_socktype,
|
|
SOCK_STREAM,
|
|
SOCK_DGRAM,
|
|
ai->ai_protocol,
|
|
IPPROTO_TCP,
|
|
IPPROTO_UDP,
|
|
ai->ai_addrlen,
|
|
sizeof( struct sockaddr_in ),
|
|
sizeof( struct sockaddr_in6 ) );
|
|
/*
|
|
** Now display the protocol-specific formatted socket address. Note
|
|
** that the program is requesting that getnameinfo(3) convert the
|
|
** host & service into numeric strings.
|
|
*/
|
|
getnameinfo( ai->ai_addr,
|
|
ai->ai_addrlen,
|
|
hostBfr,
|
|
sizeof( hostBfr ),
|
|
servBfr,
|
|
sizeof( servBfr ),
|
|
NI_NUMERICHOST | NI_NUMERICSERV );
|
|
switch ( ai->ai_family )
|
|
{
|
|
case PF_INET: /* IPv4 address record. */
|
|
{
|
|
struct sockaddr_in *p = (struct sockaddr_in*) ai->ai_addr;
|
|
fprintf( stderr,
|
|
" ai_addr = sin_family: %d (AF_INET = %d, "
|
|
"AF_INET6 = %d)\n"
|
|
" sin_addr: %s\n"
|
|
" sin_port: %s\n",
|
|
p->sin_family,
|
|
AF_INET,
|
|
AF_INET6,
|
|
hostBfr,
|
|
servBfr );
|
|
break;
|
|
} /* End CASE of IPv4. */
|
|
case PF_INET6: /* IPv6 address record. */
|
|
{
|
|
struct sockaddr_in6 *p = (struct sockaddr_in6*) ai->ai_addr;
|
|
fprintf( stderr,
|
|
" ai_addr = sin6_family: %d (AF_INET = %d, "
|
|
"AF_INET6 = %d)\n"
|
|
" sin6_addr: %s\n"
|
|
" sin6_port: %s\n"
|
|
" sin6_flowinfo: %d\n"
|
|
" sin6_scope_id: %d\n",
|
|
p->sin6_family,
|
|
AF_INET,
|
|
AF_INET6,
|
|
hostBfr,
|
|
servBfr,
|
|
p->sin6_flowinfo,
|
|
p->sin6_scope_id );
|
|
break;
|
|
} /* End CASE of IPv6. */
|
|
default: /* Can never get here, but just for completeness. */
|
|
{
|
|
fprintf( stderr,
|
|
"%s (line %d): ERROR - Unknown protocol family (%d).\n",
|
|
pgmName,
|
|
__LINE__,
|
|
ai->ai_family );
|
|
freeaddrinfo( aiHead );
|
|
return -1;
|
|
} /* End DEFAULT case (unknown protocol family). */
|
|
} /* End SWITCH on protocol family. */
|
|
} /* End IF verbose mode. */
|
|
/*
|
|
** Create a socket using the info in the addrinfo structure.
|
|
*/
|
|
CHK( desc[ *descSize ] = socket( ai->ai_family,
|
|
ai->ai_socktype,
|
|
ai->ai_protocol ) );
|
|
/*
|
|
** Here is the code that prevents "IPv4 mapped addresses", as discussed
|
|
** in Section 22.1.3.1. If an IPv6 socket was just created, then set the
|
|
** IPV6_V6ONLY socket option.
|
|
*/
|
|
if ( ai->ai_family == PF_INET6 )
|
|
{
|
|
#if defined( IPV6_V6ONLY )
|
|
/*
|
|
** Disable IPv4 mapped addresses.
|
|
*/
|
|
int v6Only = 1;
|
|
CHK( setsockopt( desc[ *descSize ],
|
|
IPPROTO_IPV6,
|
|
IPV6_V6ONLY,
|
|
&v6Only,
|
|
sizeof( v6Only ) ) );
|
|
#else
|
|
/*
|
|
** IPV6_V6ONLY is not defined, so the socket option can't be set and
|
|
** thus IPv4 mapped addresses can't be disabled. Print a warning
|
|
** message and close the socket. Design note: If the
|
|
** #if...#else...#endif construct were removed, then this program
|
|
** would not compile (because IPV6_V6ONLY isn't defined). That's an
|
|
** acceptable approach; IPv4 mapped addresses are certainly disabled
|
|
** if the program can't build! However, since this program is also
|
|
** designed to work for IPv4 sockets as well as IPv6, I decided to
|
|
** allow the program to compile when IPV6_V6ONLY is not defined, and
|
|
** turn it into a run-time warning rather than a compile-time error.
|
|
** IPv4 mapped addresses are still disabled because _all_ IPv6 traffic
|
|
** is disabled (all IPv6 sockets are closed here), but at least this
|
|
** way the server can still service IPv4 network traffic.
|
|
*/
|
|
fprintf( stderr,
|
|
"%s (line %d): WARNING - Cannot set IPV6_V6ONLY socket "
|
|
"option. Closing IPv6 %s socket.\n",
|
|
pgmName,
|
|
__LINE__,
|
|
ai->ai_protocol == IPPROTO_TCP ? "TCP" : "UDP" );
|
|
CHK( close( desc[ *descSize ] ) );
|
|
continue; /* Go to top of FOR loop w/o updating *descSize! */
|
|
#endif /* IPV6_V6ONLY */
|
|
} /* End IF this is an IPv6 socket. */
|
|
/*
|
|
** Bind the socket. Again, the info from the addrinfo structure is used.
|
|
*/
|
|
CHK( bind( desc[ *descSize ],
|
|
ai->ai_addr,
|
|
ai->ai_addrlen ) );
|
|
/*
|
|
** If this is a TCP socket, put the socket into passive listening mode
|
|
** (listen is only valid on connection-oriented sockets).
|
|
*/
|
|
if ( ai->ai_socktype == SOCK_STREAM )
|
|
{
|
|
CHK( listen( desc[ *descSize ],
|
|
MAXCONNQLEN ) );
|
|
}
|
|
/*
|
|
** Socket set up okay. Bump index to next descriptor array element.
|
|
*/
|
|
*descSize += 1;
|
|
} /* End FOR each address info structure returned. */
|
|
/*
|
|
** Dummy check for unused address records.
|
|
*/
|
|
if ( verbose && ( ai != NULL ) )
|
|
{
|
|
fprintf( stderr,
|
|
"%s (line %d): WARNING - Some address records were "
|
|
"not processed due to insufficient array space.\n",
|
|
pgmName,
|
|
__LINE__ );
|
|
} /* End IF verbose and some address records remain unprocessed. */
|
|
/*
|
|
** Clean up.
|
|
*/
|
|
freeaddrinfo( aiHead );
|
|
return 0;
|
|
} /* End openSckt() */
|
|
/******************************************************************************
|
|
* Function: tod
|
|
*
|
|
* Description:
|
|
* Listen on a set of sockets and send the current time-of-day to any
|
|
* clients. This function never returns.
|
|
*
|
|
* Parameters:
|
|
* tSckt - Array of TCP socket descriptors on which to listen.
|
|
* tScktSize - Size of the tSckt array (nbr of elements).
|
|
* uSckt - Array of UDP socket descriptors on which to listen.
|
|
* uScktSize - Size of the uSckt array (nbr of elements).
|
|
*
|
|
* Return Value: None.
|
|
******************************************************************************/
|
|
static void tod( int tSckt[ ],
|
|
size_t tScktSize,
|
|
int uSckt[ ],
|
|
size_t uScktSize )
|
|
{
|
|
char bfr[ 256 ];
|
|
ssize_t count;
|
|
struct pollfd *desc;
|
|
size_t descSize = tScktSize + uScktSize;
|
|
int idx;
|
|
int newSckt;
|
|
struct sockaddr *sadr;
|
|
socklen_t sadrLen;
|
|
struct sockaddr_storage sockStor;
|
|
int status;
|
|
size_t timeLen;
|
|
char *timeStr;
|
|
time_t timeVal;
|
|
ssize_t wBytes;
|
|
/*
|
|
** Allocate memory for the poll(2) array.
|
|
*/
|
|
desc = malloc( descSize * sizeof( struct pollfd ) );
|
|
if ( desc == NULL )
|
|
{
|
|
fprintf( stderr,
|
|
"%s (line %d): ERROR - %s.\n",
|
|
pgmName,
|
|
__LINE__,
|
|
strerror( ENOMEM ) );
|
|
exit( 1 );
|
|
}
|
|
/*
|
|
** Initialize the poll(2) array.
|
|
*/
|
|
for ( idx = 0; idx < descSize; idx++ )
|
|
{
|
|
desc[ idx ].fd = idx < tScktSize ? tSckt[ idx ]
|
|
: uSckt[ idx - tScktSize ];
|
|
desc[ idx ].events = POLLIN;
|
|
desc[ idx ].revents = 0;
|
|
}
|
|
/*
|
|
** Main time-of-day server loop. Handles both TCP & UDP requests. This is
|
|
** an interative server, and all requests are handled directly within the
|
|
** main loop.
|
|
*/
|
|
while ( true ) /* Do forever. */
|
|
{
|
|
/*
|
|
** Wait for activity on one of the sockets. The DO..WHILE construct is
|
|
** used to restart the system call in the event the process is
|
|
** interrupted by a signal.
|
|
*/
|
|
do
|
|
{
|
|
status = poll( desc,
|
|
descSize,
|
|
-1 /* Wait indefinitely for input. */ );
|
|
} while ( ( status < 0 ) && ( errno == EINTR ) );
|
|
CHK( status ); /* Check for a bona fide system call error. */
|
|
/*
|
|
** Get the current time.
|
|
*/
|
|
timeVal = time( NULL );
|
|
timeStr = ctime( &timeVal );
|
|
timeLen = strlen( timeStr );
|
|
/*
|
|
** Indicate that there is new network activity.
|
|
*/
|
|
if ( verbose )
|
|
{
|
|
char *s = malloc( timeLen+1 );
|
|
strcpy( s, timeStr );
|
|
s[ timeLen-1 ] = '\0'; /* Overwrite '\n' in date string. */
|
|
fprintf( stderr,
|
|
"%s: New network activity on %s.\n",
|
|
pgmName,
|
|
s );
|
|
free( s );
|
|
} /* End IF verbose. */
|
|
/*
|
|
** Process sockets with input available.
|
|
*/
|
|
for ( idx = 0; idx < descSize; idx++ )
|
|
{
|
|
switch ( desc[ idx ].revents )
|
|
{
|
|
case 0: /* No activity on this socket; try the next. */
|
|
continue;
|
|
case POLLIN: /* Network activity. Go process it. */
|
|
break;
|
|
default: /* Invalid poll events. */
|
|
{
|
|
fprintf( stderr,
|
|
"%s (line %d): ERROR - Invalid poll event (0x%02X).\n",
|
|
pgmName,
|
|
__LINE__,
|
|
desc[ idx ].revents );
|
|
exit( 1 );
|
|
}
|
|
} /* End SWITCH on returned poll events. */
|
|
/*
|
|
** Determine if this is a TCP request or UDP request.
|
|
*/
|
|
if ( idx < tScktSize )
|
|
{
|
|
/*
|
|
** TCP connection requested. Accept it. Notice the use of
|
|
** the sockaddr_storage data type.
|
|
*/
|
|
sadrLen = sizeof( sockStor );
|
|
sadr = (struct sockaddr*) &sockStor;
|
|
CHK( newSckt = accept( desc[ idx ].fd,
|
|
sadr,
|
|
&sadrLen ) );
|
|
CHK( shutdown( newSckt, /* Server never recv's anything. */
|
|
SHUT_RD ) );
|
|
if ( verbose )
|
|
{
|
|
/*
|
|
** Display the socket address of the remote client. Begin with
|
|
** the address-independent fields.
|
|
*/
|
|
fprintf( stderr,
|
|
"Sockaddr info for new TCP client:\n"
|
|
" sa_family = %d (AF_INET = %d, AF_INET6 = %d)\n"
|
|
" addr len = %d (sockaddr_in = %d, "
|
|
"sockaddr_in6 = %d)\n",
|
|
sadr->sa_family,
|
|
AF_INET,
|
|
AF_INET6,
|
|
sadrLen,
|
|
sizeof( struct sockaddr_in ),
|
|
sizeof( struct sockaddr_in6 ) );
|
|
/*
|
|
** Display the address-specific fields.
|
|
*/
|
|
getnameinfo( sadr,
|
|
sadrLen,
|
|
hostBfr,
|
|
sizeof( hostBfr ),
|
|
servBfr,
|
|
sizeof( servBfr ),
|
|
NI_NUMERICHOST | NI_NUMERICSERV );
|
|
/*
|
|
** Notice that we're switching on an address family now, not a
|
|
** protocol family.
|
|
*/
|
|
switch ( sadr->sa_family )
|
|
{
|
|
case AF_INET: /* IPv4 address. */
|
|
{
|
|
struct sockaddr_in *p = (struct sockaddr_in*) sadr;
|
|
fprintf( stderr,
|
|
" sin_addr = sin_family: %d\n"
|
|
" sin_addr: %s\n"
|
|
" sin_port: %s\n",
|
|
p->sin_family,
|
|
hostBfr,
|
|
servBfr );
|
|
break;
|
|
} /* End CASE of IPv4. */
|
|
case AF_INET6: /* IPv6 address. */
|
|
{
|
|
struct sockaddr_in6 *p = (struct sockaddr_in6*) sadr;
|
|
fprintf( stderr,
|
|
" sin6_addr = sin6_family: %d\n"
|
|
" sin6_addr: %s\n"
|
|
" sin6_port: %s\n"
|
|
" sin6_flowinfo: %d\n"
|
|
" sin6_scope_id: %d\n",
|
|
p->sin6_family,
|
|
hostBfr,
|
|
servBfr,
|
|
p->sin6_flowinfo,
|
|
p->sin6_scope_id );
|
|
break;
|
|
} /* End CASE of IPv6. */
|
|
default: /* Can never get here, but for completeness. */
|
|
{
|
|
fprintf( stderr,
|
|
"%s (line %d): ERROR - Unknown address "
|
|
"family (%d).\n",
|
|
pgmName,
|
|
__LINE__,
|
|
sadr->sa_family );
|
|
break;
|
|
} /* End DEFAULT case (unknown address family). */
|
|
} /* End SWITCH on address family. */
|
|
} /* End IF verbose mode. */
|
|
/*
|
|
** Send the TOD to the client.
|
|
*/
|
|
wBytes = timeLen;
|
|
while ( wBytes > 0 )
|
|
{
|
|
do
|
|
{
|
|
count = write( newSckt,
|
|
timeStr,
|
|
wBytes );
|
|
} while ( ( count < 0 ) && ( errno == EINTR ) );
|
|
CHK( count ); /* Check for a bona fide error. */
|
|
wBytes -= count;
|
|
} /* End WHILE there is data to send. */
|
|
CHK( close( newSckt ) );
|
|
} /* End IF this was a TCP connection request. */
|
|
else
|
|
{
|
|
/*
|
|
** This is a UDP socket, and a datagram is available. The funny
|
|
** thing about UDP requests is that this server doesn't require any
|
|
** client input; but it can't send the TOD unless it knows a client
|
|
** wants the data, and the only way that can occur with UDP is if
|
|
** the server receives a datagram from the client. Thus, the
|
|
** server must receive _something_, but the content of the datagram
|
|
** is irrelevant. Read in the datagram. Again note the use of
|
|
** sockaddr_storage to receive the address.
|
|
*/
|
|
sadrLen = sizeof( sockStor );
|
|
sadr = (struct sockaddr*) &sockStor;
|
|
CHK( count = recvfrom( desc[ idx ].fd,
|
|
bfr,
|
|
sizeof( bfr ),
|
|
0,
|
|
sadr,
|
|
&sadrLen ) );
|
|
/*
|
|
** Display whatever was received on stdout.
|
|
*/
|
|
if ( verbose )
|
|
{
|
|
ssize_t rBytes = count;
|
|
fprintf( stderr,
|
|
"%s: UDP datagram received (%d bytes).\n",
|
|
pgmName,
|
|
count );
|
|
while ( count > 0 )
|
|
{
|
|
fputc( bfr[ rBytes - count-- ],
|
|
stdout );
|
|
}
|
|
if ( bfr[ rBytes-1 ] != '\n' )
|
|
fputc( '\n', stdout ); /* Newline also flushes stdout. */
|
|
/*
|
|
** Display the socket address of the remote client. Address-
|
|
** independent fields first.
|
|
*/
|
|
fprintf( stderr,
|
|
"Remote client's sockaddr info:\n"
|
|
" sa_family = %d (AF_INET = %d, AF_INET6 = %d)\n"
|
|
" addr len = %d (sockaddr_in = %d, "
|
|
"sockaddr_in6 = %d)\n",
|
|
sadr->sa_family,
|
|
AF_INET,
|
|
AF_INET6,
|
|
sadrLen,
|
|
sizeof( struct sockaddr_in ),
|
|
sizeof( struct sockaddr_in6 ) );
|
|
/*
|
|
** Display the address-specific information.
|
|
*/
|
|
getnameinfo( sadr,
|
|
sadrLen,
|
|
hostBfr,
|
|
sizeof( hostBfr ),
|
|
servBfr,
|
|
sizeof( servBfr ),
|
|
NI_NUMERICHOST | NI_NUMERICSERV );
|
|
switch ( sadr->sa_family )
|
|
{
|
|
case AF_INET: /* IPv4 address. */
|
|
{
|
|
struct sockaddr_in *p = (struct sockaddr_in*) sadr;
|
|
fprintf( stderr,
|
|
" sin_addr = sin_family: %d\n"
|
|
" sin_addr: %s\n"
|
|
" sin_port: %s\n",
|
|
p->sin_family,
|
|
hostBfr,
|
|
servBfr );
|
|
break;
|
|
} /* End CASE of IPv4 address. */
|
|
case AF_INET6: /* IPv6 address. */
|
|
{
|
|
struct sockaddr_in6 *p = (struct sockaddr_in6*) sadr;
|
|
fprintf( stderr,
|
|
" sin6_addr = sin6_family: %d\n"
|
|
" sin6_addr: %s\n"
|
|
" sin6_port: %s\n"
|
|
" sin6_flowinfo: %d\n"
|
|
" sin6_scope_id: %d\n",
|
|
p->sin6_family,
|
|
hostBfr,
|
|
servBfr,
|
|
p->sin6_flowinfo,
|
|
p->sin6_scope_id );
|
|
break;
|
|
} /* End CASE of IPv6 address. */
|
|
default: /* Can never get here, but for completeness. */
|
|
{
|
|
fprintf( stderr,
|
|
"%s (line %d): ERROR - Unknown address "
|
|
"family (%d).\n",
|
|
pgmName,
|
|
__LINE__,
|
|
sadr->sa_family );
|
|
break;
|
|
} /* End DEFAULT case (unknown address family). */
|
|
} /* End SWITCH on address family. */
|
|
} /* End IF verbose mode. */
|
|
/*
|
|
** Send the time-of-day to the client.
|
|
*/
|
|
wBytes = timeLen;
|
|
while ( wBytes > 0 )
|
|
{
|
|
do
|
|
{
|
|
count = sendto( desc[ idx ].fd,
|
|
timeStr,
|
|
wBytes,
|
|
0,
|
|
sadr, /* Address & address length */
|
|
sadrLen ); /* received in recvfrom(). */
|
|
} while ( ( count < 0 ) && ( errno == EINTR ) );
|
|
CHK( count ); /* Check for a bona fide error. */
|
|
wBytes -= count;
|
|
} /* End WHILE there is data to send. */
|
|
} /* End ELSE a UDP datagram is available. */
|
|
desc[ idx ].revents = 0; /* Clear the returned poll events. */
|
|
} /* End FOR each socket descriptor. */
|
|
} /* End WHILE forever. */
|
|
} /* End tod() */
|
|
]]></screen></sect3><sect3>
|
|
<title>'Daytime' TCP Client Code</title>
|
|
<para>The TCP client code is found in file tod6tc.c (time-of-day IPv6 TCP client). Once built, the TCP client may be started using the following command syntax (assuming tod6tc is the executable file):</para><screen>
|
|
<![CDATA[tod6tc [-v] [-s scope_id] [host [service]]
|
|
]]></screen><para>ARGUMENTS:</para><variablelist>
|
|
<varlistentry><term>host</term><listitem><para>The hostname or IP address (dotted decimal or colon-hex) of the remote host providing the service. Default is "localhost".</para></listitem></varlistentry><varlistentry><term>service</term><listitem><para>The TCP service (or well-known port number) to which a connection attempt is made. Default is "daytime".</para></listitem></varlistentry></variablelist><para>OPTIONS:</para><variablelist>
|
|
<varlistentry><term>-s</term><listitem><para>This option is only meaningful for IPv6 addresses, and is used to set the scope identifier (i.e. the network interface on which to establish the connection). Default is "eth0". If host is a scoped address, this option is ignored.</para></listitem></varlistentry><varlistentry><term>-v</term><listitem><para>Turn on verbose mode.</para></listitem></varlistentry></variablelist><para>The TCP client source code contained in tod6tc.c follows:</para><screen>
|
|
<![CDATA[/******************************************************************************
|
|
* File: tod6tc.c
|
|
* Description: Contains source code for an IPv6-capable 'daytime' TCP client.
|
|
* Author: John Wenker, Sr. Software Engineer
|
|
* Performance Technologies, San Diego, USA
|
|
******************************************************************************/
|
|
/*
|
|
** System header files.
|
|
*/
|
|
#include <errno.h> /* errno declaration and error codes. */
|
|
#include <net/if.h> /* if_nametoindex(3). */
|
|
#include <netdb.h> /* getaddrinfo(3) and associated definitions. */
|
|
#include <netinet/in.h> /* sockaddr_in and sockaddr_in6 definitions. */
|
|
#include <stdio.h> /* printf(3) et al. */
|
|
#include <stdlib.h> /* exit(2). */
|
|
#include <string.h> /* String manipulation and memory functions. */
|
|
#include <sys/socket.h> /* Socket functions (socket(2), connect(2), etc). */
|
|
#include <unistd.h> /* getopt(3), read(2), etc. */
|
|
/*
|
|
** Constants & macros.
|
|
*/
|
|
#define DFLT_HOST "localhost" /* Default server name. */
|
|
#define DFLT_SCOPE_ID "eth0" /* Default scope identifier. */
|
|
#define DFLT_SERVICE "daytime" /* Default service name. */
|
|
#define INVALID_DESC -1 /* Invalid file (socket) descriptor. */
|
|
#define MAXBFRSIZE 256 /* Max bfr sz to read remote TOD. */
|
|
#define VALIDOPTS "s:v" /* Valid command options. */
|
|
/*
|
|
** Type definitions (for convenience).
|
|
*/
|
|
typedef enum { false = 0, true } boolean;
|
|
typedef struct sockaddr_in sockaddr_in_t;
|
|
typedef struct sockaddr_in6 sockaddr_in6_t;
|
|
/*
|
|
** Prototypes for internal helper functions.
|
|
*/
|
|
static int openSckt( const char *host,
|
|
const char *service,
|
|
unsigned int scopeId );
|
|
static void tod( int sckt );
|
|
/*
|
|
** Global (within this file only) data objects.
|
|
*/
|
|
static const char *pgmName; /* Program name (w/o directory). */
|
|
static boolean verbose = false; /* Verbose mode. */
|
|
/*
|
|
** Usage macro.
|
|
*/
|
|
#define USAGE \
|
|
{ \
|
|
fprintf( stderr, \
|
|
"Usage: %s [-v] [-s scope_id] [host [service]]\n", \
|
|
pgmName ); \
|
|
exit( 127 ); \
|
|
} /* End USAGE macro. */
|
|
/*
|
|
** This "macro" (even though it's really a function) is loosely based on the
|
|
** CHK() macro by Dr. V. Vinge (see server code). The status parameter is
|
|
** a boolean expression indicating the return code from one of the usual system
|
|
** calls that returns -1 on error. If a system call error occurred, an alert
|
|
** is written to stderr. It returns a boolean value indicating success/failure
|
|
** of the system call.
|
|
**
|
|
** Example: if ( !SYSCALL( "write",
|
|
** count = write( fd, bfr, size ) ) )
|
|
** {
|
|
** // Error processing... but SYSCALL() will have already taken
|
|
** // care of dumping an error alert to stderr.
|
|
** }
|
|
*/
|
|
static __inline boolean SYSCALL( const char *syscallName,
|
|
int lineNbr,
|
|
int status )
|
|
{
|
|
if ( ( status == -1 ) && verbose )
|
|
{
|
|
fprintf( stderr,
|
|
"%s (line %d): System call failed ('%s') - %s.\n",
|
|
pgmName,
|
|
lineNbr,
|
|
syscallName,
|
|
strerror( errno ) );
|
|
}
|
|
return status != -1; /* True if the system call was successful. */
|
|
} /* End SYSCALL() */
|
|
/******************************************************************************
|
|
* Function: main
|
|
*
|
|
* Description:
|
|
* Connect to a remote time-of-day service and write the remote host's TOD to
|
|
* stdout.
|
|
*
|
|
* Parameters:
|
|
* The usual argc & argv parameters to a main() program.
|
|
*
|
|
* Return Value:
|
|
* This function always returns zero.
|
|
******************************************************************************/
|
|
int main( int argc,
|
|
char *argv[ ] )
|
|
{
|
|
const char *host = DFLT_HOST;
|
|
int opt;
|
|
int sckt;
|
|
unsigned int scopeId = if_nametoindex( DFLT_SCOPE_ID );
|
|
const char *service = DFLT_SERVICE;
|
|
/*
|
|
** Determine the program name (w/o directory prefix).
|
|
*/
|
|
pgmName = (const char*) strrchr( argv[ 0 ], '/' );
|
|
pgmName = pgmName == NULL ? argv[ 0 ] : pgmName+1;
|
|
/*
|
|
** Process command line options.
|
|
*/
|
|
opterr = 0; /* Turns off "invalid option" error messages. */
|
|
while ( ( opt = getopt( argc, argv, VALIDOPTS ) ) != -1 )
|
|
{
|
|
switch ( opt )
|
|
{
|
|
case 's': /* Scope identifier (IPv6 kluge). */
|
|
{
|
|
scopeId = if_nametoindex( optarg );
|
|
if ( scopeId == 0 )
|
|
{
|
|
fprintf( stderr,
|
|
"%s: Unknown network interface (%s).\n",
|
|
pgmName,
|
|
optarg );
|
|
USAGE;
|
|
}
|
|
break;
|
|
}
|
|
case 'v': /* Verbose mode. */
|
|
{
|
|
verbose = true;
|
|
break;
|
|
}
|
|
default:
|
|
{
|
|
USAGE;
|
|
}
|
|
} /* End SWITCH on command option. */
|
|
} /* End WHILE processing command options. */
|
|
/*
|
|
** Process command arguments. At the end of the above loop, optind is the
|
|
** index of the first NON-option argv element.
|
|
*/
|
|
switch ( argc - optind )
|
|
{
|
|
case 2: /* Both host & service are specified on the command line. */
|
|
{
|
|
service = argv[ optind + 1 ];
|
|
/***** Fall through *****/
|
|
}
|
|
case 1: /* Host is specified on the command line. */
|
|
{
|
|
host = argv[ optind ];
|
|
/***** Fall through *****/
|
|
}
|
|
case 0: /* Use default host & service. */
|
|
{
|
|
break;
|
|
}
|
|
default:
|
|
{
|
|
USAGE;
|
|
}
|
|
} /* End SWITCH on number of command arguments. */
|
|
/*
|
|
** Open a connection to the indicated host/service.
|
|
**
|
|
** Note that if all three of the following conditions are met, then the
|
|
** scope identifier remains unresolved at this point.
|
|
** 1) The default network interface is unknown for some reason.
|
|
** 2) The -s option was not used on the command line.
|
|
** 3) An IPv6 "scoped address" was not specified for the hostname on the
|
|
** command line.
|
|
** If the above three conditions are met, then only an IPv4 socket can be
|
|
** opened (connect(2) fails without the scope ID properly set for IPv6
|
|
** sockets).
|
|
*/
|
|
if ( ( sckt = openSckt( host,
|
|
service,
|
|
scopeId ) ) == INVALID_DESC )
|
|
{
|
|
fprintf( stderr,
|
|
"%s: Sorry... a connection could not be established.\n",
|
|
pgmName );
|
|
exit( 1 );
|
|
}
|
|
/*
|
|
** Get the remote time-of-day.
|
|
*/
|
|
tod( sckt );
|
|
/*
|
|
** Close the connection and terminate.
|
|
*/
|
|
(void) SYSCALL( "close",
|
|
__LINE__,
|
|
close( sckt ) );
|
|
return 0;
|
|
} /* End main() */
|
|
/******************************************************************************
|
|
* Function: openSckt
|
|
*
|
|
* Description:
|
|
* Sets up a TCP connection to a remote server. Getaddrinfo(3) is used to
|
|
* perform lookup functions and can return multiple address records (i.e. a
|
|
* list of 'struct addrinfo' records). This function traverses the list and
|
|
* tries to establish a connection to the remote server. The function ends
|
|
* when either a connection has been established or all records in the list
|
|
* have been processed.
|
|
*
|
|
* Parameters:
|
|
* host - A pointer to a character string representing the hostname or IP
|
|
* address (IPv4 or IPv6) of the remote server.
|
|
* service - A pointer to a character string representing the service name or
|
|
* well-known port number.
|
|
* scopeId - For IPv6 sockets only. This is the index corresponding to the
|
|
* network interface on which to set up the connection. This
|
|
* parameter is ignored for IPv4 sockets or when an IPv6 "scoped
|
|
* address" is specified in 'host' (i.e. where the colon-hex
|
|
* network address is augmented with the scope ID).
|
|
*
|
|
* Return Value:
|
|
* Returns the socket descriptor for the connection, or INVALID_DESC if all
|
|
* address records have been processed and a connection could not be
|
|
* established.
|
|
******************************************************************************/
|
|
static int openSckt( const char *host,
|
|
const char *service,
|
|
unsigned int scopeId )
|
|
{
|
|
struct addrinfo *ai;
|
|
int aiErr;
|
|
struct addrinfo *aiHead;
|
|
struct addrinfo hints;
|
|
sockaddr_in6_t *pSadrIn6;
|
|
int sckt;
|
|
/*
|
|
** Initialize the 'hints' structure for getaddrinfo(3).
|
|
**
|
|
** Notice that the 'ai_family' field is set to PF_UNSPEC, indicating to
|
|
** return both IPv4 and IPv6 address records for the host/service. Most of
|
|
** the time, the user isn't going to care whether an IPv4 connection or an
|
|
** IPv6 connection is established; the user simply wants to exchange data
|
|
** with the remote host and doesn't care how it's done. Sometimes, however,
|
|
** the user might want to explicitly specify the type of underlying socket.
|
|
** It is left as an exercise for the motivated reader to add a command line
|
|
** option allowing the user to specify the IP protocol, and then process the
|
|
** list of addresses accordingly (it's not that difficult).
|
|
*/
|
|
memset( &hints, 0, sizeof( hints ) );
|
|
hints.ai_family = PF_UNSPEC; /* IPv4 or IPv6 records (don't care). */
|
|
hints.ai_socktype = SOCK_STREAM; /* Connection-oriented byte stream. */
|
|
hints.ai_protocol = IPPROTO_TCP; /* TCP transport layer protocol only. */
|
|
/*
|
|
** Look up the host/service information.
|
|
*/
|
|
if ( ( aiErr = getaddrinfo( host,
|
|
service,
|
|
&hints,
|
|
&aiHead ) ) != 0 )
|
|
{
|
|
fprintf( stderr,
|
|
"%s (line %d): ERROR - %s.\n",
|
|
pgmName,
|
|
__LINE__,
|
|
gai_strerror( aiErr ) );
|
|
return INVALID_DESC;
|
|
}
|
|
/*
|
|
** Go through the list and try to open a connection. Continue until either
|
|
** a connection is established or the entire list is exhausted.
|
|
*/
|
|
for ( ai = aiHead, sckt = INVALID_DESC;
|
|
( ai != NULL ) && ( sckt == INVALID_DESC );
|
|
ai = ai->ai_next )
|
|
{
|
|
/*
|
|
** IPv6 kluge. Make sure the scope ID is set.
|
|
*/
|
|
if ( ai->ai_family == PF_INET6 )
|
|
{
|
|
pSadrIn6 = (sockaddr_in6_t*) ai->ai_addr;
|
|
if ( pSadrIn6->sin6_scope_id == 0 )
|
|
{
|
|
pSadrIn6->sin6_scope_id = scopeId;
|
|
} /* End IF the scope ID wasn't set. */
|
|
} /* End IPv6 kluge. */
|
|
/*
|
|
** Display the address info for the remote host.
|
|
*/
|
|
if ( verbose )
|
|
{
|
|
/*
|
|
** Temporary character string buffers for host & service.
|
|
*/
|
|
char hostBfr[ NI_MAXHOST ];
|
|
char servBfr[ NI_MAXSERV ];
|
|
/*
|
|
** Display the address information just fetched. Start with the
|
|
** common (protocol-independent) stuff first.
|
|
*/
|
|
fprintf( stderr,
|
|
"Address info:\n"
|
|
" ai_flags = 0x%02X\n"
|
|
" ai_family = %d (PF_INET = %d, PF_INET6 = %d)\n"
|
|
" ai_socktype = %d (SOCK_STREAM = %d, SOCK_DGRAM = %d)\n"
|
|
" ai_protocol = %d (IPPROTO_TCP = %d, IPPROTO_UDP = %d)\n"
|
|
" ai_addrlen = %d (sockaddr_in = %d, "
|
|
"sockaddr_in6 = %d)\n",
|
|
ai->ai_flags,
|
|
ai->ai_family,
|
|
PF_INET,
|
|
PF_INET6,
|
|
ai->ai_socktype,
|
|
SOCK_STREAM,
|
|
SOCK_DGRAM,
|
|
ai->ai_protocol,
|
|
IPPROTO_TCP,
|
|
IPPROTO_UDP,
|
|
ai->ai_addrlen,
|
|
sizeof( struct sockaddr_in ),
|
|
sizeof( struct sockaddr_in6 ) );
|
|
/*
|
|
** Display the protocol-specific formatted address.
|
|
*/
|
|
getnameinfo( ai->ai_addr,
|
|
ai->ai_addrlen,
|
|
hostBfr,
|
|
sizeof( hostBfr ),
|
|
servBfr,
|
|
sizeof( servBfr ),
|
|
NI_NUMERICHOST | NI_NUMERICSERV );
|
|
switch ( ai->ai_family )
|
|
{
|
|
case PF_INET: /* IPv4 address record. */
|
|
{
|
|
sockaddr_in_t *pSadrIn = (sockaddr_in_t*) ai->ai_addr;
|
|
fprintf( stderr,
|
|
" ai_addr = sin_family: %d (AF_INET = %d, "
|
|
"AF_INET6 = %d)\n"
|
|
" sin_addr: %s\n"
|
|
" sin_port: %s\n",
|
|
pSadrIn->sin_family,
|
|
AF_INET,
|
|
AF_INET6,
|
|
hostBfr,
|
|
servBfr );
|
|
break;
|
|
} /* End CASE of IPv4 record. */
|
|
case PF_INET6: /* IPv6 address record. */
|
|
{
|
|
pSadrIn6 = (sockaddr_in6_t*) ai->ai_addr;
|
|
fprintf( stderr,
|
|
" ai_addr = sin6_family: %d (AF_INET = %d, "
|
|
"AF_INET6 = %d)\n"
|
|
" sin6_addr: %s\n"
|
|
" sin6_port: %s\n"
|
|
" sin6_flowinfo: %d\n"
|
|
" sin6_scope_id: %d\n",
|
|
pSadrIn6->sin6_family,
|
|
AF_INET,
|
|
AF_INET6,
|
|
hostBfr,
|
|
servBfr,
|
|
pSadrIn6->sin6_flowinfo,
|
|
pSadrIn6->sin6_scope_id );
|
|
break;
|
|
} /* End CASE of IPv6 record. */
|
|
default: /* Can never get here, but just for completeness. */
|
|
{
|
|
fprintf( stderr,
|
|
"%s (line %d): ERROR - Unknown protocol family (%d).\n",
|
|
pgmName,
|
|
__LINE__,
|
|
ai->ai_family );
|
|
break;
|
|
} /* End DEFAULT case (unknown protocol family). */
|
|
} /* End SWITCH on protocol family. */
|
|
} /* End IF verbose mode. */
|
|
/*
|
|
** Create a socket.
|
|
*/
|
|
if ( !SYSCALL( "socket",
|
|
__LINE__,
|
|
sckt = socket( ai->ai_family,
|
|
ai->ai_socktype,
|
|
ai->ai_protocol ) ) )
|
|
{
|
|
sckt = INVALID_DESC;
|
|
continue; /* Try the next address record in the list. */
|
|
}
|
|
/*
|
|
** Connect to the remote host.
|
|
*/
|
|
if ( !SYSCALL( "connect",
|
|
__LINE__,
|
|
connect( sckt,
|
|
ai->ai_addr,
|
|
ai->ai_addrlen ) ) )
|
|
{
|
|
(void) close( sckt ); /* Could use SYSCALL() again here, but why? */
|
|
sckt = INVALID_DESC;
|
|
continue; /* Try the next address record in the list. */
|
|
}
|
|
} /* End FOR each address record returned by getaddrinfo(3). */
|
|
/*
|
|
** Clean up & return.
|
|
*/
|
|
freeaddrinfo( aiHead );
|
|
return sckt;
|
|
} /* End openSckt() */
|
|
/******************************************************************************
|
|
* Function: tod
|
|
*
|
|
* Description:
|
|
* Receive the time-of-day from the remote server and write it to stdout.
|
|
*
|
|
* Parameters:
|
|
* sckt - The socket descriptor for the connection.
|
|
*
|
|
* Return Value: None.
|
|
******************************************************************************/
|
|
static void tod( int sckt )
|
|
{
|
|
char bfr[ MAXBFRSIZE+1 ];
|
|
int inBytes;
|
|
/*
|
|
** The client never sends anything, so shut down the write side of the
|
|
** connection.
|
|
*/
|
|
if ( !SYSCALL( "shutdown",
|
|
__LINE__,
|
|
shutdown( sckt, SHUT_WR ) ) )
|
|
{
|
|
return;
|
|
}
|
|
/*
|
|
** Read the time-of-day from the remote host.
|
|
*/
|
|
do
|
|
{
|
|
if ( !SYSCALL( "read",
|
|
__LINE__,
|
|
inBytes = read( sckt,
|
|
bfr,
|
|
MAXBFRSIZE ) ) )
|
|
{
|
|
return;
|
|
}
|
|
bfr[ inBytes ] = '\0'; /* Null-terminate the received string. */
|
|
fputs( bfr, stdout ); /* Null string if EOF (inBytes == 0). */
|
|
} while ( inBytes > 0 );
|
|
fflush( stdout );
|
|
} /* End tod() */
|
|
]]></screen></sect3><sect3>
|
|
<title>'Daytime' UDP Client Code</title>
|
|
<para>The UDP client code is found in file tod6uc.c (time-of-day IPv6 UDP client). It is almost an exact duplicate of the TCP client (and in fact was derived from it), but is included in this HowTo for completeness. Once built, the UDP client may be started using the following command syntax (assuming tod6uc is the executable file):</para><screen>
|
|
<![CDATA[tod6uc [-v] [-s scope_id] [host [service]]
|
|
]]></screen><para>ARGUMENTS:</para><variablelist>
|
|
<varlistentry><term>host</term><listitem><para>The hostname or IP address (dotted decimal or colon-hex) of the remote host providing the service. Default is "localhost".</para></listitem></varlistentry><varlistentry><term>service</term><listitem><para>The UDP service (or well-known port number) to which datagrams are sent. Default is "daytime".</para></listitem></varlistentry></variablelist><para>OPTIONS:</para><variablelist>
|
|
<varlistentry><term>-s</term><listitem><para>This option is only meaningful for IPv6 addresses, and is used to set the scope identifier (i.e. the network interface on which to exchange datagrams). Default is "eth0". If host is a scoped address, this option is ignored.</para></listitem></varlistentry><varlistentry><term>-v</term><listitem><para>Turn on verbose mode.</para></listitem></varlistentry></variablelist><para>The UDP client source code contained in tod6uc.c follows:</para><screen>
|
|
<![CDATA[/******************************************************************************
|
|
* File: tod6uc.c
|
|
* Description: Contains source code for an IPv6-capable 'daytime' UDP client.
|
|
* Author: John Wenker, Sr. Software Engineer
|
|
* Performance Technologies, San Diego, USA
|
|
******************************************************************************/
|
|
/*
|
|
** System header files.
|
|
*/
|
|
#include <errno.h> /* errno declaration and error codes. */
|
|
#include <net/if.h> /* if_nametoindex(3). */
|
|
#include <netdb.h> /* getaddrinfo(3) and associated definitions. */
|
|
#include <netinet/in.h> /* sockaddr_in and sockaddr_in6 definitions. */
|
|
#include <stdio.h> /* printf(3) et al. */
|
|
#include <stdlib.h> /* exit(2). */
|
|
#include <string.h> /* String manipulation and memory functions. */
|
|
#include <sys/socket.h> /* Socket functions (socket(2), connect(2), etc). */
|
|
#include <unistd.h> /* getopt(3), recvfrom(2), sendto(2), etc. */
|
|
/*
|
|
** Constants & macros.
|
|
*/
|
|
#define DFLT_HOST "localhost" /* Default server name. */
|
|
#define DFLT_SCOPE_ID "eth0" /* Default scope identifier. */
|
|
#define DFLT_SERVICE "daytime" /* Default service name. */
|
|
#define INVALID_DESC -1 /* Invalid file (socket) descriptor. */
|
|
#define MAXBFRSIZE 256 /* Max bfr sz to read remote TOD. */
|
|
#define VALIDOPTS "s:v" /* Valid command options. */
|
|
/*
|
|
** Type definitions (for convenience).
|
|
*/
|
|
typedef enum { false = 0, true } boolean;
|
|
typedef struct sockaddr_in sockaddr_in_t;
|
|
typedef struct sockaddr_in6 sockaddr_in6_t;
|
|
/*
|
|
** Prototypes for internal helper functions.
|
|
*/
|
|
static int openSckt( const char *host,
|
|
const char *service,
|
|
unsigned int scopeId );
|
|
static void tod( int sckt );
|
|
/*
|
|
** Global (within this file only) data objects.
|
|
*/
|
|
static const char *pgmName; /* Program name (w/o directory). */
|
|
static boolean verbose = false; /* Verbose mode. */
|
|
/*
|
|
** Usage macro.
|
|
*/
|
|
#define USAGE \
|
|
{ \
|
|
fprintf( stderr, \
|
|
"Usage: %s [-v] [-s scope_id] [host [service]]\n", \
|
|
pgmName ); \
|
|
exit( 127 ); \
|
|
} /* End USAGE macro. */
|
|
/*
|
|
** This "macro" (even though it's really a function) is loosely based on the
|
|
** CHK() macro by Dr. V. Vinge (see server code). The status parameter is
|
|
** a boolean expression indicating the return code from one of the usual system
|
|
** calls that returns -1 on error. If a system call error occurred, an alert
|
|
** is written to stderr. It returns a boolean value indicating success/failure
|
|
** of the system call.
|
|
**
|
|
** Example: if ( !SYSCALL( "write",
|
|
** count = write( fd, bfr, size ) ) )
|
|
** {
|
|
** // Error processing... but SYSCALL() will have already taken
|
|
** // care of dumping an error alert to stderr.
|
|
** }
|
|
*/
|
|
static __inline boolean SYSCALL( const char *syscallName,
|
|
int lineNbr,
|
|
int status )
|
|
{
|
|
if ( ( status == -1 ) && verbose )
|
|
{
|
|
fprintf( stderr,
|
|
"%s (line %d): System call failed ('%s') - %s.\n",
|
|
pgmName,
|
|
lineNbr,
|
|
syscallName,
|
|
strerror( errno ) );
|
|
}
|
|
return status != -1; /* True if the system call was successful. */
|
|
} /* End SYSCALL() */
|
|
/******************************************************************************
|
|
* Function: main
|
|
*
|
|
* Description:
|
|
* Connect to a remote time-of-day service and write the remote host's TOD to
|
|
* stdout.
|
|
*
|
|
* Parameters:
|
|
* The usual argc & argv parameters to a main() program.
|
|
*
|
|
* Return Value:
|
|
* This function always returns zero.
|
|
******************************************************************************/
|
|
int main( int argc,
|
|
char *argv[ ] )
|
|
{
|
|
const char *host = DFLT_HOST;
|
|
int opt;
|
|
int sckt;
|
|
unsigned int scopeId = if_nametoindex( DFLT_SCOPE_ID );
|
|
const char *service = DFLT_SERVICE;
|
|
/*
|
|
** Determine the program name (w/o directory prefix).
|
|
*/
|
|
pgmName = (const char*) strrchr( argv[ 0 ], '/' );
|
|
pgmName = pgmName == NULL ? argv[ 0 ] : pgmName+1;
|
|
/*
|
|
** Process command line options.
|
|
*/
|
|
opterr = 0; /* Turns off "invalid option" error messages. */
|
|
while ( ( opt = getopt( argc, argv, VALIDOPTS ) ) != -1 )
|
|
{
|
|
switch ( opt )
|
|
{
|
|
case 's': /* Scope identifier (IPv6 kluge). */
|
|
{
|
|
scopeId = if_nametoindex( optarg );
|
|
if ( scopeId == 0 )
|
|
{
|
|
fprintf( stderr,
|
|
"%s: Unknown network interface (%s).\n",
|
|
pgmName,
|
|
optarg );
|
|
USAGE;
|
|
}
|
|
break;
|
|
}
|
|
case 'v': /* Verbose mode. */
|
|
{
|
|
verbose = true;
|
|
break;
|
|
}
|
|
default:
|
|
{
|
|
USAGE;
|
|
}
|
|
} /* End SWITCH on command option. */
|
|
} /* End WHILE processing command options. */
|
|
/*
|
|
** Process command arguments. At the end of the above loop, optind is the
|
|
** index of the first NON-option argv element.
|
|
*/
|
|
switch ( argc - optind )
|
|
{
|
|
case 2: /* Both host & service are specified on the command line. */
|
|
{
|
|
service = argv[ optind + 1 ];
|
|
/***** Fall through *****/
|
|
}
|
|
case 1: /* Host is specified on the command line. */
|
|
{
|
|
host = argv[ optind ];
|
|
/***** Fall through *****/
|
|
}
|
|
case 0: /* Use default host & service. */
|
|
{
|
|
break;
|
|
}
|
|
default:
|
|
{
|
|
USAGE;
|
|
}
|
|
} /* End SWITCH on number of command arguments. */
|
|
/*
|
|
** Open a connection to the indicated host/service.
|
|
**
|
|
** Note that if all three of the following conditions are met, then the
|
|
** scope identifier remains unresolved at this point.
|
|
** 1) The default network interface is unknown for some reason.
|
|
** 2) The -s option was not used on the command line.
|
|
** 3) An IPv6 "scoped address" was not specified for the hostname on the
|
|
** command line.
|
|
** If the above three conditions are met, then only an IPv4 socket can be
|
|
** opened (connect(2) fails without the scope ID properly set for IPv6
|
|
** sockets).
|
|
*/
|
|
if ( ( sckt = openSckt( host,
|
|
service,
|
|
scopeId ) ) == INVALID_DESC )
|
|
{
|
|
fprintf( stderr,
|
|
"%s: Sorry... a connectionless socket could "
|
|
"not be set up.\n",
|
|
pgmName );
|
|
exit( 1 );
|
|
}
|
|
/*
|
|
** Get the remote time-of-day.
|
|
*/
|
|
tod( sckt );
|
|
/*
|
|
** Close the connection and terminate.
|
|
*/
|
|
(void) SYSCALL( "close",
|
|
__LINE__,
|
|
close( sckt ) );
|
|
return 0;
|
|
} /* End main() */
|
|
/******************************************************************************
|
|
* Function: openSckt
|
|
*
|
|
* Description:
|
|
* Sets up a UDP socket to a remote server. Getaddrinfo(3) is used to
|
|
* perform lookup functions and can return multiple address records (i.e. a
|
|
* list of 'struct addrinfo' records). This function traverses the list and
|
|
* tries to establish a connection to the remote server. The function ends
|
|
* when either a connection has been established or all records in the list
|
|
* have been processed.
|
|
*
|
|
* Parameters:
|
|
* host - A pointer to a character string representing the hostname or IP
|
|
* address (IPv4 or IPv6) of the remote server.
|
|
* service - A pointer to a character string representing the service name or
|
|
* well-known port number.
|
|
* scopeId - For IPv6 sockets only. This is the index corresponding to the
|
|
* network interface on which to exchange datagrams. This
|
|
* parameter is ignored for IPv4 sockets or when an IPv6 "scoped
|
|
* address" is specified in 'host' (i.e. where the colon-hex
|
|
* network address is augmented with the scope ID).
|
|
*
|
|
* Return Value:
|
|
* Returns the socket descriptor for the connection, or INVALID_DESC if all
|
|
* address records have been processed and a socket could not be initialized.
|
|
******************************************************************************/
|
|
static int openSckt( const char *host,
|
|
const char *service,
|
|
unsigned int scopeId )
|
|
{
|
|
struct addrinfo *ai;
|
|
int aiErr;
|
|
struct addrinfo *aiHead;
|
|
struct addrinfo hints;
|
|
sockaddr_in6_t *pSadrIn6;
|
|
int sckt;
|
|
/*
|
|
** Initialize the 'hints' structure for getaddrinfo(3).
|
|
**
|
|
** Notice that the 'ai_family' field is set to PF_UNSPEC, indicating to
|
|
** return both IPv4 and IPv6 address records for the host/service. Most of
|
|
** the time, the user isn't going to care whether an IPv4 connection or an
|
|
** IPv6 connection is established; the user simply wants to exchange data
|
|
** with the remote host and doesn't care how it's done. Sometimes, however,
|
|
** the user might want to explicitly specify the type of underlying socket.
|
|
** It is left as an exercise for the motivated reader to add a command line
|
|
** option allowing the user to specify the IP protocol, and then process the
|
|
** list of addresses accordingly (it's not that difficult).
|
|
*/
|
|
memset( &hints, 0, sizeof( hints ) );
|
|
hints.ai_family = PF_UNSPEC; /* IPv4 or IPv6 records (don't care). */
|
|
hints.ai_socktype = SOCK_DGRAM; /* Connectionless communication. */
|
|
hints.ai_protocol = IPPROTO_UDP; /* UDP transport layer protocol only. */
|
|
/*
|
|
** Look up the host/service information.
|
|
*/
|
|
if ( ( aiErr = getaddrinfo( host,
|
|
service,
|
|
&hints,
|
|
&aiHead ) ) != 0 )
|
|
{
|
|
fprintf( stderr,
|
|
"%s (line %d): ERROR - %s.\n",
|
|
pgmName,
|
|
__LINE__,
|
|
gai_strerror( aiErr ) );
|
|
return INVALID_DESC;
|
|
}
|
|
/*
|
|
** Go through the list and try to open a connection. Continue until either
|
|
** a connection is established or the entire list is exhausted.
|
|
*/
|
|
for ( ai = aiHead, sckt = INVALID_DESC;
|
|
( ai != NULL ) && ( sckt == INVALID_DESC );
|
|
ai = ai->ai_next )
|
|
{
|
|
/*
|
|
** IPv6 kluge. Make sure the scope ID is set.
|
|
*/
|
|
if ( ai->ai_family == PF_INET6 )
|
|
{
|
|
pSadrIn6 = (sockaddr_in6_t*) ai->ai_addr;
|
|
if ( pSadrIn6->sin6_scope_id == 0 )
|
|
{
|
|
pSadrIn6->sin6_scope_id = scopeId;
|
|
} /* End IF the scope ID wasn't set. */
|
|
} /* End IPv6 kluge. */
|
|
/*
|
|
** Display the address info for the remote host.
|
|
*/
|
|
if ( verbose )
|
|
{
|
|
/*
|
|
** Temporary character string buffers for host & service.
|
|
*/
|
|
char hostBfr[ NI_MAXHOST ];
|
|
char servBfr[ NI_MAXSERV ];
|
|
/*
|
|
** Display the address information just fetched. Start with the
|
|
** common (protocol-independent) stuff first.
|
|
*/
|
|
fprintf( stderr,
|
|
"Address info:\n"
|
|
" ai_flags = 0x%02X\n"
|
|
" ai_family = %d (PF_INET = %d, PF_INET6 = %d)\n"
|
|
" ai_socktype = %d (SOCK_STREAM = %d, SOCK_DGRAM = %d)\n"
|
|
" ai_protocol = %d (IPPROTO_TCP = %d, IPPROTO_UDP = %d)\n"
|
|
" ai_addrlen = %d (sockaddr_in = %d, "
|
|
"sockaddr_in6 = %d)\n",
|
|
ai->ai_flags,
|
|
ai->ai_family,
|
|
PF_INET,
|
|
PF_INET6,
|
|
ai->ai_socktype,
|
|
SOCK_STREAM,
|
|
SOCK_DGRAM,
|
|
ai->ai_protocol,
|
|
IPPROTO_TCP,
|
|
IPPROTO_UDP,
|
|
ai->ai_addrlen,
|
|
sizeof( struct sockaddr_in ),
|
|
sizeof( struct sockaddr_in6 ) );
|
|
/*
|
|
** Display the protocol-specific formatted address.
|
|
*/
|
|
getnameinfo( ai->ai_addr,
|
|
ai->ai_addrlen,
|
|
hostBfr,
|
|
sizeof( hostBfr ),
|
|
servBfr,
|
|
sizeof( servBfr ),
|
|
NI_NUMERICHOST | NI_NUMERICSERV );
|
|
switch ( ai->ai_family )
|
|
{
|
|
case PF_INET: /* IPv4 address record. */
|
|
{
|
|
sockaddr_in_t *pSadrIn = (sockaddr_in_t*) ai->ai_addr;
|
|
fprintf( stderr,
|
|
" ai_addr = sin_family: %d (AF_INET = %d, "
|
|
"AF_INET6 = %d)\n"
|
|
" sin_addr: %s\n"
|
|
" sin_port: %s\n",
|
|
pSadrIn->sin_family,
|
|
AF_INET,
|
|
AF_INET6,
|
|
hostBfr,
|
|
servBfr );
|
|
break;
|
|
} /* End CASE of IPv4 record. */
|
|
case PF_INET6: /* IPv6 address record. */
|
|
{
|
|
pSadrIn6 = (sockaddr_in6_t*) ai->ai_addr;
|
|
fprintf( stderr,
|
|
" ai_addr = sin6_family: %d (AF_INET = %d, "
|
|
"AF_INET6 = %d)\n"
|
|
" sin6_addr: %s\n"
|
|
" sin6_port: %s\n"
|
|
" sin6_flowinfo: %d\n"
|
|
" sin6_scope_id: %d\n",
|
|
pSadrIn6->sin6_family,
|
|
AF_INET,
|
|
AF_INET6,
|
|
hostBfr,
|
|
servBfr,
|
|
pSadrIn6->sin6_flowinfo,
|
|
pSadrIn6->sin6_scope_id );
|
|
break;
|
|
} /* End CASE of IPv6 record. */
|
|
default: /* Can never get here, but just for completeness. */
|
|
{
|
|
fprintf( stderr,
|
|
"%s (line %d): ERROR - Unknown protocol family (%d).\n",
|
|
pgmName,
|
|
__LINE__,
|
|
ai->ai_family );
|
|
break;
|
|
} /* End DEFAULT case (unknown protocol family). */
|
|
} /* End SWITCH on protocol family. */
|
|
} /* End IF verbose mode. */
|
|
/*
|
|
** Create a socket.
|
|
*/
|
|
if ( !SYSCALL( "socket",
|
|
__LINE__,
|
|
sckt = socket( ai->ai_family,
|
|
ai->ai_socktype,
|
|
ai->ai_protocol ) ) )
|
|
{
|
|
sckt = INVALID_DESC;
|
|
continue; /* Try the next address record in the list. */
|
|
}
|
|
/*
|
|
** Set the target destination for the remote host on this socket. That
|
|
** is, this socket only communicates with the specified host.
|
|
*/
|
|
if ( !SYSCALL( "connect",
|
|
__LINE__,
|
|
connect( sckt,
|
|
ai->ai_addr,
|
|
ai->ai_addrlen ) ) )
|
|
{
|
|
(void) close( sckt ); /* Could use SYSCALL() again here, but why? */
|
|
sckt = INVALID_DESC;
|
|
continue; /* Try the next address record in the list. */
|
|
}
|
|
} /* End FOR each address record returned by getaddrinfo(3). */
|
|
/*
|
|
** Clean up & return.
|
|
*/
|
|
freeaddrinfo( aiHead );
|
|
return sckt;
|
|
} /* End openSckt() */
|
|
/******************************************************************************
|
|
* Function: tod
|
|
*
|
|
* Description:
|
|
* Receive the time-of-day from the remote server and write it to stdout.
|
|
*
|
|
* Parameters:
|
|
* sckt - The socket descriptor for the connection.
|
|
*
|
|
* Return Value: None.
|
|
******************************************************************************/
|
|
static void tod( int sckt )
|
|
{
|
|
char bfr[ MAXBFRSIZE+1 ];
|
|
int inBytes;
|
|
/*
|
|
** Send a datagram to the server to wake it up. The content isn't
|
|
** important, but something must be sent to let it know we want the TOD.
|
|
*/
|
|
if ( !SYSCALL( "write",
|
|
__LINE__,
|
|
write( sckt, "Are you there?", 14 ) ) )
|
|
{
|
|
return;
|
|
}
|
|
/*
|
|
** Read the time-of-day from the remote host.
|
|
*/
|
|
if ( !SYSCALL( "read",
|
|
__LINE__,
|
|
inBytes = read( sckt,
|
|
bfr,
|
|
MAXBFRSIZE ) ) )
|
|
{
|
|
return;
|
|
}
|
|
bfr[ inBytes ] = '\0'; /* Null-terminate the received string. */
|
|
fputs( bfr, stdout ); /* Null string if EOF (inBytes == 0). */
|
|
fflush( stdout );
|
|
} /* End tod() */
|
|
]]></screen></sect3></sect2></sect1><sect1>
|
|
<title>Other programming languages</title>
|
|
<sect2>
|
|
<title>JAVA</title>
|
|
<para>Sun Java versions since 1.4 are IPv6 enabled, see e.g. <ulink url="http://java.sun.com/j2se/1.5.0/docs/api/java/net/Inet6Address.html">Inet6Address (1.5/5.0)</ulink> class. Hints are available in the <emphasis>Networking IPv6 User Guide for JDK/JRE</emphasis> <ulink url="http://java.sun.com/j2se/1.4.2/docs/guide/net/ipv6_guide/index.html">1.4</ulink> and <ulink url="http://java.sun.com/j2se/1.5.0/docs/guide/net/ipv6_guide/index.html">1.5 (5.0)</ulink>.</para></sect2><sect2>
|
|
<title>Perl</title>
|
|
<para>As of May 2007 it's not known that the Perl core itself already supports IPv6. It can be added by using following modules:</para><itemizedlist>
|
|
<listitem><para><ulink url="http://search.cpan.org/~umemoto/Socket6/">Socket6</ulink></para></listitem></itemizedlist><para>Anyway, some other modules exist for/with IPv6 support (e.g. Net::IP), search for “IPv6” on <ulink url="http://search.cpan.org/">http://search.cpan.org/</ulink>.</para></sect2></sect1></chapter><chapter id='chapter-interoperability' >
|
|
<title><!-- anchor id="chapter-interoperability" -->Interoperability</title>
|
|
<para>The <ulink url="http://www.tahi.org/">TAHI Project</ulink> checks the interoperability of different operating systems regarding the implementation of IPv6 features. Linux kernel already got the <ulink url="http://www.linux-ipv6.org/v6ready/">IPv6 Ready Logo Phase 1</ulink>. </para></chapter><chapter id='chapter-information' >
|
|
<title><!-- anchor id="chapter-information" -->Further information and URLs</title>
|
|
<sect1 id='information-books' >
|
|
<title><!-- anchor id="information-books" -->Paper printed books, articles, online reviews (mixed)</title>
|
|
<sect2>
|
|
<title>Printed Books (English)</title>
|
|
<sect3>
|
|
<title>Cisco</title>
|
|
<itemizedlist>
|
|
<listitem><para>Cisco Self-Study: Implementing IPv6 Networks (IPV6) by Regis Desmeules. Cisco Press; ISBN 1587050862; 500 pages; 1st edition (April 11, 2003).
|
|
Note: This item will be published on April 11, 2003.</para></listitem><listitem><para>Configuring IPv6 with Cisco IOS by Sam Brown, Sam Browne, Neal Chen, Robbie Harrell, Edgar, Jr. Parenti (Editor), Eric Knipp (Editor), Paul Fong (Editor)362 pages; Syngress Media Inc; ISBN 1928994849; (July 12, 2002).</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>General</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.benedikt-stockebrand.de/books_e.html#ipv6-in-practice">IPv6 in Practice: A Unixer's Guide to the Next Generation Internet</ulink> von Benedikt Stockebrand, November 2006; ISBN 3-540-24524-3</para></listitem><listitem><para><ulink url="http://www.sunny.ch/publications/f_ipv6.htm">IPv6 Essentials</ulink> by Silvia Hagen, 2nd Edition, May 2006; ISBN 0-5961-0058-2
|
|
<ulink url="http://www.oreilly.com/catalog/ipv6ess/">ToC, Index, Sample Chapter etc.</ulink>; <ulink url="http://press.oreilly.com/ipv6ess.html">O'Reilly Pressrelease</ulink></para></listitem><listitem><para>IPv6: The New Internet Protocol. By Christian Huitema; Published by Prentice-Hall; ISBN 0138505055.
|
|
Description: This book, written by Christian Huitema - a member of the InternetArchitecture Board, gives an excellent description of IPv6, how it differs from IPv4, and the hows and whys of it's development.
|
|
Source: <ulink url="http://www.cs.uu.nl/wais/html/na-dir/internet/tcp-ip/resource-list.html">http://www.cs.uu.nl/wais/html/na-dir/internet/tcp-ip/resource-list.html</ulink></para></listitem><listitem><para><ulink url="http://www.epinions.com/book_mu-3402412/display_~full_specs">IPv6 Networks</ulink> by Niles, Kitty; (ISBN 0070248079); 550 pages; Date Published 05/01/1998.</para></listitem><listitem><para>Implementing IPV6. Supporting the Next Generation Internet Protocols by P. E. Miller, Mark A. Miller; Publisher: John Wiley & Sons; ISBN 0764545892; 2nd edition (March 15, 2000); 402 pages.</para></listitem><listitem><para>Big Book of Ipv6 Addressing Rfcs by Peter H. Salus (Compiler), Morgan Kaufmann Publishers, April 2000, 450 pages ISBN 0126167702. </para></listitem><listitem><para><ulink url="http://www.epinions.com/book_mu-3922588/display_~full_specs">Understanding IPV6</ulink> by Davies, Joseph; ISBN 0735612455; Date Published 05/01/2001; Number of Pages: 350.</para></listitem><listitem><para>Migrating to IPv6 - IPv6 in Practice by Marc Blanchet Publisher: John Wiley & Sons; ISBN 0471498920; 1st edition (November 2002); 368 pages.</para></listitem><listitem><para>Ipv6 Network Programming by Jun-ichiro Hagino; ISBN 1555583180</para></listitem><listitem><para><ulink url="http://www.nwfusion.com/news/2000/1023ipv6.html">Wireless boosting IPv6</ulink> by Carolyn Duffy Marsan, 10/23/2000.</para></listitem><listitem><para><ulink url="http://www.oreillynet.com/search/index.ncsp?sp-q=IPv6">O'reilly Network search for keyword IPv6</ulink> results in 29 hits (28. January 2002)</para></listitem></itemizedlist></sect3></sect2><sect2>
|
|
<title>Articles, eBooks, Online Reviews (mixed)</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.onlamp.com/pub/a/onlamp/2001/06/01/ipv6_tutorial.html">Getting Connected with 6to4</ulink> by Huber Feyrer, 06/01/2001</para></listitem><listitem><para>Transient Addressing for Related Processes: Improved Firewalling by Using IPv6 and Multiple Addresses per Host; written by Peter M. Gleiz, Steven M. Bellovin (<ulink url="http://www.securiteinfo.com/ebooks/pdf/tarp.pdf">PC-PDF-Version</ulink>; <ulink url="http://www.securiteinfo.com/ebooks/palm/tarp.pdf">Palm-PDF-Version</ulink>; <ulink url="http://www.securiteinfo.com/ebooks/pdb/tarp.pdb">PDB-Version</ulink>)</para></listitem><listitem><para><ulink url="http://www.ip6.com/index.html">Internetworking IPv6 with Cisco Routers</ulink> by Silvano Gai, McGrawHill Italia, 1997. The 13 chapters and appendix A-D are downloadable as PDF-documents.</para></listitem><listitem><para><ulink url="http://www.csc.fi/~psavola/residential.html">Migration and Co-existence of IPv4 and IPv6 in Residential Networks</ulink> by Pekka Savola, CSC/FUNET, 2002</para></listitem></itemizedlist></sect2><sect2 id='information-sciencepublication' >
|
|
<title><!-- anchor id="information-sciencepublication" -->Science Publications (abstracts, bibliographies, online resources)</title>
|
|
<para>See also: <ulink url="http://liinwww.ira.uka.de/mpsbib?query=ipv6&maxnum=200">liinwww.ira.uka.de/ipv6</ulink> or <ulink url="http://www.google.com/scholar?q=ipv6">Google / Scholar / IPv6</ulink></para><itemizedlist>
|
|
<listitem><para><ulink url="http://www.ipv6.ac.uk/gtpv6/workplan.html">GEANT IPv6 Workplan</ulink></para></listitem><listitem><para><ulink url="http://www.ipv6.ac.uk/bermuda2/">IPv6 Trials on UK Academic Networks: Bermuda Project Aug.2002</ulink>: Participants - Getting connected - Project deliverables - Network topology - Address assignments - Wireless IPv6 access - IPv6 migration - Project presentations - Internet 2 - Other IPv6 projects - IPv6 fora and standards Bermuda 2...</para></listitem><listitem><para><ulink url="http://www.ipv6.ac.uk/">http://www.ipv6.ac.uk/</ulink></para></listitem><listitem><para><ulink url="http://www.ipv6.ecs.soton.ac.uk/">IPv6 at the University of Southampton</ulink></para></listitem><listitem><para>Microsoft Research IPv6 Implementation (MSRIPv6): <ulink url="http://www.research.microsoft.com/msripv6/">MSRIPv6 Configuring 6to4 - Connectivity with MSR IPv6 - Our 6Bone Node... </ulink></para></listitem></itemizedlist></sect2><sect2>
|
|
<title>Others</title>
|
|
<para>See following URL for more: <ulink url="http://www.switch.ch/lan/ipv6/references.html">SWITCH IPv6 Pilot / References</ulink></para></sect2></sect1><sect1 id='information-conferences' >
|
|
<title><!-- anchor id="information-conferences" -->Conferences, Meetings, Summits</title>
|
|
<para>Something missing? Suggestions are welcome!</para><sect2>
|
|
<title>2004</title>
|
|
<itemizedlist>
|
|
<listitem><para>1st Global IPv6 Summit in Sao Paul, Brazil</para></listitem></itemizedlist></sect2></sect1><sect1 id='information-onlineinformation' >
|
|
<title><!-- anchor id="information-onlineinformation" -->Online information</title>
|
|
<sect2 id='information-joinipv6.' >
|
|
<title><!-- anchor id="information-joinipv6." -->Join the IPv6 backbone</title>
|
|
<para>More to be filled later...suggestions are welcome!</para><sect3 id='information-globalregistries' >
|
|
<title><!-- anchor id="information-globalregistries" -->Global registries</title>
|
|
<para>See regional registries.</para></sect3><sect3 id='information-majorregionregistries' >
|
|
<title><!-- anchor id="information-majorregionregistries" -->Major regional registries</title>
|
|
<itemizedlist>
|
|
<listitem><para>America: <ulink url="http://www.arin.net/">ARIN</ulink>, <ulink url="http://www.arin.net/registration/ipv6/index.html">ARIN / registration page</ulink>, <ulink url="http://www.arin.net/registration/ipv6/index.html">ARIN / IPv6 guidelines</ulink></para></listitem><listitem><para>EMEA: <ulink url="http://www.ripe.net/">Ripe NCC</ulink>, <ulink url="http://www.ripe.net/ripencc/mem-services/registration/">Ripe NCC / registration page</ulink>, <ulink url="http://www.ripe.net/ripencc/mem-services/registration/ipv6/">Ripe NCC / IPv6 registration</ulink></para></listitem><listitem><para>Asia/Pacific: <ulink url="http://www.apnic.net/">APNIC</ulink>, <ulink url="http://www.apnic.net/services/ipv6_guide.html">APNIC / IPv6 ressource guide</ulink></para></listitem><listitem><para>Latin America and Caribbea: <ulink url="http://lacnic.org/">LACNIC</ulink>, <ulink url="http://lacnic.net/en/bt-IPv6.html">IPv6 Registration Services</ulink>, <ulink url="http://lacnic.net/en/chapter-4-en.pdf">IPv6 Allocation Policy</ulink></para></listitem><listitem><para>Africa: <ulink url="http://www.afrinic.org/">AfriNIC</ulink></para></listitem></itemizedlist><para>Also a list of major (prefix length 32) allocations per local registry is available here: <ulink url="http://www.ripe.net/ripencc/mem-services/registration/ipv6/ipv6allocs.html">Ripe NCC / IPv6 allocations</ulink>.</para></sect3><sect3 id='information-joinipv6-tunnelbrokers' >
|
|
<title><!-- anchor id="information-joinipv6-tunnelbrokers" -->Tunnel brokers</title>
|
|
<para>Note: A list of available Tunnel broker can be found in the section <link linkend="information-Tunnelbroker">Tunnel broker</link> below. </para><itemizedlist>
|
|
<listitem><para>Former IPng. Tunnelbroker and IPv6 resources, now migrated to the <ulink url="http://www.sixxs.net/main/">SixXs System</ulink>.</para></listitem><listitem><para>Eckes' <ulink url="http://sites.inka.de/lina/linux/ipv6.html">IPv6-with-Linux</ulink> Page.</para></listitem><listitem><para>tunnelc - a perl based tunnel client script:
|
|
freshmeat.net: <ulink url="http://freshmeat.net/projects/tunnelc">Project details for tunnel client</ulink>
|
|
SourceForge: <ulink url="http://sourceforge.net/projects/tunnelc">Project Info - tunnelc</ulink> (also <ulink url="http://tunnelc.sourceforge.net/">here</ulink>)</para></listitem><listitem><para>Linux Advanced Routing & Traffic Control HOWTO, <ulink url="http://howtos.linuxbroker.com/howtoreader.shtml?file=Adv-Routing-HOWTO.html#LARTC.TUNNEL-IPV6.ADDRESSING">Chapter 6: IPv6 tunneling with Cisco and/or 6bone</ulink>.</para></listitem></itemizedlist></sect3><sect3 id='information-joinipv6-6to4-tunneling' >
|
|
<title><!-- anchor id="information-joinipv6-6to4-tunneling" -->6to4</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.kfu.com/~nsayer/6to4/">NSayer's 6to4 information</ulink></para></listitem><listitem><para><ulink url="http://www.faqs.org/rfcs/rfc3068.html">RFC 3068 / An Anycast Prefix for 6to4 Relay Routers</ulink></para></listitem></itemizedlist></sect3><sect3 id='information-joinipv6-isatap-tunneling' >
|
|
<title><!-- anchor id="information-joinipv6-isatap-tunneling" -->ISATAP</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.join.uni-muenster.de/Dokumente/Howtos/Howto_ISATAP.php?lang=en">ISATAP (Intra-Site Automatic Tunnel Access Protocol) Information</ulink> by <ulink url="http://www.join.uni-muenster.de/">JOIN</ulink></para></listitem></itemizedlist></sect3></sect2><sect2>
|
|
<title>Latest news and URLs to other documents</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.estoile.com/links/ipv6">Lot of URLs to others documents</ulink> by Anil Edathara</para></listitem><listitem><para><ulink url="http://www.go6.net/">go6 - The IPv6 Portal</ulink>: an IPv6 online portal with a wiki-based IPv6 knowledge center, an IPv6 discussion forum, an up-to-date collection of IPv6 Events and News, free IPv6 access and services, IPv6 software applications, and much more</para></listitem></itemizedlist></sect2><sect2>
|
|
<title>Protocol references</title>
|
|
<sect3>
|
|
<title>IPv6-related Request For Comments (RFCs)</title>
|
|
<para>Publishing the list of IPv6-related RFCs is beyond the scope of this document, but given URLs will lead you to such lists:</para><itemizedlist>
|
|
<listitem><para>List sorted by <ulink url="http://playground.sun.com/pub/ipng/html/specs/standards.html">IPng Standardization Status</ulink> or <ulink url="http://playground.sun.com/pub/ipng/html/specs/specifications.html">IPng Current Specifications</ulink> by Robert Hinden</para></listitem><listitem><para><ulink url="http://www.ipv6.org/specs.html">IPv6 Related Specifications</ulink> on IPv6.org</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Current drafts of working groups</title>
|
|
<para>Current (also) IPv6-related drafts can be found here:</para><itemizedlist>
|
|
<listitem><para><ulink url="http://www.ietf.org/ids.by.wg/ipv6.html">IP Version 6 (ipv6)</ulink></para></listitem><listitem><para><ulink url="http://www.ietf.org/ids.by.wg/ngtrans.html">Next Generation Transition (ngtrans)</ulink></para></listitem><listitem><para><ulink url="http://www.ietf.org/ids.by.wg/dhc.html">Dynamic Host Configuration (dhc)</ulink></para></listitem><listitem><para><ulink url="http://www.ietf.org/ids.by.wg/dnsext.html">Domain Name System Extension (dnsext)</ulink></para></listitem><listitem><para><ulink url="http://www.ietf.org/ids.by.wg/v6ops.html">IPv6 Operations (v6ops)</ulink></para></listitem><listitem><para><ulink url="http://www.ietf.org/ids.by.wg/mobileip.html">Mobile IP (mobileip)</ulink></para></listitem><listitem><para><ulink url="http://playground.sun.com/pub/ipng/html/ipng-main.html">Get any information about IPv6, from overviews, through RFCs & drafts, to implementations</ulink> (including availability of stacks on various platforms & source code for IPv6 stacks) </para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Others</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.switch.ch/lan/ipv6/references.html">SWITCH IPv6 Pilot / References</ulink>, big list of IPv6 references maintained by Simon Leinen</para></listitem></itemizedlist></sect3></sect2><sect2>
|
|
<title>More information</title>
|
|
<para><ulink url="http://www.deepspace6.net/sections/links.html">DeepSpace6 / more interesting links</ulink></para><sect3>
|
|
<title>Linux related</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.deepspace6.net/">DeepSpace6 / (Not only) Linux IPv6 Portal</ulink> - Italy (<ulink url="http://mirrors.bieringer.de/www.deepspace6.net/">Mirror</ulink>)</para></listitem><listitem><para><ulink url="http://www.bieringer.de/linux/IPv6/">IPv6-HowTo for Linux by Peter Bieringer</ulink> - Germany, and his <ulink url="ftp://ftp.bieringer.de/pub/linux/IPv6/">Bieringer / IPv6 - software archive</ulink></para></listitem><listitem><para><ulink url="http://www.bieringer.de/linux/IPv6/status/IPv6+Linux-status.html">Linux+IPv6 status by Peter Bieringer</ulink> - Germany (going obsolete)</para></listitem><listitem><para><ulink url="http://www.deepspace6.net/docs/ipv6_status_page_apps.html">DeepSpace6 / IPv6 Status Page</ulink> - Italy (<ulink url="http://mirrors.bieringer.de/www.deepspace6.net/docs/ipv6_status_page_apps.html">Mirror</ulink>) (will superseed upper one)</para></listitem><listitem><para><ulink url="http://www.linux-ipv6.org/">USAGI project</ulink> - Japan, and their <ulink url="ftp://ftp.linux-ipv6.org/pub/">USAGI project - software archive</ulink></para></listitem><listitem><para><ulink url="http://www.tldp.org/HOWTO/OLSR-IPv6-HOWTO/">Linux Optimized Link State Routing Protocol (OLSR) IPv6 HOWTO</ulink></para></listitem><listitem><para><ulink url="http://inl.info.ucl.ac.be/LinShim6/">LinShim6</ulink></para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Linux related per distribution</title>
|
|
<variablelist>
|
|
<varlistentry><term>PLD</term><listitem><para><ulink url="http://www.pld-linux.org/">PLD Linux Distribution</ulink> (“market leader” in containing IPv6 enabled packages)</para></listitem></varlistentry><varlistentry><term>Red Hat</term><listitem><para><ulink url="http://www.redhat.com/">Red Hat Enterprise Linux</ulink>, <ulink url="http://www.netcore.fi/pekkas/linux/ipv6/"> Pekka Savola's IPv6 packages (Historic)</ulink></para></listitem></varlistentry><varlistentry><term>Fedora</term><listitem><para><ulink url="https://fedoraproject.org/">Fedora (Project) Linux</ulink></para></listitem></varlistentry><varlistentry><term>Debian</term><listitem><para><ulink url="http://www.debian.org/">Debian Linux</ulink>, <ulink url="http://ipv6.debian.net/">IPv6 with Debian Linux</ulink></para></listitem></varlistentry><varlistentry><term>SuSE</term><listitem><para><ulink url="https://www.suse.com/">SuSE Linux</ulink></para></listitem></varlistentry><varlistentry><term>Mandriva</term><listitem><para><ulink url="http://wiht.link/mandrivalinux">Mandriva (Historic)</ulink></para></listitem></varlistentry></variablelist><para>For more see the <ulink url="http://www.bieringer.de/linux/IPv6/status/IPv6+Linux-status-distributions.html">IPv6+Linux Status Distributions</ulink> page.</para></sect3><sect3>
|
|
<title>General</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.ipv6.org/">IPv6.org</ulink></para></listitem><listitem><para><ulink url="http://www.6bone.net/">6bone</ulink></para></listitem><listitem><para><ulink url="http://www.v6.wide.ad.jp/">WIDE project</ulink> - Japan</para></listitem><listitem><para><ulink url="http://www.switch.ch/lan/ipv6/">SWITCH IPv6 Pilot</ulink> - Switzerland</para></listitem><listitem><para><ulink url="http://www.feyrer.de/IPv6/">IPv6 Corner of Hubert Feyrer</ulink> - Germany</para></listitem><listitem><para><ulink url="http://www.ipv6forum.com/">IPv6 Forum</ulink> - a world-wide consortium of leading Internet vendors, Research & Education Networks...</para></listitem><listitem><para><ulink url="http://playground.sun.com/pub/ipng/html/ipng-main.html">Playground.sun.com / IPv6 Info Page</ulink> - maintained by Robert Hinden, Nokia. Get any information about IPv6, from overviews, through RFCs & drafts, to implementations (including availability of stacks on various platforms & source code for IPv6 stacks).</para></listitem><listitem><para><ulink url="http://www.6init.com/">6INIT</ulink> - IPv6 Internet Initiative - an EU Fifth Framework Project under the IST Programme.</para></listitem><listitem><para><ulink url="http://www.ipv6-taskforce.org/">IPv6 Task Force (European Union)</ulink></para></listitem><listitem><para><ulink url="http://www.6init.org/">6init</ulink> - IPv6 INternet IniTiative </para></listitem><listitem><para><ulink url="http://www.usenix.org/publications/library/proceedings/ana97/summaries/deering.html">IPv6: The New Version of the Internet Protocol</ulink>, by Steve Deering.</para></listitem><listitem><para><ulink url="http://www.garykessler.net/library/ipv6_exp.html">IPv6: The Next Generation Internet Protocol</ulink>, by Gary C. Kessler. </para></listitem><listitem><para><ulink url="http://www.3com.com/nsc/ipv6.html">IPv6: Next Generation Internet Protocol</ulink> - 3Com</para></listitem><listitem><para><ulink url="http://www.internet2.org/">internet || site</ulink> and <ulink url="http://ipv6.internet2.edu/">internet2 Working Group</ulink></para></listitem><listitem><para>NetworkWorldFusion: Search / Doc Finder: <ulink url="http://search.nwfusion.com/query.html?qt=IPv6&qp=&ch=cn&">searched for IPv6</ulink> (102 documents found 22.12.2002)</para></listitem><listitem><para><ulink url="http://www.theregister.co.uk/">The Register</ulink> (Search for IPv6 will result in 30 documents, 22.12.2002)</para></listitem><listitem><para><ulink url="http://zdnet.search.com/search?cat=279&q=IPv6">ZDNet Search for IPv6</ulink></para></listitem><listitem><para><ulink url="http://whatis.techtarget.com/wsearchResults/1,290214,sid9,00.html?query=IPv6">TechTarget Search for IPv6</ulink></para></listitem><listitem><para><ulink url="http://www.faqs.org/faqs/internet/tcp-ip/resource-list/index.html">IPv6 & TCP Resources List</ulink></para></listitem></itemizedlist><para>Something missing? Suggestions are welcome!</para></sect3><sect3 id='information-marketresearch' >
|
|
<title><!-- anchor id="information-marketresearch" -->Market Research</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.seminarinformation.com/wconnect/wc.dll?sis~details0~307~TSN">A Tale of Two Wireless Technology Trends: Processor Development Outsourcing and IPv6</ulink>Yankee Group - 4/1/2002 - 12 Pages - ID: YANL768881</para></listitem><listitem><para><ulink url="http://www.marketresearch.com/product/display.asp?SID=88602378-241489274-186851952&ProductID=803907">The World Atlas of the Internet: Americas</ulink>; IDATE - 2/1/2002 - 242 PAges - ID: IDT803907. Countries covered: Central America, North America, South America; List: Price: $ 3,500.00; excerpt: Panorama of Internet access markets across the globe. Market assessment and forecasts up to 2006 for 34 countries: market structure: main ISPs and market shares; number of subscribers, of ISPs.</para></listitem><listitem><para>Early Interest Rising for IPv6 by IDC (Author); List Price: $1,500.00; Edition: e-book (Acrobat Reader); Publisher: IDC; ISBN B000065T8E; (March 1, 2002) </para></listitem></itemizedlist></sect3><sect3 id='information-patents' >
|
|
<title><!-- anchor id="information-patents" -->Patents</title>
|
|
<itemizedlist>
|
|
<listitem><para>Delphion Research: <ulink url="http://www.delphion.com/research/">Patent Search Page</ulink>. Basic (free) registration needed. Examples found 21.12.2002 searching for IPv6:
|
|
<ulink url="http://www.delphion.com/details?pn=US06118784__">Communicating method between IPv4 terminal and IPv6 terminal and IPv4-IPv6 converting apparatus</ulink>
|
|
<ulink url="http://www.delphion.com/details?pn=US06038233__">Translator for IP networks, network system using the translator, and IP network coupling method therefor</ulink></para></listitem></itemizedlist></sect3></sect2><sect2>
|
|
<title>By countries</title>
|
|
<sect3>
|
|
<title>Europe</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.ist-ipv6.org/">www.ist-ipv6.org</ulink>: IST IPv6 Cluster, European IPv6 Research and Development Projects</para></listitem><listitem><para><ulink url="http://www.euro6ix.org/">Euro6IX</ulink>: European IPv6 Internet Exchanges Backbone</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Austria</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.ikn.tuwien.ac.at/~ipv6/">IPv6@IKNnet and MIPv6 Research Group</ulink>: TU Vienna, Austria (IPv6: project, publications, diploma / doctor thesis, Conference Proceedings etc.)</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Australia</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://oversteer.bl.echidna.id.au/IPv6/">Carl's Australian IPv6 Pages</ulink> (old content)</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Belgium</title>
|
|
<para>Suggestions are welcome!</para></sect3><sect3>
|
|
<title>Brasil</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.ipv6dobrasil.com.br/">IPv6 do Brasil</ulink></para></listitem></itemizedlist></sect3><sect3>
|
|
<title>China</title>
|
|
<para>Suggestions are welcome!</para></sect3><sect3>
|
|
<title>Czech</title>
|
|
<para>Suggestions are welcome!</para></sect3><sect3>
|
|
<title>Germany</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="https://www.xing.com/net/ipv6/">Xing / IPv6</ulink></para></listitem></itemizedlist></sect3><sect3>
|
|
<title>France</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.renater.fr/Projets/IPv6/index.htm">Renater</ulink>: Renater IPv6 Project Page</para></listitem><listitem><para><ulink url="http://www.inria.fr/recherche/equipes/ipv6.fr.html">IPv6 - RSVP - ATM at INRIA</ulink></para></listitem><listitem><para><ulink url="http://www.netbsd.org/fr/Documentation/network/ipv6/">NetBSD IPv6 Documentation</ulink></para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Italy</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://project6.ferrara.linux.it/">Project6</ulink>: IPv6 networking with Linux</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Japan</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.rtpro.yamaha.co.jp/RT/ipv6/">Yamaha IPv6</ulink> (sorry, all in japanese native ...)</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Korea</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.krv6.net/">ETRI</ulink>: Electronics and Telecommunications Research Institut</para></listitem><listitem><para><ulink url="http://www.ipv6.or.kr/english/index.new.htm">IPv6 Forum Korea</ulink>: Korean IPv6 Deployment Project</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Mexico</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.ipv6.unam.mx/">IPv6 Mexico</ulink> (spain & english version): IPv6 Project Hompeage of The National Autonomous University of Mexico (UNAM)</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Netherland</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.ipv6.surfnet.nl/">SURFnet</ulink>: SURFnet IPv6 Backbone</para></listitem><listitem><para><ulink url="http://www.stack.nl/">STACK</ulink>, <ulink url="http://www.stack.nl/ipv6/">STACK (IPv6)</ulink>: Students' computer association of the Eindhoven University of Technology, Netherland</para></listitem><listitem><para><ulink url="http://www.ipng.nl/">IPng.nl</ulink>: collaboration between WiseGuys and Intouch</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Portugal </title>
|
|
<para>Suggestions are welcome!</para></sect3><sect3>
|
|
<title>Russia</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.ipv6.ru/">IPv6 Forum for Russia</ulink>: Yaroslavl State University Internet Center</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Switzerland</title>
|
|
<para>Suggestions are welcome!</para></sect3><sect3>
|
|
<title>United Kingdom</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.bt.com/ipv6/">British Telecom IPv6 Home</ulink>: BT's ISP IPv6 Trial, UK's first IPv6 Internet Exchange etc.</para></listitem></itemizedlist></sect3></sect2><sect2>
|
|
<title>By operating systems</title>
|
|
<sect3>
|
|
<title>*BSD</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.kame.net/">KAME project</ulink> (*BSD)</para></listitem><listitem><para><ulink url="http://www.netbsd.org/Documentation/network/ipv6/">NetBSD's IPv6 Networking FAQ</ulink></para></listitem><listitem><para><ulink url="http://www.freebsd.org/ports/ipv6.html">FreeBSD Ports: Ipv6</ulink></para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Cisco IOS</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.cisco.com/warp/public/732/Tech/ipv6/">Cisco IOS IPv6 Entry Page</ulink></para></listitem><listitem><para><ulink url="http://www.cisco.com/univercd/cc/td/doc/product/software/ios122/122newft/122t/122t2/ipv6/ftipv6c.htm">IPv6 for Cisco IOS Software</ulink>, File 2 of 3: Aug 2002 -- Table of Contents: IPv6 for Cisco IOS Software; Configuring Documentation Specifics; Enabling IPv6 Routing and Configuring; IPv6 Addressing; Enabling IPv6 Processing Globally.</para></listitem><listitem><para>Cisco Internet Networking Handbook, <ulink url="http://www.cisco.com/univercd/cc/td/doc/cisintwk/ito_doc/ipv6.htm">Chapter IPv6</ulink></para></listitem></itemizedlist></sect3><sect3>
|
|
<title>HPUX</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.faqs.org/faqs/hp/hpux-faq/index.html">comp.sys.hp.hpux FAQ</ulink></para></listitem></itemizedlist></sect3><sect3>
|
|
<title>IBM</title>
|
|
<itemizedlist>
|
|
<listitem><para>Now that IBM's announced the availability of z/OS V1.4, <ulink url="http://search390.techtarget.com/ateQuestionNResponse/0,289625,sid10_cid486367_tax292523,00.html">what's new in this release?</ulink> This question was posed on 15 August 2002</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Microsoft</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.microsoft.com/windows2000/technologies/communications/ipv6/default.asp">Microsoft Windows 2000 IPv6</ulink> </para></listitem><listitem><para><ulink url="http://www.research.microsoft.com/msripv6">MSRIPv6</ulink> - Microsoft Research Network - IPv6 Homepage </para></listitem><listitem><para><ulink url="http://support.microsoft.com/default.aspx?scid=kb;en-us;306203">Internet Connection Firewall Does Not Block Internet Protocol Version 6 Traffic</ulink> (6.11.2001)</para></listitem><listitem><para><ulink url="http://support.microsoft.com/default.aspx?scid=kb;en-us;289892">Internet Protocol Numbers</ulink> (8.10.2002)</para></listitem><listitem><para><ulink url="http://support.microsoft.com/default.aspx?scid=kb;en-us;273826">IPv6 Technology Preview Refresh</ulink> (16.10.2002)</para></listitem><listitem><para><ulink url="http://support.microsoft.com/default.aspx?scid=kb;en-us;325449">HOW TO: Install and Configure IP Version 6 in Windows .NET Enterprise Server</ulink> (26.10.2002)</para></listitem><listitem><para><ulink url="http://support.microsoft.com/default.aspx?scid=kb;en-us;329984">Windows .NET Server 6to4 Router Service Quits When You Advertise a 2002 Address on the Public Interface</ulink> (28.10.2002)</para></listitem><listitem><para><ulink url="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wcetcpip/htm/cmconIPv6exe.asp">msdn - Microsoft Windows CE .NET - IPv6 commands</ulink></para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Solaris</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.sun.com/software/solaris/">Sun Microsystems Solaris</ulink></para></listitem><listitem><para><ulink url="http://www.cs.uu.nl/wais/html/na-dir/Solaris2/FAQ.html">Solaris 2 Frequently Asked Questions (FAQ) 1.73</ulink></para></listitem></itemizedlist></sect3><sect3>
|
|
<title>Sumitoma </title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://playground.sun.com/pub/ipng/html/ipng-implementations.html#Sumitomo">Sumitomo Electric has implemented IPv6 on Suminet 3700 family routers</ulink></para></listitem></itemizedlist></sect3><sect3>
|
|
<title>ZebOS</title>
|
|
<itemizedlist>
|
|
<listitem><para>IpInfusion's <ulink url="http://www.ipinfusion.com/products/server/products_server.html">ZebOS Server Routing Software</ulink></para></listitem></itemizedlist></sect3></sect2><sect2 id='information-ipv6andsecurity' >
|
|
<title><!-- anchor id="information-ipv6andsecurity" -->IPv6 Security</title>
|
|
<itemizedlist>
|
|
<listitem><para>Internet Security Systems: Security Center, <ulink url="http://www.iss.net/security_center/search.php?type=3&type=3&pattern=IPv6">X-Force Database Search</ulink> (21.12.2002 - 6 topics found relating to IPv6)</para></listitem><listitem><para><ulink url="http://csrc.nist.gov/ipsec/">NIST IPsec Project</ulink> ( National Institute of Standards and Technology, NIST)</para></listitem><listitem><para><ulink url="http://www.infosecuritymag.com/index.shtml">Information Security</ulink></para></listitem><listitem><para><ulink url="http://neworder.box.sk/search.php3?srch=IPv6">NewOrder.box.sk (search for IPv6)</ulink> (Articles, exploits, files database etc.) </para></listitem></itemizedlist></sect2><sect2>
|
|
<title>Application lists</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.deepspace6.net/docs/ipv6_status_page_apps.html">DeepSpace6 / IPv6 Status Page</ulink> (<ulink url="http://mirrors.bieringer.de/www.deepspace6.net/docs/ipv6_status_page_apps.html">Mirror</ulink>)</para></listitem><listitem><para><ulink url="http://www.ipv6.org/v6-apps.html">IPv6.org / IPv6 enabled applications</ulink></para></listitem><listitem><para><ulink url="http://freshmeat.net/search/?q=IPv6">Freshmeat / IPv6 search</ulink>, currently (14 Dec 2002) 62 projects</para></listitem><listitem><para><ulink url="http://www.ipv6forum.com/modules.php?op=modload&name=Web_Links&file=index">IPv6 Forum / Web Links</ulink></para></listitem></itemizedlist><sect3>
|
|
<title>Analyzer tools</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.wireshark.org/">Wireshark</ulink> (former known as <emphasis>Ethereal</emphasis>) is a free network protocol analyzer for Unix and Windows</para></listitem><listitem><para><ulink url="http://www.ip6.com/us/analyzer.htm">Radcom RC100-WL</ulink> - Download Radcom RC100-WL protocol analyzer version 3.20</para></listitem></itemizedlist></sect3><sect3>
|
|
<title>IPv6 Products</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.6wind.com/">6wind</ulink> - solutions for IPv4/IPv6 Router, QoS, Multicast, Mobility, Security/VPN/Firewall. </para></listitem><listitem><para><ulink url="http://www.fefe.de/dns/">Fefe's patches for IPv6 with djbdns</ulink>Aug 2002 -- What is djbdns and why does it need IPv6? djbdns is a full blown DNS server which outperforms BIND in nearly all respects.</para></listitem><listitem><para><ulink url="http://www.ipinfusion.com/products/server/products_server.html">ZebOS Server Routing Suite </ulink></para></listitem><listitem><para><ulink url="http://download.cnet.com/Inframail-Advantage-Server-Edition/3000-10248_4-8202652.html">Inframail (Advantage Server Edition)</ulink></para></listitem><listitem><para><ulink url="http://download.cnet.com/HTTrack-Website-Copier/3000-2377_4-10149393.html">HTTrack Website Copier</ulink></para></listitem><listitem><para><ulink url="http://download.cnet.com/CommView/3000-2085_4-10132748.html">CommView</ulink></para></listitem><listitem><para><ulink url="http://download.cnet.com/Posadis/3000-2155_4-10149750.html">Posadis</ulink></para></listitem></itemizedlist></sect3><sect3 id='information-snmp' >
|
|
<title><!-- anchor id="information-snmp" -->SNMP</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.cs.uu.nl/wais/html/na-dir/snmp-faq/part1.html">comp.protocpols.snmp SNMP FAQ Part 1 of 2</ulink></para></listitem></itemizedlist></sect3></sect2></sect1><sect1>
|
|
<title>IPv6 Infrastructure</title>
|
|
<sect2>
|
|
<title>Statistics</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.space.net/~gert/RIPE/">IPv6 routing table history</ulink> created by Gert Döring, <ulink url="http://www.space.net/">Space.Net</ulink></para></listitem><listitem><para><ulink url="http://6bone.informatik.uni-leipzig.de/ipv6/stats/stats.php3">Official 6bone Webserver list Statisic</ulink></para></listitem></itemizedlist></sect2><sect2>
|
|
<title>Internet Exchanges</title>
|
|
<para>Another list of IPv6 Internet Exchanges can be found here: <ulink url="http://www.euro-ix.net/isp/choosing/search/matrix.php">IPv6 status of IXPs in Europe</ulink></para><sect3 id='information-ipv6exchanges-estonia' >
|
|
<title><!-- anchor id="information-ipv6exchanges-estonia" -->Estonia</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://tix.estpak.ee/">TIX</ulink> (tallinn interneti exchange with ipv6 support)</para></listitem></itemizedlist></sect3><sect3 id='information-ipv6exchanges-europe' >
|
|
<title><!-- anchor id="information-ipv6exchanges-europe" -->Europe</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.euro6ix.net/">Euro6IX</ulink>, European IPv6 Internet Exchange Backbone</para></listitem></itemizedlist></sect3><sect3 id='information-ipv6exchanges-france' >
|
|
<title><!-- anchor id="information-ipv6exchanges-france" -->France</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.fnix6.net/">French National Internet Exchange IPv6</ulink> (since 1.11.2002 active).
|
|
FNIX6 provides a free and reliable high speed FastEthernet interconnection between ISP located in TeleCity Paris.</para></listitem></itemizedlist></sect3><sect3 id='information-ipv6exchanges-germany' >
|
|
<title><!-- anchor id="information-ipv6exchanges-germany" -->Germany</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.inxs.de/">INXS</ulink>: (Cable & Wireless) Munich and Hamburg</para></listitem></itemizedlist></sect3><sect3 id='information-ipv6exchanges-japan' >
|
|
<title><!-- anchor id="information-ipv6exchanges-japan" -->Japan</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.wide.ad.jp/nspixp6/">NSPIXP-6</ulink>: IPv6-based Internet Exchange in Tokyo</para></listitem><listitem><para><ulink url="http://www.jpix.co.jp/">JPIX</ulink>, Tokyo</para></listitem></itemizedlist></sect3><sect3 id='information-ipv6exchanges-korea' >
|
|
<title><!-- anchor id="information-ipv6exchanges-korea" -->Korea</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.ngix.ne.kr/">6NGIX</ulink></para></listitem></itemizedlist></sect3><sect3 id='information-ipv6exchanges-netherlands' >
|
|
<title><!-- anchor id="information-ipv6exchanges-netherlands" -->Netherlands</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.ams-ix.net/">AMS-IX</ulink>: Amsterdam Internet Exchange</para></listitem></itemizedlist></sect3><sect3 id='information-ipv6exchanges-uk' >
|
|
<title><!-- anchor id="information-ipv6exchanges-uk" -->UK</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.uk6x.com/">UK6X</ulink>: London</para></listitem><listitem><para><ulink url="http://www.xchangepoint.net/">XchangePoint</ulink>: London</para></listitem></itemizedlist></sect3><sect3 id='information-ipv6exchanges-usa' >
|
|
<title><!-- anchor id="information-ipv6exchanges-usa" -->USA</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.6tap.net/">6TAP</ulink>: Chicago. Supports peerings around the globe.</para></listitem><listitem><para><ulink url="http://www.paix.net/">PAIX</ulink>: Palo Alto</para></listitem></itemizedlist></sect3></sect2><sect2 id='information-Tunnelbroker' >
|
|
<title><!-- anchor id="information-Tunnelbroker" -->Tunnel broker</title>
|
|
<para>See also: <ulink url="http://www.deepspace6.net/docs/tunnelbrokers.html">http://www.deepspace6.net/docs/tunnelbrokers.html</ulink></para><sect3 id='information-tunnelbroker-belgium' >
|
|
<title><!-- anchor id="information-tunnelbroker-belgium" -->Belgium</title>
|
|
<para>Something missing? Suggestions are welcome!</para></sect3><sect3 id='information-tunnelbroker-canada' >
|
|
<title><!-- anchor id="information-tunnelbroker-canada" -->Canada</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.freenet6.net/">Freenet6</ulink> - /48 Delegation, Canada
|
|
<ulink url="http://www.linuxjournal.com/article.php?sid=5963&mode=thread&order=0">Getting IPv6 Using Freenet6 on Debian</ulink>
|
|
<ulink url="http://www.viagenie.qc.ca/en/index.shtml">Freenet6 creater</ulink></para></listitem></itemizedlist></sect3><sect3 id='information-tunnelbroker-china' >
|
|
<title><!-- anchor id="information-tunnelbroker-china" -->China</title>
|
|
<para>Something missing? Suggestions are welcome!</para></sect3><sect3 id='information-tunnelbroker-estonia' >
|
|
<title><!-- anchor id="information-tunnelbroker-estonia" -->Estonia</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://tunnelbroker.ipv6.estpak.ee/?tunnel&PHPSESSID=aa2184190cc2cc6d3a6f6ddd01ae3635">Estpak</ulink></para></listitem></itemizedlist></sect3><sect3 id='information-tunnelbroker-germany' >
|
|
<title><!-- anchor id="information-tunnelbroker-germany" -->Germany</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://6bone.informatik.uni-leipzig.de/">6bone Knoten Leipzig</ulink>
|
|
<ulink url="http://www.mail-archive.com/ipv6@uni-muenster.de/msg00056.html">Info bez. Hackangriff (2001)</ulink></para></listitem></itemizedlist></sect3><sect3 id='information-tunnelbroker-italy' >
|
|
<title><!-- anchor id="information-tunnelbroker-italy" -->Italy</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.comv6.com/">Comv6</ulink></para></listitem><listitem><para><ulink url="http://www.bersafe.it/">Bersafe</ulink> (Italian language)</para></listitem></itemizedlist></sect3><sect3 id='information-tunnelbroker-japan' >
|
|
<title><!-- anchor id="information-tunnelbroker-japan" -->Japan</title>
|
|
<para>Something missing? Suggestions are welcome!</para></sect3><sect3 id='information-tunnelbroker-malaysia' >
|
|
<title><!-- anchor id="information-tunnelbroker-malaysia" -->Malaysia</title>
|
|
<para>Something missing? Suggestions are welcome!</para></sect3><sect3 id='information-tunnelbroker-netherlands' >
|
|
<title><!-- anchor id="information-tunnelbroker-netherlands" -->Netherlands</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.ipng.nl/">IPng Netherland</ulink> - Intouch, SurfNet, AMS-IX, UUNet, Cistron, RIPE NCC and AT&T are connected at the AMS-IX. It is possible (there are requirements...) to get an static tunnel.</para></listitem><listitem><para><ulink url="http://www.ipv6.surfnet.nl/">SURFnet Customers</ulink></para></listitem></itemizedlist></sect3><sect3 id='information-tunnelbroker-norway' >
|
|
<title><!-- anchor id="information-tunnelbroker-norway" -->Norway</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.uninett.no/testnett/index.en.html">UNINETT</ulink> - Pilot IPv6 Service (for Customers): tunnelbroker & address allocation
|
|
<ulink url="http://www.guruz.de/Uninett-Autoupdate-HOWTO">Uninett-Autoupdate-HOWTO</ulink></para></listitem></itemizedlist></sect3><sect3 id='information-tunnelbroker-spain' >
|
|
<title><!-- anchor id="information-tunnelbroker-spain" -->Spain</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://tb.consulintel.euro6ix.org/">Consulintel</ulink></para></listitem></itemizedlist></sect3><sect3 id='information-tunnelbroker-switzerland' >
|
|
<title><!-- anchor id="information-tunnelbroker-switzerland" -->Switzerland</title>
|
|
<para>Something missing? Suggestions are welcome!</para></sect3><sect3 id='information-tunnelbroker-uk' >
|
|
<title><!-- anchor id="information-tunnelbroker-uk" -->UK</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.nttv6.net/">NTT</ulink>, United Kingdom - IPv6 Trial. IPv4 Tunnel and native IPv6 leased Line connections. POPs are located in London, UK Dusseldorf, Germany New Jersey, USA (East Coast) Cupertino, USA (West Coast) Tokyo, Japan</para></listitem></itemizedlist></sect3><sect3 id='information-tunnelbroker-usa' >
|
|
<title><!-- anchor id="information-tunnelbroker-usa" -->USA</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.es.net/hypertext/welcome/pr/ipv6.html">ESnet</ulink>, USA - Energy Sciences Network: Tunnel Registry & Address Delegation for directly connected ESnet sites and ESnet collaborators.</para></listitem><listitem><para><ulink url="http://ipv6tb.he.net/">Hurricane Electric</ulink>, US backbone;
|
|
<ulink url="http://tunnelbroker.net/">Hurrican Electric Tunnelbroker</ulink> (also available under <ulink url="http://tunnelbroker.com/">http://tunnelbroker.com/</ulink>)
|
|
Press Release: <ulink url="http://www.he.net/releases/release6.html">Hurricane Electric Upgrades IPv6 Tunnel Broker</ulink>
|
|
<ulink url="http://ipv6.he.net/tunnelbroker-update.php">Tunnel Broker Endpoint Autoupdate</ulink>, Perl Script</para></listitem></itemizedlist></sect3><sect3 id='information-tunnelbroker-singapore' >
|
|
<title><!-- anchor id="information-tunnelbroker-singapore" -->Singapore</title>
|
|
<para>Something missing? Suggestions are welcome!</para></sect3><sect3 id='information-tunnelbroker-more' >
|
|
<title><!-- anchor id="information-tunnelbroker-more" -->More Tunnel brokers...</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.kfu.com/~nsayer/6to4/">Public 6to4 relay routers</ulink> (MS IIE boycott!)</para></listitem></itemizedlist></sect3></sect2><sect2 id='information-infrastructure-nativeipv6service' >
|
|
<title><!-- anchor id="information-infrastructure-nativeipv6service" -->Native IPv6 Services</title>
|
|
<para>Note: These services are mostly only available with a valid IPv6 connection!</para><sect3 id='information-nativeipv6nntp' >
|
|
<title><!-- anchor id="information-nativeipv6nntp" -->Net News (NNTP)</title>
|
|
<para>Something missing? Suggestions are welcome!</para></sect3><sect3 id='information-nativeipv6gameserver' >
|
|
<title><!-- anchor id="information-nativeipv6gameserver" -->Game Server</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.viagenie.qc.ca/en/ipv6/quake2/ipv6-quake2.shtml">Quake2</ulink> over IPv6</para></listitem></itemizedlist></sect3><sect3 id='information-nativeipv6ircserver' >
|
|
<title><!-- anchor id="information-nativeipv6ircserver" -->IRC Server</title>
|
|
<para>Something missing? Suggestions are welcome!</para></sect3><sect3>
|
|
<title>Radio Stations, Music Streams</title>
|
|
<para>Something missing? Suggestions are welcome!</para></sect3><sect3 id='information-nativeipv6webserver' >
|
|
<title><!-- anchor id="information-nativeipv6webserver" -->Webserver</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.ipv6.bieringer.de/">Peter Bieringer's Home of Linux IPv6 HOWTO </ulink></para></listitem></itemizedlist><para>Something missing? Suggestions are welcome!</para></sect3></sect2></sect1><sect1 id='information-maillists' >
|
|
<title><!-- anchor id="information-maillists" -->Maillists</title>
|
|
<para>Lists of maillists are available at:</para><itemizedlist>
|
|
<listitem><para><ulink url="http://www.deepspace6.net/sections/lists.html">DeepSpace6 / Mailling Lists</ulink></para></listitem></itemizedlist><para>Major Mailinglists are listed in following table:</para>
|
|
<informaltable><tgroup cols="6" colsep="1" rowsep="1">
|
|
<colspec colname="col0" align="center">
|
|
<colspec colname="col1" align="center">
|
|
<colspec colname="col2" align="center">
|
|
<colspec colname="col3" align="center">
|
|
<colspec colname="col4" align="center">
|
|
<colspec colname="col5" align="center">
|
|
<tbody>
|
|
<row>
|
|
<entry align="center" valign="top">Focus</entry>
|
|
<entry align="center" valign="top">Request e-mail address</entry>
|
|
<entry align="center" valign="top">What to subscribe</entry>
|
|
<entry align="center" valign="top">Maillist e-mail address</entry>
|
|
<entry align="center" valign="top">Language</entry>
|
|
<entry align="center" valign="top">Access through WWW</entry>
|
|
</row>
|
|
<row>
|
|
<entry align="center" valign="top">Linux kernel networking including IPv6</entry>
|
|
<entry align="center" valign="top">majordomo (at) vger.kernel.org</entry>
|
|
<entry align="center" valign="top">netdev</entry>
|
|
<entry align="center" valign="top">netdev (at) vger.kernel.org</entry>
|
|
<entry align="center" valign="top">English</entry>
|
|
<entry align="center" valign="top"><ulink url="http://vger.kernel.org/vger-lists.html#netdev">Info</ulink>, <ulink url="http://www.spinics.net/lists/netdev/">Archive</ulink></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="center" valign="top">Mobile IP(v6) for Linux</entry>
|
|
<entry align="center" valign="top">Web-based, see URL</entry>
|
|
<entry align="center" valign="top">mipl</entry>
|
|
<entry align="center" valign="top">mipl (at) mobile-ipv6.org</entry>
|
|
<entry align="center" valign="top">English</entry>
|
|
<entry align="center" valign="top"><ulink url="http://www.mobile-ipv6.org/cgi-bin/mailman/listinfo">Info</ulink>, <ulink url="http://www.mobile-ipv6.org/pipermail/mipl/">Archive</ulink></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="center" valign="top">Linux IPv6 users using USAGI extension</entry>
|
|
<entry align="center" valign="top">usagi-users-ctl (at) linux-ipv6.org</entry>
|
|
<entry align="center" valign="top"></entry>
|
|
<entry align="center" valign="top">usagi-users (at) linux-ipv6.org</entry>
|
|
<entry align="center" valign="top">English</entry>
|
|
<entry align="center" valign="top"><ulink url="http://www.linux-ipv6.org/ml/index.html#usagi-users">Info / Search</ulink>, <ulink url="http://www.linux-ipv6.org/ml/usagi-users/">Archive</ulink></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="center" valign="top">IPv6 on Debian Linux</entry>
|
|
<entry align="center" valign="top"></entry>
|
|
<entry align="center" valign="top"></entry>
|
|
<entry align="center" valign="top">debian-ipv6 (at) lists.debian.org</entry>
|
|
<entry align="center" valign="top">English</entry>
|
|
<entry align="center" valign="top"><ulink url="http://lists.debian.org/debian-ipv6/">Info/Subscription/Archive</ulink></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="center" valign="top">6bone</entry>
|
|
<entry align="center" valign="top">majordomo (at) isi.edu</entry>
|
|
<entry align="center" valign="top">6bone</entry>
|
|
<entry align="center" valign="top">6bone (at) isi.edu</entry>
|
|
<entry align="center" valign="top">English</entry>
|
|
<entry align="center" valign="top"><ulink url="http://www.6bone.net/6bone_email.html">Info</ulink>, <ulink url="http://mailman.isi.edu/pipermail/6bone/">Archive</ulink></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="center" valign="top">IPv6 users in general</entry>
|
|
<entry align="center" valign="top">majordomo (at) ipv6.org</entry>
|
|
<entry align="center" valign="top">users</entry>
|
|
<entry align="center" valign="top">users (at) ipv6.org</entry>
|
|
<entry align="center" valign="top">English</entry>
|
|
<entry align="center" valign="top"><ulink url="http://www.ipv6.org/mailing-lists.html">Info</ulink>, <ulink url="http://www.mail-archive.com/users@ipv6.org/">Archive</ulink></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="center" valign="top">Bugtracking of Internet applications (1)</entry>
|
|
<entry align="center" valign="top">bugtraq-subscribe (at) securityfocus.com</entry>
|
|
<entry align="center" valign="top"></entry>
|
|
<entry align="center" valign="top">bugtraq (at) securityfocus.com (2)</entry>
|
|
<entry align="center" valign="top">English</entry>
|
|
<entry align="center" valign="top"><ulink url="http://online.securityfocus.com/popups/forums/bugtraq/intro.shtml">Info</ulink>, <ulink url="http://online.securityfocus.com/archive/1">Archive</ulink></entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup></informaltable>
|
|
<para>(1) very recommended if you provide server applications.</para>
|
|
<para>(2) list is moderated.
|
|
</para>
|
|
<para>Something missing? Suggestions are welcome!
|
|
</para>
|
|
<para>Following other maillinglists & newsgroups are available via web:</para><itemizedlist>
|
|
<listitem><para><ulink url="http://groups.yahoo.com/group/student-ipv6">student-ipv6 (India)</ulink>
|
|
Description: This is the group for the Student Awareness group of IPv6 in India</para></listitem><listitem><para><ulink url="http://groups.yahoo.com/group/sun-ipv6-users">sun-ipv6-users</ulink>
|
|
Description: Please report problems/suggestions regarding SUN Microsystems IPng implementation</para></listitem><listitem><para><ulink url="http://groups.yahoo.com/group/IPv6-BITS">IPv6-BITS</ulink>
|
|
Description: This List will co-ordinate the working of Project Vertebrae.</para></listitem><listitem><para><ulink url="http://groups.yahoo.com/group/linux-bangalore-ipv6">linux-bangalore-ipv6</ulink>
|
|
Description: The IPv6 deployment list of the Bangalore Linux User Group</para></listitem><listitem><para><ulink url="http://groups.yahoo.com/group/packet-switching">packet-switching</ulink>
|
|
Description: This mailing list provides a forum for discussion of packet switching theory, technology, implementation and application in any relevant aspect including without limitation LAPB, X.25, SDLC, P802.1d, LLC, IP, IPv6, IPX, DECNET, APPLETALK, FR, PPP, IP Telephony, LAN PBX systems, management protocols like SNMP, e-mail, network transparent window systems, protocol implementation, protocol verification, conformance testing and tools used in maintaining or developing packet switching systems.</para></listitem><listitem><para>de.comm.protocols.tcp-ip
|
|
Description: Umstellung auf IPv6
|
|
Source: <ulink url="http://www.faqs.org/faqs/de-newsgroups/chartas/index.html">Chartas der Newsgruppen in de.*</ulink></para></listitem><listitem><para>Google Group: <ulink url="http://groups.google.com/groups?hl=en&lr=&ie=UTF-8&oe=UTF8&safe=off&group=comp.protocols.tcp-ip">comp.protocols.tcp-ip</ulink></para></listitem><listitem><para>Google Group: <ulink url="http://groups.google.com/groups?hl=en&lr=&ie=UTF-8&oe=UTF8&safe=off&group=linux.debian.maint.ipv6">linux.debian.maint.ipv6</ulink></para></listitem><listitem><para>Google Group: <ulink url="http://groups.google.com/groups?hl=en&lr=&ie=UTF-8&oe=UTF8&safe=off&group=microsoft.public.platformsdk.networking.ipv6">microsoft.public.platformsdk.networking.ipv6</ulink></para></listitem><listitem><para>Google Group: <ulink url="http://groups.google.com/groups?hl=en&lr=&ie=UTF-8&oe=UTF8&safe=off&group=fa.openbsd.ipv6">fa.openbsd.ipv6</ulink></para></listitem></itemizedlist></sect1><sect1 id='information-onlinetesttools' >
|
|
<title><!-- anchor id="information-onlinetesttools" -->Online tools</title>
|
|
<sect2>
|
|
<title>Testing tools</title>
|
|
<itemizedlist>
|
|
<listitem><para>ping, traceroute, tracepath, 6bone registry, DNS: <ulink url="http://www.join.uni-muenster.de/lab/testtools.html">JOIN / Testtools</ulink> (German language only, but should be no problem for non German speakers)</para></listitem><listitem><para>traceroute6, whois: <ulink url="http://www.ipng.nl/">IPng.nl</ulink></para></listitem><listitem><para>AAAA Lookup Checker <ulink url="http://www.cnri.dit.ie/cgi-bin/check_aaaa.pl">http://www.cnri.dit.ie/cgi-bin/check_aaaa.pl</ulink></para></listitem></itemizedlist></sect2><sect2>
|
|
<title>Information retrievement</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.ripe.net/ripencc/mem-services/registration/ipv6/ipv6allocs.html">List of worldwide all IPv6-aggregated IP-Blocks</ulink></para></listitem></itemizedlist></sect2><sect2>
|
|
<title>IPv6 Looking Glasses</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.v6.dren.net/lg/">DRENv6 Looking Glass</ulink></para></listitem></itemizedlist></sect2><sect2>
|
|
<title>Helper applications</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.tdoi.org/prefcalc.php">IPv6 Prefix Calculator</ulink> by <ulink url="http://www.tdoi.org/">TDOI</ulink></para></listitem><listitem><para><ulink url="http://www.maths.tcd.ie/cgi-bin/check_dns.pl">DNS record checker</ulink></para></listitem></itemizedlist></sect2></sect1><sect1 id='information-trainingsandseminars' >
|
|
<title><!-- anchor id="information-trainingsandseminars" -->Trainings, Seminars</title>
|
|
<itemizedlist>
|
|
<listitem><para><ulink url="http://www.e-trainonline.com/html/ciw_internetworking_profession.html#IPv6">CIW Internetworking Professional Training CBT CD</ulink></para></listitem><listitem><para><ulink url="http://www.trainingpages.com/x/category,kw-1628,.html">Training Pages</ulink>, U.K. - Search for IPv6 (13 Courses, 2006-08-21)</para></listitem><listitem><para><ulink url="http://www.erion.co.uk/ipv6.html">Erion IPv6 Training</ulink>, UK</para></listitem></itemizedlist><para>Something missing? Suggestions are welcome!</para></sect1><sect1 id='information-onlinediscovery' >
|
|
<title><!-- anchor id="information-onlinediscovery" -->'The Online Discovery' ...</title>
|
|
<para>IPv6: Addressing The Needs Of the Future by Yankee Group (Author)
|
|
List Price: $595.00
|
|
Edition: e-book (Acrobat Reader)
|
|
Pages: 3 (three)
|
|
Publisher: MarketResearch.com; ISBN B00006334Y; (November 1, 2001)
|
|
</para>
|
|
<para>;-) The number of copies would be interesting...
|
|
</para></sect1></chapter><chapter>
|
|
<title>Revision history / Credits / The End</title>
|
|
<sect1 id='revision-history' >
|
|
<title><!-- anchor id="revision-history" -->Revision history</title>
|
|
<para>Versions x.y are published on the Internet.</para>
|
|
<para>Versions x.y.z are work-in-progress and published as LyX and SGML file on CVS. Because Deep Space 6 mirrors these SGML files and generate independend from TLDP public versions, this versions will show up there and also on its mirrors.</para><sect2>
|
|
<title>Releases 0.x</title>
|
|
<variablelist>
|
|
<varlistentry><term>0.65</term><listitem><para>2010-04-20/PB: extend QoS section with examples</para></listitem></varlistentry><varlistentry><term>0.65</term><listitem><para>2009-12-13/PB: minor fixes</para></listitem></varlistentry><varlistentry><term>0.64</term><listitem><para>2009-06-11/PB: extend DHCP server examples (ISC DHCP, Dibbler)</para></listitem></varlistentry><varlistentry><term>0.63</term><listitem><para>2009-02-14/PB: Fix FSF address, major update on 4in6 tunnels, add new section for address resolving, add some URLs, remove broken URLs</para></listitem></varlistentry><varlistentry><term>0.62</term><listitem><para>2008-11-09/PB: Adjust URL to Turkish howto, add some HIP related URLs, remove broken URLs</para></listitem></varlistentry><varlistentry><term>0.61.1</term><listitem><para>2007-11-11/PB: fix broken description of shortcut BIND</para></listitem></varlistentry><varlistentry><term>0.61</term><listitem><para>2007-10-06/PB: fix broken URLs to TLDP-CVS, minor URL update.</para></listitem></varlistentry><varlistentry><term>0.60.2</term><listitem><para>2007-10-03/PB: fix description of sysctl/autoconf (credits to Francois-Xavier Le Bail)</para></listitem></varlistentry><varlistentry><term>0.60.1</term><listitem><para>2007-06-16/PB: speling fixes (credits to Larry W. Burton)</para></listitem></varlistentry><varlistentry><term>0.60</term><listitem><para>2007-05-29/PB: import major contribution to Programming using C-API written by John Wenker, minor fixes</para></listitem></varlistentry><varlistentry><term>0.52</term><listitem><para>2007-05-23/PB: update firewalling chapter, improve document for proper SGML validation, minor bugfixes</para></listitem></varlistentry><varlistentry><term>0.51</term><listitem><para>2006-11-08/PB: remove broken URLs, add a new book (credits to Bryan Vukich)</para></listitem></varlistentry><varlistentry><term>0.50.2</term><listitem><para>2006-10-25/PB: fix typo in dhcp6 section (credits to Michele Ferritto)</para></listitem></varlistentry><varlistentry><term>0.50.1</term><listitem><para>2006-09-23/PB: add some URLs</para></listitem></varlistentry><varlistentry><term>0.50</term><listitem><para>2006-08-24/PB: check RFC URLs, fix URL to Chinese translation, finalize for publishing</para></listitem></varlistentry><varlistentry><term>0.49.5</term><listitem><para>2006-08-23/PB: fix/remove broken URLs</para></listitem></varlistentry><varlistentry><term>0.49.4</term><listitem><para>2006-08-21/PB: some review, update and enhancement of the content, replace old 6bone example addresses with the current defined ones.</para></listitem></varlistentry><varlistentry><term>0.49.3</term><listitem><para>2006-08-20/PB: fix bug in maillist entries, 'mobility' is now a separate chapter</para></listitem></varlistentry><varlistentry><term>0.49.2</term><listitem><para>2006-08-20/PB: update and cleanup of maillist entries</para></listitem></varlistentry><varlistentry><term>0.49.1</term><listitem><para>2006-06-13/PB: major update of mobility section (contributed by Benjamin Thery)</para></listitem></varlistentry><varlistentry><term>0.49</term><listitem><para>2005-10-03/PB: add configuration hints for DHCPv6, major broken URL cleanup (credits to Necdet Yucel)</para></listitem></varlistentry><varlistentry><term>0.48.1</term><listitem><para>2005-01-15/PB: minor fixes</para></listitem></varlistentry><varlistentry><term>0.48</term><listitem><para>2005-01-11/PB: grammar check and minor review of IPv6 IPsec section</para></listitem></varlistentry><varlistentry><term>0.47.1</term><listitem><para>2005-01-01/PB: add information and examples about IPv6 IPsec, add some URLs</para></listitem></varlistentry><varlistentry><term>0.47</term><listitem><para>2004-08-30/PB: add some notes about proftpd, vsftpd and other daemons, add some URLs, minor fixes, update status of Spanish translation</para></listitem></varlistentry><varlistentry><term>0.46.4</term><listitem><para>2004-07-19/PB: minor fixes</para></listitem></varlistentry><varlistentry><term>0.46.3</term><listitem><para>2004-06-23/PB: add note about started Greek translation, replace Taiwanese with Chinese for related translation</para></listitem></varlistentry><varlistentry><term>0.46.2</term><listitem><para>2004-05-22/PB: minor fixes</para></listitem></varlistentry><varlistentry><term>0.46.1</term><listitem><para>2004-04-18/PB: minor fixes</para></listitem></varlistentry><varlistentry><term>0.46</term><listitem><para>2004-03-04/PB: announce Italian translation, add information about DHCPv6, minor updates</para></listitem></varlistentry><varlistentry><term>0.45.1</term><listitem><para>2004-01-12/PB: add note about the official example address space</para></listitem></varlistentry><varlistentry><term>0.45</term><listitem><para>2004-01-11/PB: minor fixes, add/fix some URLs, some extensions</para></listitem></varlistentry><varlistentry><term>0.44.2</term><listitem><para>2003-10-30/PB: fix some copy&paste text bugs</para></listitem></varlistentry><varlistentry><term>0.44.1</term><listitem><para>2003-10-19/PB: add note about start of Italian translation</para></listitem></varlistentry><varlistentry><term>0.44</term><listitem><para>2003-08-15/PB: fix URLs, add hint on tcp_wrappers (about broken notation in some versions) and Apache2</para></listitem></varlistentry><varlistentry><term>0.43.4</term><listitem><para>2003-07-26/PB: fix URL, add archive URL for maillist users at ipv6.org, add some ds6 URLs</para></listitem></varlistentry><varlistentry><term>0.43.3</term><listitem><para>2003-06-19/PB: fix typos</para></listitem></varlistentry><varlistentry><term>0.43.2</term><listitem><para>2003-06-11/PB: fix URL</para></listitem></varlistentry><varlistentry><term>0.43.1</term><listitem><para>2003-06-07/PB: fix some URLs, fix credits, add some notes at IPsec</para></listitem></varlistentry><varlistentry><term>0.43</term><listitem><para>2003-06-05/PB: add some notes about configuration in SuSE Linux, add URL of French translation</para></listitem></varlistentry><varlistentry><term>0.42</term><listitem><para>2003-05-09/PB: minor fixes, announce French translation</para></listitem></varlistentry><varlistentry><term>0.41.4</term><listitem><para>2003-05-02/PB: Remove a broken URL, update some others.</para></listitem></varlistentry><varlistentry><term>0.41.3</term><listitem><para>2003-04-23/PB: Minor fixes, remove a broken URL, fix URL to Taiwanese translation</para></listitem></varlistentry><varlistentry><term>0.41.2</term><listitem><para>2003-04-13/PB: Fix some typos, add a note about a French translation is in progress</para></listitem></varlistentry><varlistentry><term>0.41.1</term><listitem><para>2003-03-31/PB: Remove a broken URL, fix another</para></listitem></varlistentry><varlistentry><term>0.41</term><listitem><para>2003-03-22/PB: Add URL of German translation</para></listitem></varlistentry><varlistentry><term>0.40.2</term><listitem><para>2003-02-27/PB: Fix a misaddressed URL</para></listitem></varlistentry><varlistentry><term>0.40.1</term><listitem><para>2003-02-12/PB: Add Debian-Linux-Configuration, add a minor note on translations</para></listitem></varlistentry><varlistentry><term>0.40</term><listitem><para>2003-02-10/PB: Announcing available German version</para></listitem></varlistentry><varlistentry><term>0.39.2</term><listitem><para>2003-02-10/GK: Minor syntax and spelling fixes</para></listitem></varlistentry><varlistentry><term>0.39.1</term><listitem><para>2003-01-09/PB: fix an URL (draft adopted to an RFC)</para></listitem></varlistentry><varlistentry><term>0.39</term><listitem><para>2003-01-13/PB: fix a bug (forgotten 'link” on “ip link set” (credits to Yaniv Kaul)</para></listitem></varlistentry><varlistentry><term>0.38.1</term><listitem><para>2003-01-09/PB: a minor fix</para></listitem></varlistentry><varlistentry><term>0.38</term><listitem><para>2003-01-06/PB: minor fixes</para></listitem></varlistentry><varlistentry><term>0.37.1</term><listitem><para>2003-01-05/PB: minor updates</para></listitem></varlistentry><varlistentry><term>0.37</term><listitem><para>2002-12-31/GK: 270 new links added (searched in 1232 SearchEngines) in existing and 53 new (sub)sections</para></listitem></varlistentry><varlistentry><term>0.36.1</term><listitem><para>2002-12-20/PB: Minor fixes</para></listitem></varlistentry><varlistentry><term>0.36</term><listitem><para>2002-12-16/PB: Check of and fix broken links (credits to Georg Käfer), some spelling fixes</para></listitem></varlistentry><varlistentry><term>0.35</term><listitem><para>2002-12-11/PB: Some fixes and extensions</para></listitem></varlistentry><varlistentry><term>0.34.1</term><listitem><para>2002-11-25/PB: Some fixes (e.g. broken linuxdoc URLs)</para></listitem></varlistentry><varlistentry><term>0.34</term><listitem><para>2002-11-19/PB: Add information about German translation (work in progress), some fixes, create a small shortcut explanation list, extend “used terms” and add two German books</para></listitem></varlistentry><varlistentry><term>0.33</term><listitem><para>2002-11-18/PB: Fix broken RFC-URLs, add parameter ttl on 6to4 tunnel setup example</para></listitem></varlistentry><varlistentry><term>0.32</term><listitem><para>2002-11-03/PB: Add information about Taiwanese translation</para></listitem></varlistentry><varlistentry><term>0.31.1</term><listitem><para>2002-10-06/PB: Add another maillist</para></listitem></varlistentry><varlistentry><term>0.31</term><listitem><para>2002-09-29/PB: Extend information in proc-filesystem entries</para></listitem></varlistentry><varlistentry><term>0.30</term><listitem><para>2002-09-27/PB: Add some maillists</para></listitem></varlistentry><varlistentry><term>0.29</term><listitem><para>2002-09-18/PB: Update statement about nmap (triggered by Fyodor)</para></listitem></varlistentry><varlistentry><term>0.28.1</term><listitem><para>2002-09-16/PB: Add note about ping6 to multicast addresses, add some labels</para></listitem></varlistentry><varlistentry><term>0.28</term><listitem><para>2002-08-17/PB: Fix broken LDP/CVS links, add info about Polish translation, add URL of the IPv6 Address Oracle</para></listitem></varlistentry><varlistentry><term>0.27</term><listitem><para>2002-08-10/PB: Some minor updates</para></listitem></varlistentry><varlistentry><term>0.26.2</term><listitem><para>2002-07-15/PB: Add information neighbor discovery, split of firewalling (got some updates) and security into extra chapters</para></listitem></varlistentry><varlistentry><term>0.26.1</term><listitem><para>2002-07-13/PB: Update nmap/IPv6 information</para></listitem></varlistentry><varlistentry><term>0.26</term><listitem><para>2002-07-13/PB: Fill /proc-filesystem chapter, update DNS information about depricated A6/DNAME, change P-t-P tunnel setup to use of “ip” only</para></listitem></varlistentry><varlistentry><term>0.25.2</term><listitem><para>2002-07-11/PB: Minor spelling fixes</para></listitem></varlistentry><varlistentry><term>0.25.1</term><listitem><para>2002-06-23/PB: Minor spelling and other fixes</para></listitem></varlistentry><varlistentry><term>0.25</term><listitem><para>2002-05-16/PB: Cosmetic fix for 2^128, thanks to José Abílio Oliveira Matos for help with LyX</para></listitem></varlistentry><varlistentry><term>0.24</term><listitem><para>2002-05-02/PB: Add entries in URL list, minor spelling fixes</para></listitem></varlistentry><varlistentry><term>0.23</term><listitem><para>2002-03-27/PB: Add entries in URL list and at maillists, add a label and minor information about IPv6 on RHL</para></listitem></varlistentry><varlistentry><term>0.22</term><listitem><para>2002-03-04/PB: Add info about 6to4 support in kernel series 2.2.x and add an entry in URL list and at maillists</para></listitem></varlistentry><varlistentry><term>0.21</term><listitem><para>2002-02-26/PB: Migrate next grammar checks submitted by John Ronan </para></listitem></varlistentry><varlistentry><term>0.20.4</term><listitem><para>2002-02-21/PB: Migrate more grammar checks submitted by John Ronan, add some additional hints at DNS section </para></listitem></varlistentry><varlistentry><term>0.20.3</term><listitem><para>2002-02-12/PB: Migrate a minor grammar check patch submitted by John Ronan</para></listitem></varlistentry><varlistentry><term>0.20.2</term><listitem><para>2002-02-05/PB: Add mipl to maillist table</para></listitem></varlistentry><varlistentry><term>0.20.1</term><listitem><para>2002-01-31/PB: Add a hint how to generate 6to4 addresses</para></listitem></varlistentry><varlistentry><term>0.20</term><listitem><para>2002-01-30/PB: Add a hint about default route problem, some minor updates</para></listitem></varlistentry><varlistentry><term>0.19.2</term><listitem><para>2002-01-29/PB: Add many new URLs</para></listitem></varlistentry><varlistentry><term>0.19.1</term><listitem><para>2002-01-27/PB: Add some forgotten URLs</para></listitem></varlistentry><varlistentry><term>0.19</term><listitem><para>2002-01-25/PB: Add two German books, fix quote entinities in exported SGML code</para></listitem></varlistentry><varlistentry><term>0.18.2</term><listitem><para>2002-01-23/PB: Add a FAQ on the program chapter</para></listitem></varlistentry><varlistentry><term>0.18.1</term><listitem><para>2002-01-23/PB: Move “the end” to the end, add USAGI to maillists</para></listitem></varlistentry><varlistentry><term>0.18</term><listitem><para>2002-01-22/PB: Fix bugs in explanation of multicast address types</para></listitem></varlistentry><varlistentry><term>0.17.2</term><listitem><para>2002-01-22/PB: Cosmetic fix double existing text in history (at 0.16), move all credits to the end of the document</para></listitem></varlistentry><varlistentry><term>0.17.1</term><listitem><para>2002-01-20/PB: Add a reference, fix URL text in online-test-tools</para></listitem></varlistentry><varlistentry><term>0.17</term><listitem><para>2002-01-19/PB: Add some forgotten information and URLs about global IPv6 addresses</para></listitem></varlistentry><varlistentry><term>0.16</term><listitem><para>2002-01-19/PB: Minor fixes, remove “bold” and “emphasize” formats on code lines, fix “too long unwrapped code lines” using selfmade utility, extend list of URLs.</para></listitem></varlistentry><varlistentry><term>0.15</term><listitem><para>2002-01-15/PB: Fix bug in addresstype/anycast, move content related credits to end of document</para></listitem></varlistentry><varlistentry><term>0.14</term><listitem><para>2002-01-14/PB: Minor review at all, new chapter “debugging”, review “addresses”, spell checking, grammar checking (from beginning to 3.4.1) by Martin Krafft, add tcpdump examples, copy firewalling/netfilter6 from IPv6+Linux-HowTo, minor enhancements</para></listitem></varlistentry><varlistentry><term>0.13</term><listitem><para>2002-01-05/PB: Add example BIND9/host, move revision history to end of document, minor extensions</para></listitem></varlistentry><varlistentry><term>0.12</term><listitem><para>2002-01-03/PB: Merge review of David Ranch</para></listitem></varlistentry><varlistentry><term>0.11</term><listitem><para>2002-01-02/PB: Spell checking and merge review of Pekka Savola</para></listitem></varlistentry><varlistentry><term>0.10</term><listitem><para>2002-01-02/PB: First public release of chapter 1</para></listitem></varlistentry></variablelist></sect2></sect1><sect1 id='credits' >
|
|
<title><!-- anchor id="credits" -->Credits</title>
|
|
<para>The quickest way to be added to this nice list is to send bug fixes, corrections, and/or updates to me ;-).</para>
|
|
<para>If you want to do a major review, you can use the native LyX file (see <link linkend="general-original-source">original source</link>) and send diffs against it, because diffs against SGML don't help too much.</para><sect2 id='major-credits' >
|
|
<title><!-- anchor id="major-credits" -->Major credits</title>
|
|
<itemizedlist>
|
|
<listitem><para>David Ranch <dranch at trinnet dot net>: For encouraging me to write this HOWTO, his editorial comments on the first few revisions, and his contributions to various IPv6 testing results on my IPv6 web site. Also for his major reviews and suggestions.</para></listitem><listitem><para>Pekka Savola <pekkas at netcore dot fi>: For major reviews, input and suggestions.</para></listitem><listitem><para>Martin F. Krafft <madduck at madduck dot net>: For grammar checks and general reviewing of the document.</para></listitem><listitem><para>John Ronan <j0n at tssg dot wit dot ie>: For grammar checks.</para></listitem><listitem><para>Georg Käfer <gkaefer at gmx dot at>: For detection of no proper PDF creation (fixed now by LDP maintainer Greg Ferguson), input for German books, big list of URLs, checking all URLs, many more suggestions, corrections and contributions, and the German translation</para></listitem><listitem><para>Michel Boucey <mboucey at free dot fr>: Finding typos and some broken URLs, contribute some suggestions and URLs, and the French translation</para></listitem><listitem><para>Michele Ferritto <m dot ferritto at virgilio dot it>: Finding bugs and the Italian translation</para></listitem><listitem><para>Daniel Roesen <dr at cluenet dot de>: For grammar checks</para></listitem><listitem><para>Benjamin Thery <benjamin dot thery at bull dot net>: For contribution of updated mobility section</para></listitem><listitem><para>John Wenker <jjw at pt dot com>: major contribution to Programming using C-API</para></listitem><listitem><para>Srivats P. <Srivats dot P at conexant dot com>: major contribution for 4in6 tunnels</para></listitem></itemizedlist></sect2><sect2>
|
|
<title>Other credits</title>
|
|
<sect3>
|
|
<title>Document technique related</title>
|
|
<para>Writing a LDP HOWTO as a newbie (in LyX and exporting this to DocBook to conform to SGML) isn't as easy as some people say. There are some strange pitfalls... Nevertheless, thanks to:</para><itemizedlist>
|
|
<listitem><para>Authors of the <ulink url="http://www.tldp.org/LDP/LDP-Author-Guide/">LDP Author Guide</ulink></para></listitem><listitem><para>B. Guillon: For his <ulink url="http://perso.libertysurf.fr/bgu/doc/db4lyx/">DocBook with LyX HOWTO</ulink></para></listitem></itemizedlist></sect3><sect3 id='content-related-credits' >
|
|
<title><!-- anchor id="content-related-credits" -->Content related credits</title>
|
|
<para>Credits for fixes and hints are listed here, will grow sure in the future</para><itemizedlist>
|
|
<listitem><para>S .P. Meenakshi <meena at cs dot iitm dot ernet dot in>: For a hint using a “send mail” shell program on tcp_wrapper/hosts.deny</para></listitem><listitem><para>Frank Dinies <FrankDinies at web dot de>: For a bugfix on IPv6 address explanation</para></listitem><listitem><para>John Freed <jfreed at linux-mag dot com>: For finding a bug in IPv6 multicast address explanation</para></listitem><listitem><para>Craig Rodrigues <crodrigu at bbn dot com>: For suggestion about RHL IPv6 setup</para></listitem><listitem><para>Fyodor <fyodor at insecure dot org>: Note me about outdated nmap information</para></listitem><listitem><para>Mauro Tortonesi <mauro at deepspace6 dot net>: For some suggestions</para></listitem><listitem><para>Tom Goodale <goodale at aei-potsdam dot mpg dot de>: For some suggestions</para></listitem><listitem><para>Martin Luemkemann <mluemkem at techfak dot uni-bielefeld dot de>: For a suggestion</para></listitem><listitem><para>Jean-Marc V. Liotier <jim at jipo dot com>: Finding a bug</para></listitem><listitem><para>Yaniv Kaul <ykaul at checkpoint dot com>: Finding a bug</para></listitem><listitem><para>Arnout Engelen <arnouten at bzzt dot net>: For sending note about a draft was adopted to RFC now</para></listitem><listitem><para>Stephane Bortzmeyer <bortzmeyer at nic dot fr>: Contributing persistent configuration on Debian</para></listitem><listitem><para>lithis von saturnsys <lithis at saturnsys dot com>: Reporting a misaddressed URL</para></listitem><listitem><para>Guy Hulbert <gwhulbert at rogers dot com>: Send a note that RFC1924 is probably an April fool's joke</para></listitem><listitem><para>Tero Pelander <tpeland at tkukoulu dot fi>: Reporting a broken URL</para></listitem><listitem><para>Walter Jontofsohn <wjontof at gmx dot de>: Hints for SuSE Linux 8.0/8.1</para></listitem><listitem><para>Benjamin Hofstetter <benjamin dot hofstetter at netlabs dot org>: Reporting a mispointing URL</para></listitem><listitem><para>J.P. Larocque <piranha at ely dot ath dot cx>: Reporting archive URL for maillist users at ipv6 dot org</para></listitem><listitem><para>Jorrit Kronjee <jorrit at wafel dot org>: Reporting broken URLs</para></listitem><listitem><para>Colm MacCarthaigh <colm dot maccarthaigh at heanet dot ie>: Hint for sendfile issue on Apache2</para></listitem><listitem><para>Tiago Camilo <tandre at ipg dot pt>: Contribute some URLs about Mobile IPv6</para></listitem><listitem><para>Harald Geiger: Reporting a bug in how described the bit counting of the universal/global bit</para></listitem><listitem><para>Bjoern Jacke <bjoern at j3e dot de>: Triggered me to fix some outdated information on xinetd</para></listitem><listitem><para>Christoph Egger <cegger at chrrr dot com>: Sending note about “ip” has problems with IPv4-compatible addresses on SuSE Linux 9.0 and trigger to add a hint on 6to4-radvd example</para></listitem><listitem><para>David Lee Haw Ling <hawling at singnet dot com dot sg>: Sending information about a tunnel broker</para></listitem><listitem><para>Michael H. Warfield <mhw at iss dot net>: Sending note about suffix for 6to4 routers</para></listitem><listitem><para>Tomasz Mrugalski <thomson at klub dot com dot pl>: Sending updates for DHCPv6 section</para></listitem><listitem><para>Jan Minar <jjminar at fastmail dot fm>: Reporting minor bugs</para></listitem><listitem><para>Kalin KOZHUHAROV <kalin at tar dot bz>: Fixing a not so well explanation</para></listitem><listitem><para>Roel van Dijk <rdvdijk at planet dot nl>: Reporting broken URLs</para></listitem><listitem><para>Catalin Muresan <catalin dot muresan at astral dot ro>: Reporting minor bugs</para></listitem><listitem><para>Dennis van Dok <dvandok at quicknet dot nl>: Reporting minor bugs</para></listitem><listitem><para>Necdet Yucel <nyucel at comu dot edu dot tr>: Reporting broken URLs</para></listitem><listitem><para>Bryan Vukich: Reporting a broken URL</para></listitem><listitem><para>Daniele Masini: reporting a broken iptables example</para></listitem><listitem><para>Yao Zhao: reporting a bug in IPv6 route remove description</para></listitem><listitem><para>Aaron Kunde: reporting a broken URL and a content related bug</para></listitem><listitem><para>Larry W. Burton: speling fixes</para></listitem><listitem><para>Justin Pryzby: reporting broken shortcut description of BIND</para></listitem></itemizedlist></sect3></sect2></sect1><sect1>
|
|
<title>The End</title>
|
|
<para>Thanks for reading. Hope it helps!</para>
|
|
<para>If you have any questions, subscribe to proper <link linkend="information-maillists">maillist</link> and describe your problem providing as much as information as possible.</para></sect1></chapter></book> |