IPV6(7)

NOMBRE
ipv6 - Implementación Linux del protocolo IPv6

SINOPSIS
#include <sys/socket.h>
#include <netinet/in.h>

tcp6_socket = socket(AF_INET6, SOCK_STREAM, 0);
raw6_socket = socket(AF_INET6, SOCK_RAW, protocol);
udp6_socket = socket(AF_INET6, SOCK_DGRAM, protocol);

DESCRIPCIÓN
La versión 2.2 de Linux implementa opcionalmente el Protocolo de Internet, versión 6. Esta página de manual contiene una descripción de la API básica IPv6 tal como la implementa el núcleo de Linux y glibc 2.1. La interfaz está basada en la interfaz de conectores (sockets) BSD; véase socket(7).

The IPv6 API aims to be mostly compatible with the IPv4 API (see ip(7)). Only differences are described in this man page.

Para enlazar un conector AF_INET6 a cualquier proceso debe copiarse la dirección local de la variable in6addr_any cuyo tipo es in6_addr. En inicializaciones estáticas puede utilizarse también IN6ADDR_ANY_INIT, la cual se expande a una expresión constante. Ambas están en el orden de bytes de la red.

La dirección de loopback IPv6 (::1) está disponible en la variable global in6addr_loopback. Se debe utilizar IN6ADDR_LOOPBACK_INIT para la inicialización.

IPv4 connections can be handled with the v6 API by using the v4-mapped-on-v6 address type; thus a program needs to support only this API type to support both protocols. This is handled transparently by the address handling functions in the C library.

IPv4 y IPv6 comparten el espacio de puertos local. Cuando se envía una petición de conexión o paquete IPv4 a un conector IPv6 la dirección de origen se convierte a v6.

  Formato de direcciones
    struct sockaddr_in6 {
        sa_family_t     sin6_family;   /* AF_INET6 */
        in_port_t       sin6_port;     /* número de puerto */
        uint32_t        sin6_flowinfo; /* Información de flujo IPv6 */
        struct in6_addr sin6_addr;     /* dirección IPv6 */
        uint32_t        sin6_scope_id; /* identificador de ámbito (nuevo en 2.4) */
    };
    struct in6_addr {
        unsigned char   s6_addr[16];   /* dirección IPv6 */
    };

sin6_family is always set to AF_INET6; sin6_port is the protocol port (see sin_port in ip(7)); sin6_flowinfo is the IPv6 flow identifier; sin6_addr is the 128-bit IPv6 address. sin6_scope_id is an ID depending on the scope of the address. It is new in Linux 2.4. Linux supports it only for link-local addresses, in that case sin6_scope_id contains the interface index (see netdevice(7))

IPv6 soporta varios tipos de dirección: unidestino para referirse a un host individual, multidestino para referirse a un grupo de hosts, "cualquier destino" para referirse al miembro más cercano de un grupo de hosts (no implementado en Linux), IPv4-sobre-IPv6 para refererise a un host IPv4, y otros tipos de dirección reservados.

La notación para direcciones IPv6 consiste en un grupo de 8 números hexadecimales de 4 dígitos, separados por ':'. "::" representa una cadena de 0 bits. Direcciones especiales son ::1 para loopback y ::FFFF:<dirección IPv4> para IPv4-mapeada-a-IPv6.

El espacio de puertos de IPv6 es compartido con IPv4.

  Opciones de conectores
IPv6 soporta algunas opciones de conectores específicas del protocolo que pueden ser activadas con setsockopt(2) y leídas con getsockopt(2). El nivel de opciones de conectores para IPv6 es IPPROTO_IPV6. Una bandera entera booleana es cero cuando es falsa, en otro caso es verdadera.

IPV6_ADDRFORM
    Convierte un conector AF_INET6 en un conector de una familia de direcciones diferente. Actualmente, solamente se soporta AF_INET. Sólo está permitido para conectores IPv6 que estén conectados y enlazados a una dirección v4-mapeada-a-v6. El argumento es un puntero a un entero que contiene el valor AF_INET. Esto es útil para pasar conectores v4-mapeados como descriptores de fichero a los programas que no saben comunicarse con la API IPv6.

IPV6_ADD_MEMBERSHIP, IPV6_DROP_MEMBERSHIP
    Control membership in multicast groups. Argument is a pointer to a struct ipv6_mreq.

IPV6_MTU
    getsockopt(): Retrieve the current known path MTU of the current socket. Valid only when the socket has been connected. Returns an integer.

    setsockopt(): Establece la MTU a usar para el conector. La MTU está limitada por la MTU de dispositivo o la MTU de la ruta cuando se ha activado el descubrimiento de la MTU de la ruta. El argumento es un puntero a un entero.

IPV6_MTU_DISCOVER
    Controla el descubrimiento de la MTU de la ruta en el conector. Vea IP_MTU_DISCOVER en ip(7) para más detalles.

IPV6_MULTICAST_HOPS
    Establece el límite de saltos multidestino para el conector. El argumento es un puntero a un entero. Un valor de -1 implica usar la ruta por defecto, en otro caso debe estar entre 0 y 255.

IPV6_MULTICAST_IF
    Establece el dispositivo para los paquetes multidestino de salida del conector. Sólo se permite para conectores SOCK_DGRAM y SOCK_RAW. El argumento es un puntero a un índice de interfaz (vea netdevice(7)) representado como un número entero.

