addr6 - manual de referência, opções, exemplos de comandos


NOME

addr6 - Uma ferramenta de análise e manipulação de endereços IPv6

SINOPSE

addr6 [ -a IPV6_ADDR  -i] [ -d ] [ -d ] [ -q ] [ -s ] [ -j PREFIX ] [ -b TYPE ] [ -k SCOPE ] [ -w UNICAST_TYPE ] [ -g IID_TYPE ] [ -J PREFIX ] [ -B TYPE ] [ -K SCOPE ] [ -W UNICAST_TYPE ] [ -G IID_TYPE ] [ -v ] [ -h ]

DESCRIÇÃO

addr6 é uma ferramenta de análise de endereços IPv6. Ele pode identificar o tipo/escopo do endereço e inferir o tipo de ID de interface empregado por um endereço IPv6. Além disso, addr6 também pode produzir estatísticas sobre um conjunto de endereços IPv6.

addr6 pode filtrar listas de endereços IPv6 com base em vários critérios (tipo de endereço, escopo do endereço, prefixos, endereços duplicados, etc.). Existem dois tipos de filtros: "filtros de bloqueio" e "filtros de aceitação". Se algum "filtro de bloqueio" for especificado, os endereços IPv6 correspondentes a qualquer um desses filtros serão descartados. Se qualquer "filtro de aceitação" for especificado, qualquer endereço IPv6 correspondente a esse filtro será aceito (e impresso em stdout).

OPÇÕES

addr6 usa seus parâmetros como opções de linha de comando. Cada uma das opções pode ser especificada com um nome curto (um caractere precedido por um hífen, como, por exemplo, "-i") ou com um nome longo (uma string precedida por dois hífens, como, por exemplo, "--stdin").

-a IPV6_ADDRESS, --address IPV6_ADDRESS

Esta opção pode ser empregada para especificar um único endereço IPv6 que deve ser processado pela ferramenta. Esta opção é normalmente empregada em conjunto com a ferramenta '-d', para decodificar o endereço IPv6 em questão.

-i, --stdin

Esta opção solicita que a ferramenta leia endereços IPv6 da entrada padrão (stdin), até que uma condição EOF (End-Of-File) seja encontrada.

-j PREFIX, --accept PREFIX

Aceite endereços IPv6 pertencentes ao prefixo IPv6 especificado (PREFIX/LEN).

-b TYPE, --accept-type TYPE

Aceite endereços IPv6 pertencentes ao tipo de endereço especificado. Os tipos de endereço válidos são:

* unicast * não especificado * multicast

-k SCOPE, --accept-scope SCOPE

Aceite endereços IPv6 pertencentes ao escopo de endereço especificado. Os escopos de endereço válidos são:

* reservado * interface (ou "interface-local") * link (ou "link-local") * admin (ou "admin-local") * site (ou "site-local") * admin (ou "admin-local" ) * organização (ou "organização-local") * global * não atribuído * não especificado

-w UNICAST_TYPE, --accept-utype UNICAST_TYPE

Aceite endereços IPv6 pertencentes ao tipo unicast especificado. Os tipos de endereço unicast válidos são:

* loopback * ipv4-compat * ipv4-mapped * link-local * site-local * exclusivo-local * 6to4 * teredo * global

-g IID_TYPE, --accept-iid IID_TYPE

Aceite endereços IPv6 unicast com um ID de interface do tipo especificado. Os tipos de ID de interface válidos são:

* ieee * isatap * ipv4-32 * ipv4-64 * ipv4-all * embed-port * embed-port-rev * embed-port-all * low-byte * byte-pattern * aleatório

-J PREFIX, --block PREFIX

Bloquear endereços IPv6 pertencentes ao prefixo IPv6 especificado (PREFIX/LEN).

-B TYPE, --block-type TYPE

Bloqueie endereços IPv6 pertencentes ao tipo de endereço especificado. Os tipos de endereço válidos são:

