ipv6(7) Miscellaneous Information Manual ipv6(7) NOMBRE ipv6 - Implementacion Linux del protocolo IPv6 SINOPSIS #include #include tcp6_socket = socket(AF_INET6, SOCK_STREAM, 0); raw6_socket = socket(AF_INET6, SOCK_RAW, protocolo); udp6_socket = socket(AF_INET6, SOCK_DGRAM, protocolo); DESCRIPCION 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 IPv4 (consulte ip(7)). 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 tener soporte para este tipo de API para gestionar ambos protocolos. Esto se gestiona de forma transparente por las funciones de direcciones de libc. IPv4 y IPv6 comparten el espacio de puertos local. Cuando recibe una peticion de conexion IPv4 o un paquete para un conector IPv6, la direccion de origen se convierte a v6. Formato de las direcciones struct sockaddr_in6 { sa_family_t sin6_family; /* AF_INET6 */ in_port_t sin6_port; /* numero de puerto */ uint32_t sin6_flowinfo; /* Informacion de flujo IPv6 */ struct in6_addr sin6_addr; /* direccion IPv6 */ uint32_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 tiene soporte 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 8 numeros hexadecimales de 4 digitos, separados por ':'. "::" representa una cadena de 0 bits. Direcciones especiales son ::1 para loopback y ::FFFF: para IPv4-mapeada-a-IPv6. El espacio de puertos de IPv6 es compartido con IPv4. Opciones de los 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_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 archivo a los programas que no saben comunicarse con la API IPv6. IPV6_ADD_MEMBERSHIP, IPV6_DROP_MEMBERSHIP Controla la pertenencia en grupos multicast. El argumento es un puntero a una estructura struct ipv6_mreq. IPV6_MTU getsockopt(): obtiene la actual ruta MTU del conector. Solo es valido una vez se ha conectado. Es un numero entero. setsockopt(): 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_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_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_RECVPKTINFO (desde Linux 2.6.14) Activa la entrega del mensaje de control IPV6_PKTINFO para los datagramas de entrada. En cumplimiento del RFC 3542, estos mensajes contienen una struct in6_pktinfo. 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_DSTOPTS, 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_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 paquetes reenviados y que contiene una alerta 'hop-by-hop' (que tiene que ser revisada por cada nodo por los que para el paquete) para ese conector. Solo se permite en conectores SOCK_RAW. Estos paquetes no son reenviados por el nucleo sino que correponde al usuario la responsabilidad de enviarlos. El argumento es un puntero a un numero entero. Un numero positivo indicara una alerta de router para interceptar el paquete y se entregara al conector. Un numero negativo desactivara la entrega al conector. 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_V6ONLY (desde Linux 2.4.21 y 2.6) Si esta opcion esta como 'true' (distinto de cero), el conector solo podra enviar y recibir paquetes Ipv6. En este caso, puede conectarse al mismo puerto una aplicacion Ipv4 y una Ipv6 al mismo tiempo. Si esta opcion esta como 'false' (cero), el conector podra usarse para enviar paquetes entre direcciones Ipv6 y/o direcciones IPv6 mapeadas como IPv4. El argumento es un puntero a un valor booleano como un entero. El valor por defecto de esta opcion viene definida en el archivo /proc/sys/net//ipv6/bindv6only siendo '0' por defecto. ERRORES ENODEV El intento conectarse (con bind(2)) a una direccion local IPv6, pero sin6_scope_id en la estructura sockaddr_in6 proporcionada no es un indice de interfaz valido. VERSIONES 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. NOTAS 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. SOL_IP, SOL_IPV6, SOL_ICMPV6 y otras opciones de conector de la forma SOL_* son variantes no portables de IPPROTO_*. Consulte ip(7). ERRORES Actualmente, la API IPv6 extendida, tal y como se describe en RFC 2292, 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. VEASE TAMBIEN cmsg(3), ip(7) RFC 2553: IPv6 BASIC API. Linux intenta amoldarse a esto. RFC 2460: especificacion de IPv6. TRADUCCION La traduccion al espanol de esta pagina del manual fue creada por Juan Piernas y Marcos Fouces Esta traduccion es documentacion libre; lea la GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. Si encuentra algun error en la traduccion de esta pagina del manual, envie un correo electronico a . Paginas de manual de Linux 6.06 31 Octubre 2023 ipv6(7)