IPV6_MULTICAST_LOOP
    Controla si el conector ve o no los paquetes multidestino que se ha enviado a sí mismo. El argumento es un puntero a un booleano.

IPV6_RECVPKTINFO (desde Linux 2.6.14)
    Set delivery of the IPV6_PKTINFO control message on incoming datagrams. Such control messages contain a struct in6_pktinfo, as per RFC 3542. Allowed only for SOCK_DGRAM or SOCK_RAW sockets. Argument is a pointer to a boolean value in an integer.

IPV6_RTHDR, IPV6_AUTHHDR, IPV6_DSTOPTS, IPV6_HOPOPTS, IPV6_FLOWINFO,
    IPV6_HOPLIMIT Activa la entrega de mensajes de control para los datagramas de entrada que contienen cabeceras de extensión procedentes del paquete recibido. IPV6_RTHDR entrega la cabecera de enrutamiento, IPV6_AUTHHDR entrega la cabecera de autenticación, IPV6_DSTOPTS entrega las opciones de destino, IPV6_HOPOPTS entrega las opciones de salto, IPV6_FLOWINFO entrega un entero que contiene el identificador del flujo, IPV6_HOPLIMIT entrega un entero que contiene el contador de saltos del paquete. Los mensajes de control tienen el mismo tipo que la opción de conector. Todas estas opciones de cabecera también se pueden activar para los paquetes de salida poniendo el mensaje de control apropiado en el buffer de control de sendmsg(2). Esto es válido sólo para conectores SOCK_DGRAM y SOCK_RAW. El argumento es un puntero a un valor booleano.

IPV6_RECVERR
    Controla la recepción de opciones de error asíncronas. Vea IP_RECVERR en ip(7) para más detalles. El argumento es un puntero a un booleano.

IPV6_ROUTER_ALERT
    Pass forwarded packets containing a router alert hop-by-hop option to this socket. Allowed only for SOCK_RAW sockets. The tapped packets are not forwarded by the kernel, it is the user's responsibility to send them out again. Argument is a pointer to an integer. A positive integer indicates a router alert option value to intercept. Packets carrying a router alert option with a value field containing this integer will be delivered to the socket. A negative integer disables delivery of packets with router alert options to this socket.

IPV6_UNICAST_HOPS
    Establece el límite de saltos unidestino para el conector. El argumento es un puntero a un entero. Un valor de -1 implica usar la ruta por defecto, en otro caso debe estar entre 0 y 255.

IPV6_V6ONLY (desde Linux 2.4.21 y 2.6)
    If this flag is set to true (nonzero), then the socket is restricted to sending and receiving IPv6 packets only. In this case, an IPv4 and an IPv6 application can bind to a single port at the same time.

    If this flag is set to false (zero), then the socket can be used to send and receive packets to and from an IPv6 address or an IPv4-mapped IPv6 address.

    The argument is a pointer to a boolean value in an integer.

    The default value for this flag is defined by the contents of the file /proc/sys/net/ipv6/bindv6only. The default value for that file is 0 (false).

ERRORES

ENODEV
    The user tried to bind(2) to a link-local IPv6 address, but the sin6_scope_id in the supplied sockaddr_in6 structure is not a valid interface index.

VERSIONES
Linux 2.4 rompe la compatibilidad binaria para sockaddr_in6 en hosts de 64bit al cambiar la alineación de in6_addr y al añadir un campo sin6_scope_id adicional. Las interfaces del núcleo siguen siendo compatibles, pero un programa que incluya sockaddr_in6 o in6_addr en otras estructuras puede no serlo. Esto no es un problema para hosts de 32bits como i386.

El campo sin6_flowinfo es nuevo en la versión 2.4 de Linux. El núcleo lo pasa/lee transparentemente cuando la longitud de la dirección pasada lo contiene. Algunos programas que pasan un buffer de dirección mayor y comprueban después la longitud de la dirección de salida pueden fallar.

NOTAS
La estructura sockaddr_in6 es mayor que la genérica sockaddr. Los programas que asumen que todos los tipos de dirección se pueden almacenar de manera segura en una struct sockaddr necesitan cambiarse para usar en su lugar struct sockaddr_storage.

SOL_IP, SOL_IPV6, SOL_ICMPV6, and other SOL_* socket options are nonportable variants of IPPROTO_*. See also ip(7).

ERRORES
Actualmente, la API IPv6 extendida, tal y como se describe en RFC 2292, sólo está parcialmente implementada; aunque el núcleo 2.2 soporta casi por completo las opciones de recepción, no existen macros en la glibc 2.1 para generar opciones IPv6.

No hay soporte IPSec para cabeceras EH y AH.

La gestión de las etiquetas de flujos no está completa y no se documenta aquí.

Esta página de manual no está completa.

VÉASE TAMBIÉN
cmsg(3), ip(7)

RFC 2553: IPv6 BASIC API. Linux intenta amoldarse a esto. RFC 2460: especificación de IPv6.

COLOFÓN
Esta página es parte de la versión 5.10 del proyecto Linux man-pages. Puede encontrar una descripción del proyecto, información sobre cómo informar errores y la última versión de esta página en https://www.kernel.org/doc/man-pages/.

TRADUCCIÓN
La traducción al español de esta página del manual fue creada por Juan Piernas <piernas@ditec.um.es> Esta traducción es documentación libre; lea la GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a debian-l10n-spanish@lists.debian.org>..