* unicast * não especificado * multicast

-K SCOPE, --block-scope SCOPE

Bloquear endereços IPv6 pertencentes ao escopo de endereço especificado. Os escopos de endereço válidos são:

* reservado * interface (ou "interface-local") * link (ou "link-local") * admin (ou "admin-local") * site (ou "site-local") * admin (ou "admin-local" ) * organização (ou "organização-local") * global * não atribuído * não especificado

-W UNICAST_TYPE, --block-utype UNICAST_TYPE

Bloquear endereços IPv6 pertencentes ao tipo unicast especificado. Os tipos de endereço unicast válidos são:

* loopback * ipv4-compat * ipv4-mapped * link-local * site-local * exclusivo-local * 6to4 * teredo * global

-G IPV6_ADDRESS, --block-iid IID_TYPE

Bloqueie endereços IPv6 unicast com um ID de interface do tipo especificado. Os tipos de ID de interface válidos são:

* ieee * isatap * ipv4-32 * ipv4-64 * ipv4-all * embed-port * embed-port-rev * embed-port-all * low-byte * byte-pattern * aleatório

-q, --block-dup

Esta opção faz com que a ferramenta elimine endereços duplicados da lista de endereços IPv6 lidos da entrada padrão (stdin). Ou seja, ao ler uma lista de endereços do stdin, apenas a primeira "cópia" de cada endereço será processada pela ferramenta (sendo as posteriores ignoradas).

-p PREFLEN, --block-dup-preflen PREFLEN

Esta opção faz com que a ferramenta aceite apenas um endereço por prefixo da lista de endereços IPv6 lidos da entrada padrão (stdin). O comprimento do prefixo correspondente é especificado como um argumento para esta opção. Ou seja, ao ler uma lista de endereços do stdin, apenas o primeiro endereço para cada prefixo de comprimento PREFLEN será processado pela ferramenta (sendo os posteriores ignorados).

-c, --print-canonic

Esta opção solicita que a ferramenta imprima o endereço IPv6 especificado com a opção '-a' (ou uma lista de endereços lidos do stdin se a opção '-i' foi definida) em sua forma canônica. Isso é útil antes de comparar representações textuais de endereços IPv6, pois o mesmo endereço geralmente pode ser escrito de várias maneiras diferentes.

-d, --print-decode

Esta opção solicita que a ferramenta decodifique o endereço IPv6 especificado com a opção '-a' (ou uma lista de endereços lidos do stdin se a opção '-i' foi definida). A versão atual da ferramenta suporta apenas o tipo decodificação, em que as informações são impressas para cada endereço com a seguinte sintaxe:

AddressType=AddressSubtype=Scope=IIDType=IIDSubtype

Essa sintaxe simples foi criada para ser fácil para propósitos de script. Versões futuras da ferramenta incorporarão um modo amigável.

-s , --print-stats

Esta opção solicita que a ferramenta produza estatísticas de endereço da lista de endereços IPv6 lidos da entrada padrão. Esta opção deve ser usada em conjunto com a opção '-i', de forma que vários endereços possam ser fornecidos como entrada para addr6.

addr6 sempre imprimirá o número total de endereços IPv6 que foram examinados e a porcentagem de endereços unicast, multicast e não especificados (::). Se pelo menos um endereço unicast for identificado, as estatísticas específicas do unicast serão impressas. Da mesma forma, se pelo menos um endereço multicast for identificado, as estatísticas específicas do multicast serão impressas.

As estatísticas específicas do Unicast incluem:

1) Número e porcentagem de cada tipo de endereço unicast (unicast global, unicast link-local, 6to4, Teredo, etc.).

2) Número e porcentagem de cada um dos diferentes tipos de ID de interface (baseado em IEEE, byte baixo, etc.).

Somente os tipos de endereço unicast para os quais existem vários tipos possíveis de IDs de interface serão considerados para a avaliação de ID de interface. Nomeadamente,

