addr6 - manual de referencia, opciones, ejemplos de comandos


NOMBRE

addr6 - Una herramienta de análisis y manipulación de direcciones IPv6

SINOPSIS

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 ]

DESCRIPCIÓN

addr6 es una herramienta de análisis de direcciones IPv6. Puede emplearse para identificar el tipo/alcance de la dirección e inferir el tipo de ID de interfaz empleado por una dirección IPv6. Además, addr6 también puede generar estadísticas sobre un conjunto de direcciones IPv6.

addr6 puede filtrar listas de direcciones IPv6 en función de una serie de criterios (tipo de dirección, ámbito de dirección, prefijos, direcciones duplicadas, etc.). Hay dos tipos de filtros: "filtros de bloqueo" y "filtros de aceptación". Si se especifica cualquier "filtro de bloque", se descartarán las direcciones IPv6 que coincidan con cualquiera de esos filtros. Si se especifica cualquier "filtro de aceptación", se aceptará cualquier dirección IPv6 que coincida con ese filtro (y se imprimirá en la salida estándar).

OPCIONES

addr6 toma sus parámetros como opciones de línea de comandos. Cada una de las opciones se puede especificar con un nombre corto (un carácter precedido por un guión, como por ejemplo, "-i") o con un nombre largo (una cadena precedida por dos guiones, como por ejemplo, "--stdin").

-a IPV6_ADDRESS, --address IPV6_ADDRESS

Esta opción se puede emplear para especificar una sola dirección IPv6 que la herramienta debe procesar. Esta opción generalmente se emplea junto con la herramienta '-d' para decodificar la dirección IPv6 en cuestión.

-i, --stdin

Esta opción solicita a la herramienta que lea las direcciones IPv6 desde la entrada estándar (stdin), hasta que se encuentre una condición EOF (fin de archivo).

-j PREFIX, --accept PREFIX

Aceptar direcciones IPv6 pertenecientes al prefijo IPv6 especificado (PREFIX/LEN).

-b TYPE, --accept-type TYPE

Aceptar direcciones IPv6 pertenecientes al tipo de dirección especificado. Los tipos de dirección válidos son:

* unidifusión * sin especificar * multidifusión

-k SCOPE, --accept-scope SCOPE

Aceptar direcciones IPv6 que pertenecen al ámbito de dirección especificado. Los ámbitos de dirección válidos son:

* reservado * interfaz (o "interfaz-local) * enlace (o "enlace-local") * administrador (o "admin-local") * sitio (o "sitio-local") * administrador (o "admin-local" ) * organización (o "organización-local") * global * sin asignar * sin especificar

-w UNICAST_TYPE, --accept-utype UNICAST_TYPE

Aceptar direcciones IPv6 pertenecientes al tipo de unidifusión especificado. Los tipos de direcciones de unidifusión válidos son:

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

-g IID_TYPE, --accept-iid IID_TYPE

Acepte direcciones IPv6 de unidifusión con un ID de interfaz del tipo especificado. Los tipos de ID de interfaz válidos son:

* ieee * isatap * ipv4-32 * ipv4-64 * ipv4-all * embed-port * embed-port-rev * embed-port-all * byte bajo * byte-pattern * aleatorio

-J PREFIX, --block PREFIX

Bloquear direcciones IPv6 pertenecientes al prefijo IPv6 especificado (PREFIX/LEN).

-B TYPE, --block-type TYPE

Bloquea las direcciones IPv6 que pertenecen al tipo de dirección especificado. Los tipos de dirección válidos son:

* unidifusión * sin especificar * multidifusión

-K SCOPE, --block-scope SCOPE

Bloquee las direcciones IPv6 que pertenecen al ámbito de dirección especificado. Los ámbitos de dirección válidos son:

* reservado * interfaz (o "interfaz-local) * enlace (o "enlace-local") * administrador (o "admin-local") * sitio (o "sitio-local") * administrador (o "admin-local" ) * organización (o "organización-local") * global * sin asignar * sin especificar

-W UNICAST_TYPE, --block-utype UNICAST_TYPE

Bloquear direcciones IPv6 pertenecientes al tipo de unidifusión especificado. Los tipos de direcciones de unidifusión válidos son:

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

-G IPV6_ADDRESS, --block-iid IID_TYPE

Bloquee las direcciones IPv6 de unidifusión con una ID de interfaz del tipo especificado. Los tipos de ID de interfaz válidos son:

* ieee * isatap * ipv4-32 * ipv4-64 * ipv4-all * embed-port * embed-port-rev * embed-port-all * byte bajo * byte-pattern * aleatorio

-q, --block-dup

Esta opción hace que la herramienta elimine las direcciones duplicadas de la lista de direcciones IPv6 leídas desde la entrada estándar (stdin). Es decir, al leer una lista de direcciones de stdin, la herramienta solo procesará la primera "copia" de cada dirección (y las posteriores se ignorarán).

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

Esta opción hace que la herramienta acepte solo una dirección por prefijo de la lista de direcciones IPv6 leídas desde la entrada estándar (stdin). La longitud del prefijo correspondiente se especifica como argumento de esta opción. Es decir, al leer una lista de direcciones de stdin, la herramienta solo procesará la primera dirección para cada prefijo de longitud PREFLEN (y las posteriores se ignorarán).

-c, --print-canonic

Esta opción solicita a la herramienta que imprima la dirección IPv6 especificada con la opción '-a' (o una lista de direcciones leídas desde la entrada estándar si se configuró la opción '-i') en su forma canónica. Esto es útil antes de comparar representaciones textuales de direcciones IPv6, ya que la misma dirección generalmente se puede escribir de varias maneras diferentes.

-d, --print-decode

Esta opción solicita a la herramienta que decodifique la dirección IPv6 especificada con la opción '-a' (o una lista de direcciones leídas desde la entrada estándar si se configuró la opción '-i'). La versión actual de la herramienta solo admite el tipo de decodificación, en el que se imprime información para cada dirección con la siguiente sintaxis:

AddressType=AddressSubtype=Scope=IIDType=IIDSubtype

Esta sintaxis simple está destinada a ser fácil para fines de secuencias de comandos. Las versiones futuras de la herramienta incorporarán un modo amigable para los humanos.

-s , --print-stats

Esta opción solicita a la herramienta que produzca estadísticas de direcciones a partir de la lista de direcciones IPv6 leídas de la entrada estándar. Esta opción debe usarse junto con la opción '-i', de modo que se puedan proporcionar varias direcciones como entrada para addr6.

addr6 siempre imprimirá el número total de direcciones IPv6 que se han examinado y el porcentaje de direcciones de unidifusión, multidifusión y no especificadas (::). Si se identifica al menos una dirección de unidifusión, se imprimirán estadísticas específicas de unidifusión. De la misma manera, si se identifica al menos una dirección de multidifusión, se imprimirán estadísticas específicas de multidifusión.

Las estadísticas específicas de unidifusión incluyen:

1) Número y porcentaje de cada tipo de dirección unicast (unicast global, unicast enlace-local, 6to4, Teredo, etc.).

2) Número y porcentaje de cada uno de los diferentes tipos de ID de interfaz (basado en IEEE, byte bajo, etc.).

