]> git.ipfire.org Git - people/ms/dnsmasq.git/commitdiff
Documenation updates for --bridge-interface and "off-link".
authorNeil Jerram <Neil.Jerram@metaswitch.com>
Wed, 10 Jun 2015 21:23:20 +0000 (22:23 +0100)
committerSimon Kelley <simon@thekelleys.org.uk>
Wed, 10 Jun 2015 21:23:20 +0000 (22:23 +0100)
CHANGELOG
man/dnsmasq.8
man/es/dnsmasq.8
man/fr/dnsmasq.8
src/dhcp.c
src/dhcp6.c
src/radv.c

index a5bd4dc02701b330a2efd3f13d954acd2348f818..7d8f73ffa61cab987d810a2a85bd952c9c202b19 100644 (file)
--- a/CHANGELOG
+++ b/CHANGELOG
@@ -128,6 +128,12 @@ version 2.73
 
            Add AddDhcpLease and DeleteDhcpLease DBus methods. Thanks
            to Nicolas Cavallari for the patch.
+
+           Allow configuration of router advertisements without the 
+           "on-link" bit set. Thanks to Neil Jerram for the patch.
+
+           Extend --bridge-interface to DHCPv6 and router 
+           advertisements. Thanks to Neil Jerram for the patch.
        
        
 version 2.72
index f811dc326e9f3c586673b75da004a161d60489b3..ffa0c7b1f436cbd242573260f1b707007c4aecb2 100644 (file)
@@ -833,7 +833,7 @@ and
 for details.)
 
 For IPv6, the mode may be some combination of
-.B ra-only, slaac, ra-names, ra-stateless, ra-advrouter.
+.B ra-only, slaac, ra-names, ra-stateless, ra-advrouter, off-link.
 
 .B ra-only
 tells dnsmasq to offer Router Advertisement only on this subnet,
@@ -873,6 +873,9 @@ enables a mode where router address(es) rather than prefix(es) are included in t
 This is described in RFC-3775 section 7.2 and is used in mobile IPv6. In this mode the interval option
 is also included, as described in RFC-3775 section 7.3.
 
+.B off-link
+tells dnsmasq to advertise the prefix without the on-link (aka L) bit set.
+
 .TP
 .B \-G, --dhcp-host=[<hwaddr>][,id:<client_id>|*][,set:<tag>][,<ipaddr>][,<hostname>][,<lease_time>][,ignore]
 Specify per host parameters for the DHCP server. This allows a machine
@@ -1597,11 +1600,13 @@ option also forces the leasechange script to be called on changes
 to the client-id and lease length and expiry time.
 .TP
 .B --bridge-interface=<interface>,<alias>[,<alias>]
-Treat DHCP request packets arriving at any of the <alias> interfaces
-as if they had arrived at <interface>. This option is necessary when
-using "old style" bridging on BSD platforms, since
-packets arrive at tap interfaces which don't have an IP address.
-A trailing '*' wildcard can be used in each <alias>.
+Treat DHCP (v4 and v6) request and IPv6 Router Solicit packets
+arriving at any of the <alias> interfaces as if they had arrived at
+<interface>.  This option allows dnsmasq to provide DHCP and RA
+service over unaddressed and unbridged Ethernet interfaces, e.g. on an
+OpenStack compute host where each such interface is a TAP interface to
+a VM, or as in "old style bridging" on BSD platforms.  A trailing '*'
+wildcard can be used in each <alias>.
 .TP
 .B \-s, --domain=<domain>[,<address range>[,local]]
 Specifies DNS domains for the DHCP server. Domains may be be given 
index 65e4b7277a6beead64a7e3748b54440a8753d6b5..81c745a48b6e66b9c1cf186277d1ed416ff4228b 100644 (file)
@@ -1062,10 +1062,14 @@ esta opci
 cuando hay cambios hechos a el client-id y tiempos de arriendo y vencimiento.
 .TP
 .B --bridge-interface=<nombre de interface>,<alias>[,<alias>]
-Tratar paquetes de pedidos DHCP que llegan a cualquiera de las interfaces <alias>
-como si hubieran llegado a la interface <nombre de interface>. Esta opción
-es necesaria al usar bridging estilo viejo en plataformas BSD, dado a que
-los paquetes llegan a interfaces tap que no tienen una dirección IP.
+Tratar paquetes de pedidos DHCP (v4 y v6) y de IPv6 Router Solicit que
+llegan a cualquiera de las interfaces <alias> como si hubieran llegado
+a la interface <nombre de interface>.  Esta opción permite que dnsmasq
+puede proporcionar los servicios DHCP y RA a través de interfaces
+ethernet sin dirección y sin puente; por ejemplo en un nodo de cálculo
+de OpenStack, donde cada una de esas interfaces es una interfaz TAP
+para una máquina virtual, o al usar bridging estilo viejo en
+plataformas BSD.
 .TP
 .B \-s, --domain=<dominio>[,<rango de IPs>]
 Especifica los dominios DNS para el servidor DHCP. Dominios pueden ser