* 6to4 * Global Unicast * Link-local Unicast * Site-local unicast address (reprovado) * Unique local unicast address

Tipos de endereço Unicast como 'Teredo' não são considerados nesta análise, pois possuem um único tipo de Interface-ID, conforme especificado pelas especificações correspondentes.

As estatísticas específicas de multicast incluem:

1) Número de endereços e porcentagem de cada tipo de endereço multicast (Permanente, Embedded-RP, etc). 2) Numere os endereços e a porcentagem de cada um dos diferentes tipos de Interface ID do escopo do endereço multicast (Link, Interface, Global, etc.)

-v , --verbose

Esta opção seleciona a "verbosidade" da ferramenta. Se esta opção não for especificada, apenas as informações mínimas serão impressas.

-h , --help

Imprima informações de ajuda para a ferramenta addr6.

EXEMPLOS

As seções a seguir ilustram casos de uso típicos da ferramenta addr6.

Exemplo #1

cat addresslist.txt | addr6 -i -q

addr6 lerá endereços IPv6 de stdin (opção '-i') e imprimirá apenas a primeira instância de cada endereço (opção '-q'), removendo efetivamente quaisquer duplicatas da lista.

Nota: Neste cenário específico, a lista de endereços resulta do comando 'cat addresslist.txt', que tem sua saída redirecionada para a entrada padrão da ferramenta addr6.

Exemplo #2

addr6 -a fc00::1

Decodifique o endereço IPv6 especificado com a opção '-a'. Observe que, embora a opção '-d' não tenha sido definida, esse é o comportamento padrão da ferramenta (a menos que seja substituído por outra opção).

Exemplo #3

cat addresslist.txt | addr6 -i -q -s

addr6 lerá endereços IPv6 de stdin (opção '-i'), ignorará endereços duplicados (opção '-q') e imprimirá estatísticas sobre os endereços IPv6 processados.

Nota: Neste cenário específico, a lista de endereços resulta do comando 'cat addresslist.txt', que tem sua saída redirecionada para a entrada padrão da ferramenta addr6.

Exemplo #4

cat addresslist.txt | addr6 -i -q -d

addr6 lerá endereços IPv6 de stdin (opção '-i'), ignorará endereços duplicados (opção '-q') e decodificará cada um dos endereços restantes.

Nota: Neste cenário específico, a lista de endereços resulta do comando 'cat addresslist.txt', que tem sua saída redirecionada para a entrada padrão da ferramenta addr6.

Exemplo #5

cat addresslist.txt | addr6 -i -j 2001:db8::/16

addr6 lerá endereços IPv6 de stdin (opção '-i'), descartará quaisquer endereços que não pertençam ao prefixo 2001:db8::/16 (ou seja, "aceitará" endereços pertencentes a tal prefixo).

Nota: Neste cenário específico, a lista de endereços resulta do comando 'cat addresslist.txt', que tem sua saída redirecionada para a entrada padrão da ferramenta addr6.

VEJA TAMBÉM

ipv6toolkit.conf(5)

draft-ietf-opsec-ipv6-host-scanning (available at: http://tools.ietf.org/html/draft-ietf-opsec-ipv6-host-scanning) for a discussion of different IPv6 address patterns.

AUTOR

A ferramenta addr6 e as respectivas páginas de manual foram produzidas por Fernando Gont fgont@si6networks.com para SI6 Networks http://www.si6networks.com .

DIREITO AUTORAL

Copyright (c) 2011-2013 Fernando Gont.

É concedida permissão para copiar, distribuir e/ou modificar este documento sob os termos da GNU Free Documentation License, Versão 1.3 ou qualquer versão posterior publicada pela Free Software Foundation; sem seções invariantes, sem textos de capa frontal e sem textos de contracapa. Uma cópia da licença está disponível em http://www.gnu.org/licenses/fdl.html.