Provided by:
manpages-es_1.55-10_all 
NOMBRE
ipv6, PF_INET6 - Implementacion Linux del protocolo IPv6
SINOPSIS
#include <sys/socket.h>
#include <netinet/in.h>
tcp6_socket = socket(PF_INET6, SOCK_STREAM, 0);
raw6_socket = socket(PF_INET6, SOCK_RAW, protocol);
udp6_socket = socket(PF_INET6, SOCK_DGRAM, protocol);
DESCRIPCI'ON
La version 2.2 de Linux implementa opcionalmente el Protocolo de
Internet, version 6. Esta pagina de manual contiene una descripcion de
la API basica IPv6 tal como la implementa el nucleo de Linux y glibc
2.1. La interfaz esta basada en la interfaz de conectores (sockets)
BSD; vease socket(7).
La API IPv6 pretende ser sobre todo compatible con la API ip(7) v4. En
esta pagina de manual solo se describen las diferencias.
Para enlazar un conector AF_INET6 a cualquier proceso debe copiarse la
direccion local de la variable in6addr_any cuyo tipo es in6_addr. En
inicializaciones estaticas puede utilizarse tambien IN6ADDR_ANY_INIT ,
la cual se expande a una expresion constante. Ambas estan en el orden
de bytes de la red.
La direccion de loopback IPv6 (::1) esta disponible en la variable
global in6addr_loopback. Se debe utilizar IN6ADDR_LOOPBACK_INIT para
la inicializacion.
Las conexiones IPv4 pueden ser manejadas con la API v6 usando el tipo
de direccion v4-mapeada-a-v6; asi un programa solamente necesita
soportar este tipo de API para soportar ambos protocolos. Todo esto es
manejado de forma transparente por las funciones manejadoras de
direcciones de libc.
IPv4 y IPv6 comparten el espacio de puertos local. Cuando se envia una
peticion de conexion o paquete IPv4 a un conector IPv6 la direccion de
origen se convierte a v6.
FORMATO DE DIRECCIONES
struct sockaddr_in6 {
u_int16_t sin6_family;/* AF_INET6 */
u_int16_t sin6_port;/* numero de puerto */
u_int32_t sin6_flowinfo;/* Informacion de flujo IPv6 */
struct in6_addr sin6_addr;/* direccion IPv6 */
u_int32_t sin6_scope_id;/* identificador de ambito (nuevo en 2.4) */
};
struct in6_addr {
unsigned char s6_addr[16];/* direccion IPv6 */
};
sin6_family siempre contiene el valor AF_INET6; sin6_port es el puerto
del protocolo (vease sin_port en ip(7)); sin6_flowinfo es el
identificador de flujo IPv6; sin6_addr es la direccion IPv6 de 128
bits. sin6_scope_id es un identificador que depende del ambito de la
direccion. Esto es nuevo en Linux 2.4. Linux solo lo soporta para
direcciones del nivel de enlace, en cuyo caso sin6_scope_id contiene el
indice de la interfaz (vea netdevice(7))
IPv6 soporta varios tipos de direccion: unidestino para referirse a un
host individual, multidestino para referirse a un grupo de hosts,
"cualquier destino" para referirse al miembro mas cercano de un grupo
de hosts (no implementado en Linux), IPv4-sobre-IPv6 para refererise a
un host IPv4, y otros tipos de direccion reservados.
La notacion para direcciones IPv6 consiste en un grupo de 16 numeros
hexadecimales de dos digitos, separados por ':'. '::' representa una
cadena de 0 bits. Direcciones especiales son ::1 para loopback y
::FFFF:<direccion 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 especificas del protocolo
que pueden ser activadas con setsockopt(2) y leidas 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_UNICAST_HOPS
Establece el limite 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_MULTICAST_HOPS
Establece el limite 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. Solo se permite para conectores SOCK_DGRAM
y SOCK_RAW. El argumento es un puntero a un indice de interfaz
(vea netdevice(7)) representado como un numero entero.
IPV6_ADDRFORM
Convierte un conector AF_INET6 en un conector de una familia de
direcciones diferente. Actualmente, solamente se soporta
AF_INET. Solo esta permitido para conectores IPv6 que esten
conectados y enlazados a una direccion v4-mapeada-a-v6. El
argumento es un puntero a un entero que contiene el valor
AF_INET. Esto es util para pasar conectores v4-mapeados como
descriptores de fichero a los programas que no saben comunicarse
con la API IPv6.
IPV6_PKTINFO
Activa la entrega del mensaje de control IPV6_PKTINFO para los
datagramas de entrada. Solo es valida para conectores SOCK_DGRAM
y SOCK_RAW. El argumento es un puntero a un valor booleano dado
como un numero entero.
IPV6_RTHDR, IPV6_AUTHHDR, IPV6_DSTOPS, IPV6_HOPOPTS, IPV6_FLOWINFO,
IPV6_HOPLIMIT
Activa la entrega de mensajes de control para los datagramas de
entrada que contienen cabeceras de extension procedentes del
paquete recibido. IPV6_RTHDR entrega la cabecera de
enrutamiento, IPV6_AUTHHDR entrega la cabecera de autenticacion,
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 opcion de
conector. Todas estas opciones de cabecera tambien se pueden
activar para los paquetes de salida poniendo el mensaje de
control apropiado en el buffer de control de sendmsg(2). Esto
es valido solo para conectores SOCK_DGRAM y SOCK_RAW. El
argumento es un puntero a un valor booleano.
IPV6_MULTICAST_LOOP
Controla si el conector ve o no los paquetes multidestino que se
ha enviado a si mismo. El argumento es un puntero a un
booleano.
IPV6_ADD_MEMBERSHIP, IPV6_DROP_MEMBERSHIP
Controla la pertenencia en grupos multidestino. El argumento es
un puntero a una estructura struct ipv6_mreq.
IPV6_MTU
Establece la MTU a usar para el conector. La MTU esta 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 mas detalles.
IPV6_RECVERR
Controla la recepcion de opciones de error asincronas. Vea
IP_RECVERR en ip(7) para mas detalles. El argumento es un
puntero a un booleano.
IPV6_ROUTER_ALERT
Pasa al conector todos los paquetes reenviados (forwarded) que
contienen una opcion de alerta del enrutador. Solo se permite
para conectores de datagramas y para el root. El argumento es un
puntero a un booleano.
VERSIONES
La anterior implementacion de la API IPv6 libinet6 basada en libc5 no
se descrbie aqui y puede variar en algunos detalles.
Linux 2.4 rompe la compatibilidad binaria para sockaddr_in6 en hosts de
64bit al cambiar la alineacion de in6_addr y al anadir un campo
sin6_scope_id adicional. Las interfaces del nucleo 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 version 2.4 de Linux. El nucleo
lo pasa/lee transparentemente cuando la longitud de la direccion pasada
lo contiene. Algunos programas que pasan un buffer de direccion mayor y
comprueban despues la longitud de la direccion de salida pueden fallar.
OBSERVACIONES PARA LA MIGRACI'ON
La estructura sockaddr_in6 es mayor que la generica sockaddr. Los
programas que asumen que todos los tipos de direccion se pueden
almacenar de manera segura en una struct sockaddr necesitan cambiarse
para usar en su lugar struct sockaddr_storage.
FALLOS
Actualmente, la API IPv6 extendida, tal y como se describe en RFC2292,
solo esta parcialmente implementada; aunque el nucleo 2.2 soporta casi
por completo las opciones de recepcion, no existen macros en la glibc
2.1 para generar opciones IPv6.
No hay soporte IPSec para cabeceras EH y AH.
La gestion de las etiquetas de flujos no esta completa y no se
documenta aqui.
Esta pagina de manual no esta completa.
V'EASE TAMBI'EN
ip(7), cmsg(3)
RFC2553: IPv6 BASIC API. Linux intenta amoldarse a esto.
RFC2460: especificacion de IPv6.
Pagina de Manual de Linux 29-06-1999 IPV6(7)