Solo aquellos tipos de direcciones de unidifusión para los que existen múltiples tipos posibles de ID de interfaz se considerarán para la evaluación de ID de interfaz. A saber,

* 6to4 * Unidifusión global * Unidifusión local de vínculo * Direcciones de unidifusión locales del sitio (obsoletas) * Direcciones de unidifusión locales únicas

Los tipos de dirección unicast como 'Teredo' no se consideran en este análisis, ya que tienen un solo tipo de ID de interfaz, como se especifica en las especificaciones correspondientes.

Las estadísticas específicas de multidifusión incluyen:

1) Número de direcciones y porcentaje de cada tipo de dirección multicast (Permanente, Embedded-RP, etc). 2) Número de direcciones y porcentaje de cada una de las direcciones de multidifusión alcance diferentes tipos de ID de interfaz (Enlace, Interfaz, Global, etc.)

-v , --verbose

Esta opción selecciona la "verbosidad" de la herramienta. Si esta opción no se especifica, solo se imprime la información mínima.

-h , --help

Imprima información de ayuda para la herramienta addr6.

EJEMPLOS

Las siguientes secciones ilustran casos de uso típicos de la herramienta addr6.

Ejemplo #1

cat addresslist.txt | addr6 -i -q

addr6 leerá las direcciones IPv6 de la entrada estándar (opción '-i') y solo imprimirá la primera instancia de cada dirección (opción '-q'), eliminando así cualquier duplicado de la lista.

Nota: En este escenario particular, la lista de direcciones resulta del comando 'cat addresslist.txt', cuya salida se redirige a la entrada estándar de la herramienta addr6.

Ejemplo #2

addr6 -a fc00::1

Decodifica la dirección IPv6 especificada con la opción '-a'. Tenga en cuenta que si bien la opción '-d' no se configuró, este es el comportamiento predeterminado de la herramienta (a menos que se anule con otra opción).

Ejemplo #3

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

addr6 leerá las direcciones IPv6 de la entrada estándar (opción '-i'), ignorará las direcciones duplicadas (opción '-q') e imprimirá estadísticas sobre las direcciones IPv6 procesadas.

Nota: En este escenario particular, la lista de direcciones resulta del comando 'cat addresslist.txt', cuya salida se redirige a la entrada estándar de la herramienta addr6.

Ejemplo #4

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

addr6 leerá las direcciones IPv6 de la entrada estándar (opción '-i'), ignorará las direcciones duplicadas (opción '-q') y decodificará cada una de las direcciones restantes.

Nota: En este escenario particular, la lista de direcciones resulta del comando 'cat addresslist.txt', cuya salida se redirige a la entrada estándar de la herramienta addr6.

Ejemplo #5

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

addr6 leerá direcciones IPv6 desde stdin (opción '-i'), descartará cualquier dirección que no pertenezca al prefijo 2001:db8::/16 (es decir, "aceptará" direcciones pertenecientes a dicho prefijo).

Nota: En este escenario particular, la lista de direcciones resulta del comando 'cat addresslist.txt', cuya salida se redirige a la entrada estándar de la herramienta addr6.

VER TAMBIÉN

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

La herramienta addr6 y las páginas de manual correspondientes fueron producidas por Fernando Gont fgont@si6networks.com para SI6 Networks http://www.si6networks.com .

DERECHOS DE AUTOR

Copyright (c) 2011-2013 Fernando Gont.

Se otorga permiso para copiar, distribuir y/o modificar este documento bajo los términos de la Licencia de Documentación Libre GNU, Versión 1.3 o cualquier versión posterior publicada por la Free Software Foundation; sin secciones invariantes, sin textos de portada y sin textos de contraportada. Una copia de la licencia está disponible en http://www.gnu.org/licenses/fdl.html.