index e0d1e9ad92e5c694718fdf62c4e958ff5ef012bf..b4cc16dd37863a0f131b33ba411930952d34d68b 100644 (file)
@@ -852,7 +852,7 @@ et
 pour plus de détails).
 
 Pour IPv6, le mode peut-être une combinaison des valeurs
-.B ra-only, slaac, ra-names, ra-stateless.
+.B ra-only, slaac, ra-names, ra-stateless, off-link.
 
 .B ra-only
 indique à dnsmasq de n'effectuer que des annonces de routeur (Router
@@ -888,6 +888,9 @@ peut-être combiné avec
 et
 .B slaac.
 
+.B off-link
+indique à dnsmasq d'annoncer le préfixe sans le bit L (sur lien).
+
 .TP
 .B \-G, --dhcp-host=[<adresse matérielle>][,id:<identifiant client>|*][,set:<label>][,<adresse IP>][,<nom d'hôte>][,<durée de bail>][,ignore]
 Spécifie les paramètres DHCP relatifs à un hôte. Cela permet à une machine
@@ -1655,11 +1658,14 @@ changement d'état de bail à chaque changement de l'identifiant de client, de
 longueur de bail ou de date d'expiration.
 .TP
 .B --bridge-interface=<interface>,<alias>[,<alias>]
-Traiter les requêtes DHCP arrivant sur n'importe laquelle des interfaces <alias>
-comme si elles arrivaient de l'interface <interface>. Cette option est
-nécessaire lors de l'utilisation de pont ethernet "ancien mode" sur plate-forme
-BSD, puisque dans ce cas les paquets arrivent sur des interfaces "tap" n'ont
-pas d'adresse IP.  Chaque <alias> peut finir avec un simple '*' joker.
+Traiter les requêtes DHCP (v4 et v6) et IPv6 Router Solicit arrivant
+sur n'importe laquelle des interfaces <alias> comme si elles
+arrivaient de l'interface <interface>. Cette option permet à dnsmasq
+de fournir les service DHCP et RA sur les interfaces ethernet non
+adressés et non pontés; par exemple sur un hôte de calcul d'OpenStack
+où chaque telle interface est une interface TAP à une machine
+virtuelle, ou lors de l'utilisation de pont ethernet "ancien mode" sur
+plate-forme BSD.  Chaque <alias> peut finir avec un simple '*' joker.
 .TP
 .B \-s, --domain=<domaine>[,<gamme d'adresses>[,local]]
 Spécifie le domaine du serveur DHCP. Le domaine peut être donné de manière
index eb1ea810b573ca4795aeb5c45402d6419a0d2ab9..e6fceb13a3e1da9f1d104506f0279b0bfc3e3b27 100644 (file)
@@ -225,10 +225,11 @@ void dhcp_packet(time_t now, int pxe_fd)
   strncpy(arp_req.arp_dev, ifr.ifr_name, 16);
 #endif 
 
-   /* One form of bridging on BSD has the property that packets
-      can be recieved on bridge interfaces which do not have an IP address.
-      We allow these to be treated as aliases of another interface which does have
-      an IP address with --dhcp-bridge=interface,alias,alias */
+  /* If the interface on which the DHCP request was received is an
+     alias of some other interface (as specified by the
+     --bridge-interface option), change ifr.ifr_name so that we look
+     for DHCP contexts associated with the aliased interface instead
+     of with the aliasing one. */
   for (bridge = daemon->bridges; bridge; bridge = bridge->next)
     {
       for (alias = bridge->alias; alias; alias = alias->next)
index 4c60c6e86c0c3421e076f678680539c7ae335840..8286ff4002171de8cbc9b92225e44249e9a4c037 100644 (file)
@@ -165,7 +165,7 @@ void dhcp6_packet(time_t now)
 
       /* If the interface on which the DHCPv6 request was received is
          an alias of some other interface (as specified by the
-         --bridge-interfaces option), change parm.ind so that we look
+         --bridge-interface option), change parm.ind so that we look
          for DHCPv6 contexts associated with the aliased interface
          instead of with the aliasing one. */
       for (bridge = daemon->bridges; bridge; bridge = bridge->next)
index 300c31c83c787542e450e0b4326951efbf6355e1..39f1e92ae75fc84660a92e296c1cd3ab83654eb1 100644 (file)
@@ -205,8 +205,8 @@ void icmp6_packet(time_t now)
        my_syslog(MS_DHCP | LOG_INFO, "RTR-SOLICIT(%s) %s", interface, mac);
 
       /* If the incoming interface is an alias of some other one (as
-         specified by the --bridge-interfaces option), send an RA
-         using the context of the aliased interface. */
+         specified by the --bridge-interface option), send an RA using
+         the context of the aliased interface. */
       for (bridge = daemon->bridges; bridge; bridge = bridge->next)
         {
           int bridge_index = if_nametoindex(bridge->iface);
@@ -827,7 +827,7 @@ time_t periodic_ra(time_t now)
                       }
 
                     /* The source interface can only appear in at most
-                       one --bridge-interfaces. */
+                       one --bridge-interface. */
                     break;
                   }
             }