.\" -*- coding: UTF-8 -*- .\" SPDX-License-Identifier: Linux-man-pages-1-para .\" .\" This man page is Copyright (C) 2000 Andi Kleen . .\" .\" $Id: ipv6.7,v 1.3 2000/12/20 18:10:31 ak Exp $ .\" .\" The following socket options are undocumented .\" All of the following are from: .\" commit 333fad5364d6b457c8d837f7d05802d2aaf8a961 .\" Author: YOSHIFUJI Hideaki .\" Support several new sockopt / ancillary data in Advanced API (RFC3542). .\" IPV6_2292PKTINFO (2.6.14) .\" Formerly IPV6_PKTINFO .\" IPV6_2292HOPOPTS (2.6.14) .\" Formerly IPV6_HOPOPTS, which is documented .\" IPV6_2292DSTOPTS (2.6.14) .\" Formerly IPV6_DSTOPTS, which is documented .\" IPV6_2292RTHDR (2.6.14) .\" Formerly IPV6_RTHDR, which is documented .\" IPV6_2292PKTOPTIONS (2.6.14) .\" Formerly IPV6_PKTOPTIONS .\" IPV6_2292HOPLIMIT (2.6.14) .\" Formerly IPV6_HOPLIMIT, which is documented .\" .\" IPV6_RECVHOPLIMIT (2.6.14) .\" IPV6_RECVHOPOPTS (2.6.14) .\" IPV6_RTHDRDSTOPTS (2.6.14) .\" IPV6_RECVRTHDR (2.6.14) .\" IPV6_RECVDSTOPTS (2.6.14) .\" .\" IPV6_RECVPATHMTU (Linux 2.6.35, flag value added in Linux 2.6.14) .\" commit 793b14731686595a741d9f47726ad8b9a235385a .\" Author: Brian Haley .\" IPV6_PATHMTU (Linux 2.6.35, flag value added in Linux 2.6.14) .\" commit 793b14731686595a741d9f47726ad8b9a235385a .\" Author: Brian Haley .\" IPV6_DONTFRAG (Linux 2.6.35, flag value added in Linux 2.6.14) .\" commit 793b14731686595a741d9f47726ad8b9a235385a .\" Author: Brian Haley .\" commit 4b340ae20d0e2366792abe70f46629e576adaf5e .\" Author: Brian Haley .\" .\" IPV6_RECVTCLASS (Linux 2.6.14) .\" commit 41a1f8ea4fbfcdc4232f023732584aae2220de31 .\" Author: YOSHIFUJI Hideaki .\" Based on patch from David L Stevens .\" .\" IPV6_CHECKSUM (Linux 2.2) .\" IPV6_NEXTHOP (Linux 2.2) .\" IPV6_JOIN_ANYCAST (Linux 2.4.21 / Linux 2.6) .\" IPV6_LEAVE_ANYCAST (Linux 2.4.21 / Linux 2.6) .\" IPV6_FLOWLABEL_MGR (Linux 2.2.7 / Linux 2.4) .\" IPV6_FLOWINFO_SEND (Linux 2.2.7 / Linux 2.4) .\" IPV6_IPSEC_POLICY (Linux 2.6) .\" IPV6_XFRM_POLICY (Linux 2.6) .\" IPV6_TCLASS (Linux 2.6) .\" .\" IPV6_ADDR_PREFERENCES (Linux 2.6.26) .\" commit 7cbca67c073263c179f605bdbbdc565ab29d801d .\" Author: YOSHIFUJI Hideaki .\" IPV6_MINHOPCOUNT (Linux 2.6.35) .\" commit e802af9cabb011f09b9c19a82faef3dd315f27eb .\" Author: Stephen Hemminger .\" IPV6_ORIGDSTADDR (Linux 2.6.37) .\" Actually a CMSG rather than a sockopt? .\" In header file, we have IPV6_RECVORIGDSTADDR == IPV6_ORIGDSTADDR .\" commit 6c46862280c5f55eda7750391bc65cd7e08c7535 .\" Author: Balazs Scheidler .\" IPV6_RECVORIGDSTADDR (Linux 2.6.37) .\" commit 6c46862280c5f55eda7750391bc65cd7e08c7535 .\" Author: Balazs Scheidler .\" Support for IPV6_RECVORIGDSTADDR sockopt for UDP sockets .\" were contributed by Harry Mason. .\" IPV6_TRANSPARENT (Linux 2.6.37) .\" commit 6c46862280c5f55eda7750391bc65cd7e08c7535 .\" Author: Balazs Scheidler .\" IPV6_UNICAST_IF (Linux 3.4) .\" commit c4062dfc425e94290ac427a98d6b4721dd2bc91f .\" Author: Erich E. Hoover .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH ipv6 7 "30 ​​Julio 2023" "Páginas de manual de Linux 6.05.01" .SH NOMBRE ipv6 \- Implementación Linux del protocolo IPv6 .SH SINOPSIS .nf \fB#include \fP \fB#include \fP .PP \fItcp6_socket\fP\fB = socket(AF_INET6, SOCK_STREAM, 0);\fP \fIraw6_socket\fP\fB = socket(AF_INET6, SOCK_RAW, \fP\fIprotocolo\fP\fB);\fP \fIudp6_socket\fP\fB = socket(AF_INET6, SOCK_DGRAM, \fP\fIprotocolo\fP\fB);\fP .fi .SH 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 \fBsocket\fP(7). .PP La API IPv6 pretende ser sobre todo compatible con la API IPv4 (consulte \fBip\fP(7)). En esta página de manual sólo se describen las diferencias. .PP Para enlazar un conector \fBAF_INET6\fP a cualquier proceso debe copiarse la dirección local de la variable \fIin6addr_any\fP cuyo tipo es \fIin6_addr\fP. En inicializaciones estáticas puede utilizarse también \fBIN6ADDR_ANY_INIT\fP, la cual se expande a una expresión constante. Ambas están en el orden de bytes de la red. .PP La dirección de loopback IPv6 (::1) está disponible en la variable global \fIin6addr_loopback\fP. Se debe utilizar \fBIN6ADDR_LOOPBACK_INIT\fP para la inicialización. .PP Las conexiones IPv4 pueden ser manejadas con la API v6 usando el tipo de dirección v4\-mapeada\-a\-v6; así 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. .PP IPv4 y IPv6 comparten el espacio de puertos local. Cuando recibe una petición de conexión IPv4 o un paquete para un conector IPv6, la dirección de origen se convierte a v6. .SS "Formato de las direcciones" .in +4n .EX 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 */ }; .EE .in .PP \fBsin6_family\fP siempre contiene el valor \fBAF_INET6\fP; \fBsin6_port\fP es el puerto del protocolo (véase \fBsin_port\fP en \fBip\fP(7)); \fBsin6_flowinfo\fP es el identificador de flujo IPv6; \fBsin6_addr\fP es la dirección IPv6 de 128 bits. \fBsin6_scope_id\fP es un identificador que depende del ámbito de la dirección. Esto es nuevo en Linux 2.4. Linux sólo tiene soporte para direcciones del nivel de enlace, en cuyo caso \fIsin6_scope_id\fP contiene el índice de la interfaz (vea \fBnetdevice\fP(7)) .PP 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. .PP La notación para direcciones IPv6 consiste en un grupo de 8 números hexadecimales de 4 dígitos, separados por \[aq]:\[aq]. \&"::" representa una cadena de 0 bits. Direcciones especiales son ::1 para loopback y ::FFFF: para IPv4\-mapeada\-a\-IPv6. .PP El espacio de puertos de IPv6 es compartido con IPv4. .SS "Opciones de los conectores" IPv6 soporta algunas opciones de conectores específicas del protocolo que pueden ser activadas con \fBsetsockopt\fP(2) y leídas con \fBgetsockopt\fP(2). El nivel de opciones de conectores para IPv6 es \fBIPPROTO_IPV6\fP. Una bandera entera booleana es cero cuando es falsa, en otro caso es verdadera. .TP \fBIPV6_ADDRFORM\fP Convierte un conector \fBAF_INET6\fP en un conector de una familia de direcciones diferente. Actualmente, solamente se soporta \fBAF_INET\fP. 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 \fBAF_INET\fP. Esto es útil para pasar conectores v4\-mapeados como descriptores de archivo a los programas que no saben comunicarse con la API IPv6. .TP \fBIPV6_ADD_MEMBERSHIP, IPV6_DROP_MEMBERSHIP\fP Controla la pertenencia en grupos multicast. El argumento es un puntero a una estructura \fBstruct ipv6_mreq\fP. .TP \fBIPV6_MTU\fP \fBgetsockopt\fP(): obtiene la actual ruta MTU del conector. Sólo es válido una vez se ha conectado. Es un número entero. .IP \fBsetsockopt\fP(): 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. .TP \fBIPV6_MTU_DISCOVER\fP Controla el descubrimiento de la MTU de la ruta en el conector. Vea \fBIP_MTU_DISCOVER\fP en \fBip\fP(7) para más detalles. .TP \fBIPV6_MULTICAST_HOPS\fP 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. .TP \fBIPV6_MULTICAST_IF\fP Establece el dispositivo para los paquetes multidestino de salida del conector. Sólo se permite para conectores \fBSOCK_DGRAM\fP y \fBSOCK_RAW\fP. El argumento es un puntero a un índice de interfaz (vea \fBnetdevice\fP(7)) representado como un número entero. .TP \fBIPV6_MULTICAST_LOOP\fP 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. .TP \fBIPV6_RECVPKTINFO\fP (desde Linux 2.6.14) Activa la entrega del mensaje de control \fBIPV6_PKTINFO\fP para los datagramas de entrada. En cumplimiento del RFC 3542, estos mensajes contienen una \fIstruct in6_pktinfo\fP. Sólo es válida para conectores \fBSOCK_DGRAM\fP y \fBSOCK_RAW\fP. El argumento es un puntero a un valor booleano dado como un número entero. .TP \fB\%IPV6_RTHDR, \%IPV6_AUTHHDR, \%IPV6_DSTOPTS, \%IPV6_HOPOPTS, \%IPV6_FLOWINFO, \%IPV6_HOPLIMIT\fP Activa la entrega de mensajes de control para los datagramas de entrada que contienen cabeceras de extensión procedentes del paquete recibido. \fBIPV6_RTHDR\fP entrega la cabecera de enrutamiento, \fBIPV6_AUTHHDR\fP entrega la cabecera de autenticación, \fBIPV6_DSTOPTS\fP entrega las opciones de destino, \fBIPV6_HOPOPTS\fP entrega las opciones de salto, \fBIPV6_FLOWINFO\fP entrega un entero que contiene el identificador del flujo, \fBIPV6_HOPLIMIT\fP 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 \fBsendmsg\fP(2). Esto es válido sólo para conectores \fBSOCK_DGRAM\fP y \fBSOCK_RAW\fP. El argumento es un puntero a un valor booleano. .TP \fBIPV6_RECVERR\fP Controla la recepción de opciones de error asíncronas. Vea \fBIP_RECVERR\fP en \fBip\fP(7) para más detalles. El argumento es un puntero a un booleano. .TP \fBIPV6_ROUTER_ALERT\fP 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. Sólo se permite en conectores \fBSOCK_RAW\fP. Estos paquetes no son reenviados por el núcleo sino que correponde al usuario la responsabilidad de enviarlos. El argumento es un puntero a un número entero. Un número positivo indicará una alerta de router para interceptar el paquete y se entregará al conector. Un número negativo desactivará la entrega al conector. .TP \fBIPV6_UNICAST_HOPS\fP 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. .TP \fBIPV6_V6ONLY\fP (desde Linux 2.4.21 y 2.6) .\" See RFC 3493 Si esta opción está como 'true' (distinto de cero), el conector sólo podrá enviar y recibir paquetes Ipv6. En éste caso, puede conectarse al mismo puerto una aplicación Ipv4 y una Ipv6 al mismo tiempo. .IP Si esta opción está como 'false' (cero), el conector podrá usarse para enviar paquetes entre direcciones Ipv6 y/o direcciones IPv6 mapeadas como IPv4. .IP El argumento es un puntero a un valor booleano como un entero. .IP .\" FLOWLABEL_MGR, FLOWINFO_SEND El valor por defecto de esta opción viene definida en el archivo \fI/proc/sys/net//ipv6/bindv6only\fP siendo '0' por defecto. .SH ERRORES .TP \fBENODEV\fP El intentó conectarse (con \fBbind\fP(2)) a una dirección local IPv6, pero \fIsin6_scope_id\fP en la estructura \fIsockaddr_in6\fP proporcionada no es un índice de interfaz válido. .SH VERSIONES Linux 2.4 rompe la compatibilidad binaria para \fIsockaddr_in6\fP en hosts de 64bit al cambiar la alíneación de \fIin6_addr\fP y al añadir un campo \fIsin6_scope_id\fP adicional. Las interfaces del núcleo siguen siendo compatibles, pero un programa que incluya \fIsockaddr_in6\fP o \fIin6_addr\fP en otras estructuras puede no serlo. Esto no es un problema para hosts de 32bits como i386. .PP El campo \fIsin6_flowinfo\fP 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. .SH NOTAS La estructura \fIsockaddr_in6\fP es mayor que la genérica \fIsockaddr\fP. Los programas que asumen que todos los tipos de dirección se pueden almacenar de manera segura en una \fIstruct sockaddr\fP necesitan cambiarse para usar en su lugar \fIstruct sockaddr_storage\fP. .PP \fBSOL_IP\fP, \fBSOL_IPV6\fP, \fBSOL_ICMPV6\fP y otras opciones de conector de la forma \fBSOL_*\fP son variantes no portables de \fBIPPROTO_*\fP. Consulte \fBip\fP(7). .SH 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. .PP No hay soporte IPSec para cabeceras EH y AH. .PP La gestión de las etiquetas de flujos no está completa y no se documenta aquí. .PP Esta página de manual no está completa. .SH "VÉASE TAMBIÉN" \fBcmsg\fP(3), \fBip\fP(7) .PP RFC\ 2553: IPv6 BASIC API. Linux intenta amoldarse a esto. RFC\ 2460: especificación de IPv6. .PP .SH TRADUCCIÓN La traducción al español de esta página del manual fue creada por Juan Piernas y Marcos Fouces . .PP Esta traducción es documentación libre; lea la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. .PP Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a .MT debian-l10n-spanish@lists.debian.org .ME .